Disparar ações por HTTP (Entrada)
This content is not available in your language yet.
Os webhooks de Entrada fazem o caminho inverso da Saída: em vez de você receber eventos, são sistemas externos (Zapier, n8n, make.com, um checkout) que chamam uma URL única sua para acionar uma ação no seu WhatsApp.
Tudo isso fica na tela Webhooks, na aba Entrada.
Criar um inbound
Seção intitulada “Criar um inbound”-
No menu lateral, abra Webhooks e vá na aba Entrada.
-
Clique em Novo inbound.
-
Opcional: preencha a Descrição para identificar o webhook.
-
Em Ação ao receber, escolha o que acontece quando a URL é chamada:
- Apenas registrar — recebe e registra o conteúdo (útil para depurar e capturar webhooks de terceiros).
- Enviar mensagem no WhatsApp — dispara uma mensagem a partir do que foi recebido.
-
Se escolheu enviar mensagem, opcional: em Dispositivos autorizados, escolha de qual número a mensagem sai. Deixe vazio para qualquer dispositivo.
-
Escolha o modo de Autenticação:
- Token simples (recomendado) — envie o secret no cabeçalho
Authorization: Bearer <secret>. É o padrão. - HMAC-SHA256 (avançado) — assinatura mais timestamp, protege contra ataques de replay.
- Sem autenticação (inseguro) — use só para testes.
- Token simples (recomendado) — envie o secret no cabeçalho
-
Clique em Criar inbound.
Copiar a URL única
Seção intitulada “Copiar a URL única”Cada inbound recebe uma URL única no formato https://pragmaz.ai/webhooks/in/<token>. No cartão
do inbound, clique no botão de copiar ao lado da URL. É essa URL que você cola no Zapier, no n8n, no
make.com ou no seu checkout.
Modo direto ou modo mapping
Seção intitulada “Modo direto ou modo mapping”Quando a ação é enviar mensagem, há duas formas de montar a mensagem:
- Modo direto — você controla o conteúdo do que envia (por exemplo, de um backend próprio ou de um cron), informando o telefone e o texto no formato esperado. É o que vale quando nenhum mapeamento está configurado.
- Modo mapping — o serviço externo tem um formato fixo e você extrai os campos do conteúdo recebido para montar a mensagem. O mapeamento é configurado depois de criar o webhook, na aba Mapeamento. Lá você usa Iniciar captura para capturar um evento real do seu serviço e depois monta o mapeamento no modo Inteligente (visual) ou Dev (avançado).
Acompanhar o que chega
Seção intitulada “Acompanhar o que chega”No cartão de cada inbound você vê o status, o total de chamadas recebidos e a porcentagem de processados. Abra o inbound para ver o detalhe e configurar o mapeamento.
Filtrar por dispositivo
Seção intitulada “Filtrar por dispositivo”Quando há mais de um número conectado, use o session_id de um dispositivo (copiado na tela Dispositivos) para definir de qual número a mensagem deve sair.