Como receber mensagens no WhatsApp e processá-las

Sexta-feira, 13 de Dezembro de 2024

Cadastrando-se na plataforma da Connect Zap

Para enviar ou capturar mensagens do Whatsapp, antes é preciso se cadastrar na plataforma da Connect Zap. Caso não seja cadastrado, clique aqui.

Entre em https://painel.connectzap.com.br e através do botão verde, sincronize seu aplicativo.

Configurando a Captura de Mensagens via Webhook

Após logar na plataforma, clique na engrenagem e depois em Webhook.

É necessário criar um serviço e gravar o link neste campo acima.

Especificações para seu serviço:

Tipo: POST
Autenticação: Sem Autenticação

Body Enviado:

{
   "SessionName":"2OCSA1GRAZEBVRLVPCKA",
   "wook":"RECEIVE_MESSAGE",
   "status":"RECEIVED",
   "type":"text",
   "fromMe":false,
   "id":"F2F6177B4779B668F7A747C574F39136",
   "name":"Empresa XYZ",
   "from":"55XXXXX27043",
   "to":"55XXXXX87295",
   "isGroup":false,
   "content":"Agradecemos a sua mensagem. Não estamos disponíveis no momento, mas responderemos assim que possível.",
   "datetime":"2024-12-13 03:52:17"
}

Atributos enviados no Body

SessionName = Trata-se do seu token, é enviado para você entender de qual conta se trata.

wook = Significa o tipo de evento que ocorreu na conta do WhatsApp.
RECEIVE_MESSAGE = Uma mensagem foi recebida.
SEND_MESSAGE = Uma mensagem foi enviada.

status = Estado final da mensagem.
RECEIVED = A mensagem foi entregue.

type = É o tipo de mensagem, se é uma mensagem de texto, audio, imagem, video.

fromMe = Caso a mensagem tenha sido enviada pela própria conta (Muito usado em grupos) o retorno é true (verdadeiro).

id = Identificador da mensagem. Nunca o id da mensagem será repetido.

name = Nome cadastrado para a contra que lhe enviou a mensagem.

from = Número que enviou a mensagem para a sua conta. Trata-se do remetente da mensagem.

to = Número que recebeu a mensagem. Trata-se do destinatário da mensagem.

isGroup = Caso sua conta WhatsApp tenha capturado esta mensagem em um grupo, esta informação virá como true (Verdadeiro), caso seja uma mensagem direta de um número, esta informação virá como false (Falso).

content = Trata-se do conteúdo da mensagem, seja ele texto ou base64 (arquivos, videos imagens). Neste caso, você precisará rodar uma função para converter o base64 para o arquivo desejado.

datetime = Data e hora no momento em que sua conta capturou a mensagem.

Para testar as capturas de mensagens, sugerimos gerar link de teste no site https://webhook.site/ e copiar a url no nosso painel.

Após isso você verá neste site, toda a interação em sua conta.

Caso precise de algum auxílio, basta chamar no whatsapp no rodapé da página.

Esperamos ter ajudado e desejamos boa sorte no desenvolvimento.