Webhooks do WhatsApp


Webhooks do WhatsApp


📘 Guia de Conhecimento — Recurso: Webhooks do WhatsApp no Chat-Bot

O recurso WhatsApp Webhooks do Chat-Bot é um módulo avançado que permite enviar automaticamente os dados de mensagens recebidas do WhatsApp para serviços externos, APIs, CRMs ou qualquer outro aplicativo compatível, utilizando tecnologia de webhooks.
Essa funcionalidade é especialmente útil para integrações em tempo real, automações corporativas e comunicação com servidores externos.
🔗⚙️🌐

Conectado de forma oficial à API da Meta Business, o Chat-Bot garante que a entrega dos dados seja precisa, confiável e configurada de acordo com as necessidades técnicas da sua operação.


🔔 Nota Importante

Antes de prosseguir, é essencial entender a distinção entre dois tipos de gerenciamento de webhooks dentro do ecossistema Chat-Bot:

📌 1. Webhooks configurados nesta seção:
Servem exclusivamente para encaminhar dados das mensagens do WhatsApp para endpoints externos, com foco em integrações e notificações.

📌 2. Webhooks internos do script Laravel do Chat-Bot:
São dedicados a operações internas do sistema, não devendo ser confundidos com o recurso descrito aqui.

❗ Certifique-se de distinguir corretamente esses dois recursos para evitar erros de configuração e falhas de integração.


🔧 Como Configurar os Webhooks do Chat-Bot — Passo a Passo

A seguir, você encontrará instruções detalhadas sobre todas as opções de configuração dos Webhooks do WhatsApp dentro do Chat-Bot.


1. Ativar o Reenvio de Webhooks

Este controle permite ligar ou desligar o envio automático dos dados das mensagens recebidas via WhatsApp.

🔘 Quando ativado (ligado):

  • O Chat-Bot enviará automaticamente os dados de cada mensagem recebida.

  • Caso a tentativa inicial falhe, o sistema realizará novas tentativas de reenvio, aumentando a confiabilidade da integração.

🔴 Quando desativado (desligado):

  • Nenhum dado será enviado ou reenviado para o endpoint configurado.

💡 Por que isso é importante?

A confiabilidade na entrega dos dados é fundamental para qualquer integração com serviços externos, especialmente quando envolve
→ notificações,
→ automações,
→ sistemas de ERP, CRM ou backend.


2. Selecionar o Método de Reenvio do Webhook

Neste campo você escolhe o método HTTP utilizado para enviar os dados ao endpoint configurado.

📥 Métodos disponíveis:

GET

  • Envia os dados como parâmetros de URL (query string).

  • Exemplo:
    https://example.com/webhook?message=Hello&sender=12345

  • Ideal para testes rápidos e integrações simples.

POST

  • Envia os dados no corpo da requisição (geralmente em JSON).

  • É o método recomendado para:
    ✔️ dados complexos
    ✔️ grandes volumes
    ✔️ integridade e segurança dos dados
    ✔️ APIs que esperam conteúdo estruturado

💡 Dica técnica:

Use POST quando estiver integrando com servidores profissionais, CRMs, ERPs ou plataformas que requerem dados completos.
Use GET apenas para testes ou endpoints simples.


3. Configurar URL do Endpoint do Webhook

Aqui você define o endereço que receberá os dados enviados pelo Chat-Bot.

🌐 Sobre o Endpoint:

  • Pode ser qualquer URL publicamente acessível.

  • Deve aceitar requisições HTTP utilizando o método selecionado (GET ou POST).

📌 Exemplo:

https://webhook.site/your-unique-webhook-url

✔️ Certifique-se de que:

  • A URL é pública e acessível pela internet.

  • O servidor está preparado para receber e processar o método escolhido.

  • O endpoint consegue interpretar o formato dos dados enviados pelo Chat-Bot.


4. Salvar Alterações

Depois de configurar todas as opções:

🖱️ Clique em “Salvar alterações”.

  • Este botão se encontra no canto inferior direito da interface.

  • Ao salvar, as configurações se tornam ativas imediatamente.

  • A partir desse momento, o Chat-Bot enviará todas as mensagens recebidas para o endpoint configurado, utilizando o método que você definiu.


📤 Quais Dados São Enviados?

O Chat-Bot envia um conjunto completo de informações referentes às mensagens recebidas no WhatsApp, incluindo:

📩 Dados enviados pelo webhook:

  • Número de telefone do remetente

  • Conteúdo da mensagem (texto, imagens, documentos, áudios etc.)

  • Carimbo de data/hora

  • ID da mensagem

  • Metadados associados

Essas informações permitem criar integrações poderosas, como:
✔️ automação de CRM
✔️ criação de tickets
✔️ disparo de fluxos externos
✔️ armazenamento em banco de dados
✔️ notificações internas
✔️ integrações personalizadas com APIs


📚 Navegação Complementar

Este recurso está localizado entre outras seções importantes:

  • Página anterior: Pare o bot

  • Próxima página: Agente de suporte


** O tempo é base no fuso horário America/New_York