Guia da API de Mensagens

API de Mensagens

Vá em Administração → API de Mensagens pra integrar o Dialogix com outro sistema (ERP, site, automação própria) que precise enviar mensagens ou consultar dados via API. Disponível conforme o plano contratado.

📷 [Captura de tela aqui] — tela de API de Mensagens, seção do token.

Gerando seu token

Um único token dá acesso a tudo: envio de mensagens e à API de Contatos/Tickets/Oportunidades. Clique em Gerar Token (ou Gerar Novo Token, se já existir um). O token aparece na tela — use os ícones de olho (mostrar/ocultar) e copiar.

📷 [Captura de tela aqui] — token gerado, com os botões de mostrar e copiar.

Atenção: gerar um token novo invalida o anterior imediatamente — qualquer integração usando o token antigo para de funcionar na hora. Atualize todos os lugares que usam esse token antes de gerar um novo.

Enviando uma mensagem de texto

• Endpoint: [endereço da sua API]/api/messages/send
• Método: POST
• Cabeçalhos: Authorization: Bearer [seu token] e Content-Type: application/json
• Corpo: { "number": "5511999998888", "body": "Sua mensagem" }

O número deve ter só dígitos: código do país + DDD + número, sem espaço, traço ou parênteses. Antes de usar, é preciso vincular esse token à conexão de WhatsApp que vai enviar (em Conexões → editar → campo de token).

A própria tela tem um formulário de teste de envio ao vivo — dá pra mandar uma mensagem de teste sem sair daqui, só preenchendo token, número e texto.

📷 [Captura de tela aqui] — formulário de teste de envio de mensagem de texto.

Enviando mídia

Mesmo endpoint, mas com Content-Type: multipart/form-data e dois campos no corpo: number e medias (o arquivo). Também tem formulário de teste próprio, com opção de anexar arquivo.

API de CRM (Contatos, Tickets, Oportunidades)

Usa o mesmo token, no mesmo formato de cabeçalho (Authorization: Bearer [token]). Limite de 300 requisições por minuto por empresa.

Principais endpoints disponíveis:

Um link na própria tela leva pra especificação técnica completa (formato OpenAPI 3.0), que pode ser importada direto em ferramentas como Postman ou Insomnia pra testar todos os campos sem precisar montar cada requisição na mão.

Erros vêm sempre no formato { "error": "mensagem" }, com os códigos padrão: 401 (token ausente ou inválido), 403 (seu plano não inclui API Externa), 404 (não encontrado), 429 (você passou do limite de requisições por minuto).