Disparar ações por HTTP (Entrada)
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, HMAC-SHA256 ou sem autenticação).
-
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 mapeado
Seção intitulada “Modo direto ou modo mapeado”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.
- Modo mapeado — o serviço externo tem um formato fixo (Shopify, Stripe, RD Station, n8n) e você extrai os campos do conteúdo recebido para montar a mensagem. O mapeamento é configurado depois de criar o webhook, na aba Mapeamento, capturando um evento real do seu serviço.
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 recebidas 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.