API do WaSap

Tempo de leitura estimado: 3 minutos 29 visualizações

A API do WaSap permite integrar o envio de mensagens WhatsApp diretamente em sistemas externos, como CRM, ERP, e-commerces, automações e aplicações próprias.

Com autenticação via Token e endpoints REST bem definidos, você pode automatizar mensagens de texto e mídia com segurança e escalabilidade.

📘 1 – Documentação

🌎 Visão Geral

A API permite:

• 📩 Envio de mensagens de texto
• 🖼️ Envio de mídias (imagem, áudio, vídeo, documentos)
• 👤 Definição do atendente responsável
• 🏷️ Direcionamento para setor/fila
• 📲 Escolha da conexão WhatsApp

🔐 Autenticação

Todas as requisições devem incluir o header:

Authorization: Bearer seu_token_aqui

⚠️ Nunca compartilhe seu token publicamente.
Ele pode ser regenerado nas configurações da conta.

🚀 Envio de Mensagens

🔗 Endpoint

POST https://xxxxapi.wasap.com.br/api/messages/send

📌 Parâmetros Obrigatórios

Parâmetro	Tipo	Descrição
number	String	Número no formato internacional (ex: 5511999999999)
body	String	Conteúdo da mensagem
userId	Integer	ID do atendente
queueId	Integer	ID do setor/fila
whatsappId	Integer	ID da conexão WhatsApp

📎 Parâmetros Opcionais

Parâmetro	Tipo	Descrição
medias	File	Arquivo de mídia (imagem, áudio, vídeo, documento)

📤 Exemplo de Requisição (Texto)

{
  "number": "5511987654321",
  "body": "Olá! Esta é uma mensagem de teste.",
  "userId": 1,
  "queueId": 1,
  "whatsappId": 1
}

✅ Exemplo de Resposta (200 – Sucesso)

{
  "success": true,
  "message": "Mensagem enfileirada com sucesso",
  "messageId": 12345,
  "timestamp": "2025-10-30T14:30:00Z"
}

❌ Tratamento de Erros

Código	Significado
400	Parâmetros inválidos ou ausentes
401	Token ausente ou inválido
403	Token sem permissão
404	Recurso não encontrado
429	Limite de requisições excedido
500	Erro interno do servidor

⏱️ Rate Limiting

Para garantir estabilidade:

• 100 requisições por minuto (limite geral)
• 10 requisições por segundo (mesmo endpoint)

🧠 Boas Práticas

• ✔️ Valide dados antes do envio
• 🔄 Implemente retry com backoff exponencial
• 🔒 Utilize HTTPS sempre
• 🔑 Armazene o token em variável de ambiente
• 📊 Monitore o volume de requisições

🧪 2 – Testar API

A aba Testar API permite enviar mensagens diretamente pelo painel, utilizando automaticamente seu token de autenticação.

Ideal para:

• 🧪 Testes rápidos
• 🔍 Validação de parâmetros
• 📤 Teste de envio de mídia
• 💻 Gerar snippet de código

📝 Campos do Formulário

• 📞 Número de telefone (com DDI + DDD)
• 💬 Corpo da mensagem
• 👤 User ID
• 🏷️ Setor ID
• 📲 WhatsApp ID
• 📎 Mídia (opcional)

🎯 Tipos de Mídia Suportados

• 🖼️ Imagens: JPG, PNG, WEBP
• 🎵 Áudio: MP3, OGG, WAV
• 🎥 Vídeo: MP4, 3GP
• 📄 Documentos: PDF, DOC, DOCX, XLS, XLSX

Após preencher:

• 🚀 Clique em Enviar Mensagem
• 🧩 Ou gere um snippet automático para integrar no seu sistema

🔑 3 – Chave da API

A aba Chave da API permite visualizar e gerenciar seu token de autenticação.

🔐 Sua Chave de API (Token)

O token é utilizado para autenticar todas as requisições à API.

Exemplo de uso:

Authorization: Bearer seu_token_aqui

⚠️ Segurança

• ❌ Nunca compartilhe seu token
• 🛡️ Armazene em local seguro
• 🔄 Se suspeitar de comprometimento, regenere imediatamente

🔄 Regenerar Token

Ao clicar em Regenerar:

• O token anterior deixa de funcionar imediatamente
• Todas as aplicações integradas precisarão ser atualizadas
• Use apenas se necessário

🏁 Conclusão

A API WaSap foi projetada para ser:

• ⚡ Rápida
• 🔐 Segura
• 📦 Escalável
• 🤝 Fácil de integrar

Com ela, você pode automatizar totalmente o envio de mensagens e integrar o WhatsApp ao seu ecossistema digital.