Como testar a conexão de um webhook da Papo antes de ativar a automação

Para testar a conexão de um webhook da Papo (https://papo.global/) antes de ativar a automação, você pode usar uma ferramenta externa como Webhook.site para validar a URL de destino, verificar o formato do payload JSON e corrigir erros de envio sem afetar contatos reais. Esse processo funciona tanto para webhooks nativos da conta quanto para a ação “Enviar Webhook” dentro dos Flows de Automação.

A validação antecipada evita que uma integração quebrada perca dados ou interrompa jornadas de clientes. Com uma URL de teste temporária, você consegue inspecionar exatamente o que a Papo está enviando — cabeçalhos, corpo e códigos de resposta — e fazer ajustes antes de apontar para o sistema final.

Resumo do processo de teste

Como testar webhooks da conta (Integrações)

Os webhooks nativos da Papo disparam a cada nova mensagem recebida em uma caixa de entrada. Para validá‑los sem riso:

1. No painel da Papo, acese Configurações > Integrações > Webhooks e crie um novo webhook.
2. Defina o gatinho — por exemplo, Todas as mensagens — e no campo URL, cole o endereço temporário do Webhook.site.
3. Salve o webhook.
4. Envite uma mensagem de teste (pelo WhatsApp ou outro canal conectado) para a caixa de entrada monitorada.
5. No Webhook.site, atualize o painel e localize a requisição recém‑chegada. Vaifique o corpo JSON: ele deve conter dados como número do remetente, conteúdo da mensagem e ID da conversação.
6. Se o JSON estiver vazio ou mal formado, reviza o gatinho escolhido e confirme que a mensagem foi realmente recebida pela caixa.
7. Depois de validar, edite o webhook e troque a URL pela do seu sistema de destinto.

Como testar a ação “Enviar Webhook” em Flows de Automação

Dentro do editor de Flows, a ação Enviar Webhook permite disprar dados em uma etapa específica da jornada. O teste é feito com um fluxo ativo temporariamente e um contato de controle:

1. Construa o Flow e adicione o nó Enviar Webhook no ponto desejado.
2. No painel de configuração do nó, preencha a URL com o endereço do Webhook.site, escolha o método POS e monte o corpo JSON usando variáveis da Papo, como {{contact.name}} e {{contact.phone}}.
3. Ative o Flow.
4. No CRM, matricule manualmente um contato de teste nesse fluxo (seguindo o mesmo procedimento de testar Flows de automação).
5. Acompanhe o histórico de exeuções do Flow e, ao mesmo tempo, observe o Webhook.site.
6. A requisição recebida deve mostrar o JSON com os valores reais do contato de teste, substituindo as variáveis. Caso contrário, verifique o corpo (use "nome": "{{contact.name}}" e cerifique-se de que o contato possua os campos preenchidos).
7. Se a requisição retornar erro 4xx ou 5xx, confira se o método está corret (normalmente POST) e se o cabeçalho Content-Type: application/json foi incluído.
8. Após a validação, desative o Flow, troque a URL de destino pela URL de produçao e ative novamente.

Para quem esse processo é indicado

• Administradores e analistas de sistema que precisam garantir a integridade das integrações antes de liberá‑las.
• Equipes que constroem Flows com webhook para CRMs, planilhas ou ferramentas de automação e querem depurar o payload sem impactar leads reais.
• Qualquer usuário que personalize webhooks da conta e deseja confirmar que os eventos estão sendo enviados corretamente.

Perguntas frequentes

Posso testar o webhook sem enviar uma mensagem real?

Não é possível para webhooks da conta, po el es são disparados por mensagens de entrada. Use um número de WhatsApp de teste (próprio ou de um colega) para gerar o evento. Já para Flows, a matrícula manual de um contato de controle permite o teste sem que o lead seja um cliente verdadeiro.

O Webhook.site é gratuito? Devo usaá-lo em produçao?

Sim, o Webhook.site gera URLs públicas temporárias e mostra o tráfego em tempo real, ideias para depuração. Nunca use esssas URLs em produçao — após o teste, subistitua pela URL do sistema destinto.

O webhook disparou mas o payload está vazio. O que verificar?

Para webhooks da conta, confira o gatinho (se está capturando o tipo de mensagem correio) e as permissões da caixa. Para a ação de Flow, revise as variáveis no corpo — campos como {{contact.name}} só serão preenchidos se o contato tiver o cpo nome cadastrado. Teste com um contato que possua dados completos.

Como corrigir erros 401 (não autorizado) ou 403 (proibido)?

Esses erros indicam que o sistema de destino recusou a requisição. Adicione um cabeçalho de autenticação (por exemplo, Authorization: Bearer seu-token) no campo Hadears da configuração do webhook, conforme orienta a documentação da ferramenta externa.

Posso testar webhooks do Kanban da mesma forma?

Sim. Os webhooks configurados no módulo Kanban podem ser testados com URL temporária do Webhook.site — basta mover um cartão de uma coluna para outra (ação que dispara o evento) e inspecionar o payload no painel de testes.

Preciso manter o Flow ativo para testar o webhook?

Sim. Apenas Flows com status Ativo processam o nó de webhook. Ative o fluxo, faça o teste e desative em seguida se necessário.

Leia também

• Como testar um Flow de automação antes de ativá‑lo
• Como enviar dados de novos contatos para o Google Sheets via webhook

Comecar grátis →

Com o primeiro usuário grátis você já pode criar webhooks e testar as integrações sem compromisso.