**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

| Etapa | Ação | Ferramenta / local |
| :--- | :--- | :--- |
| 1. Obter uma URL de teste | Acese o webhook.site e copie a URL gerada. | Webhook.site |
|2. Configurar o webhook na Papo com a URL de teste| Insira a URL no campo de destino do webhook (na seção Integrações ou na ação do Flow).| Painel da Papo|
|3. Disparar o webhook | Para webhooks da conta, envie uma mensagem de WhatsApp para a caixa conectada. Para webhooks em Flows, matricule um contato de teste no fluxo. | Caixa de entrada ou Flow |
|4. Analisar o payload recebido | No painel do Webhook.site, veja a requisição que chegou: método, cabeçalhos e o JSON do corpo. | Webhook.site |
|5. Corrigir e substituir pela URL de produçao | Se o payload estiver correto, troque a URL de teste pela URL real do seu sistema e ative a automação. | Painel da Papo |

## 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](/hc/papo/articles/testar-flow-automacao-antes-ativar)
- [Como enviar dados de novos contatos para o Google Sheets via webhook](/hc/papo/articles/enviar-dados-novos-contatos-google-sheets-webhook)

---

**[Comecar grátis →](https://papo.global/?utm_source=helpcenter&utm_medium=article&utm_campaign=testar-conexao-webhook-papo-antes-ativar-automacao&utm_content=pt_BR)**

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