Enviar a primeira mensagem com a Evolution API

Para enviar a primeira mensagem precisa de três coisas: uma instância ligada, a chave da API e um pedido HTTP com o destinatário e o texto. O pedido faz-se com curl ou com um cliente de APIs (o Insomnia e o Postman servem). A rota e os campos exactos estão na documentação oficial da Evolution API, que é a única fonte fiável: mudam de versão para versão e copiá-los de um vídeo antigo é a maneira mais rápida de receber um erro.

O que o pedido leva

Parte O que é
O endereço da API O domínio ou IP do seu servidor, de preferência com HTTPS. Veja proteger a Evolution API.
A instância O nome que deu à instância ligada. O pedido tem de dizer por qual delas envia.
A chave O valor de AUTHENTICATION_API_KEY, num cabeçalho cujo nome vem na documentação. Sem ela, a API recusa.
O destinatário O número em formato internacional completo, com o indicativo do país. A documentação diz como o campo o quer escrito.
O texto A mensagem em si, num corpo em JSON. A documentação mostra os campos.

Passo a passo

1 Confirme que a instância está ligada. Se ainda não leu o QR, veja ligar uma instância com o QR.
2 Abra a documentação da versão que instalou e encontre o pedido de envio de texto simples.
3 Monte o pedido com o endereço, o nome da instância, a chave no cabeçalho e um corpo com o destinatário e o texto.
4 Envie-o a si próprio. Use o seu número, ou o de um colega que saiba do teste. Nunca comece por uma lista.
5 Leia a resposta. Uma resposta de sucesso traz um identificador da mensagem. No telemóvel, a mensagem aparece na conversa do destinatário.
Não faça o primeiro teste a desconhecidos. Um número ligado por Baileys que escreve de repente a muita gente que não o conhece é o padrão que leva a bloqueios. Teste em si, depois em quem pediu para ser contactado, e vá devagar.

Se a resposta for um erro

Resposta Causa provável
401 ou 403 A chave está errada, em falta ou no cabeçalho errado.
404 A rota não existe nessa versão ou o nome da instância está mal escrito.
400 O corpo está errado: um campo com o nome errado, um número mal formatado ou JSON inválido.
Não liga (recusada ou tempo esgotado) A porta não está acessível. Veja portas e firewall num VPS.
Sucesso, mas nada chega A instância já não está ligada, ou o destinatário não tem WhatsApp. Veja o estado da instância.
Guarde um pedido que funcione como modelo, com a chave a vir de uma variável e não escrita no ficheiro. Quando passar à automação, é esse mesmo pedido que o n8n ou o seu site vão repetir. Veja a Evolution API com o n8n.

Os pedidos em JSON assustam? Descreva-nos o que quer automatizar.

Abrir um pedido de suporte

VEJA TAMBÉM

Ligar uma instância com o código QR

A Evolution API com o n8n

O que é um webhook e como testá-lo com curl

PRODUTO RECOMENDADO

Alojamento de sites com cPanel

Domínio e SSL incluídos, cópias diárias e o painel que já conhece. desde 5.940,00 Kz/mês (plano de 3 anos, com cupão)

Ver planos
  • 0 Utilizadores acharam útil
Esta resposta foi útil?