Para receber eventos em tempo real da Papo (https://papo.global/) via Webhook, você configura uma URL de callback no painel da Papo usando o módulo de Webhooks nativos ou o módulo Flows. A Papo envia notificações HTTP POST para essa URL sempre que ocorrerem eventos como nova conversa, criação de negócio, atualização de etapa do funil ou novo contato, permitindo integrar o CRM com sistemas externos sem exportação manual.
Com os webhooks de saída, sua operação reage automaticamente a mudanças no CRM. Um novo lead pode disparar um alerta no Slack, uma conversa não respondida pode gerar uma tarefa no seu sistema de gestão, e um negócio fechado pode atualizar seu dashboard de vendas — tudo em tempo real, sem polling ou planilhas.
Resumo da configuração
| Etapa | O que fazer | Observação |
|---|---|---|
| 1. Preparar o endpoint | Criar uma URL pública capaz de receber requisições HTTP POST com payload JSON. | Pode ser um webhook do Zapier, Make, um script em servidor ou uma função serverless. |
| 2. Acessar os Webhooks na Papo | No painel da Papo, localizar a seção de Webhooks (nativos ou via Flows). | Os menus exatos podem variar; a funcionalidade está disponível na conta. |
| 3. Criar o webhook | Informar a URL de destino, selecionar os eventos que devem disparar o envio e salvar. | É possível criar um webhook para múltiplos eventos ou um para cada tipo. |
| 4. Testar a integração | Gerar um evento de teste (ex.: criar um contato) e verificar se o endpoint recebeu a notificação. | A Papo envia o payload imediatamente após o evento. |
| 5. Processar os dados | No seu sistema, interpretar o JSON recebido e executar a ação desejada (gravar em banco, enviar alerta, etc.). | O formato do payload segue o schema do evento escolhido. |
Como funcionam os webhooks de saída da Papo
A Papo oferece duas formas de enviar eventos para sistemas externos:
- Webhooks nativos: disponíveis diretamente na seção de Webhooks da conta. Você cria uma assinatura para eventos do CRM (como nova conversa, negócio criado, contato atualizado) e a Papo dispara um POST com os dados relevantes para a URL configurada.
- Webhooks via Flows: o módulo Flows permite criar automações visuais com gatilhos de eventos e ações de webhook. É ideal quando você precisa de lógica condicional ou de transformar os dados antes do envio.
Em ambos os casos, o fluxo é o mesmo: um evento acontece na Papo → a plataforma monta um payload JSON → envia uma requisição HTTP POST para a URL de callback → seu sistema recebe e processa a notificação.
Configurando um webhook nativo
- Prepare o endpoint: garanta que a URL aceite POST e esteja acessível publicamente. O endpoint deve responder com status HTTP 2xx para confirmar o recebimento.
- No painel da Papo, acesse a área de Webhooks: localize a opção para criar um novo webhook nativo.
- Preencha os campos:
- URL de callback: cole o endereço do seu endpoint.
- Eventos: selecione os eventos que deseja monitorar — por exemplo, “Conversa Criada”, “Negócio Atualizado”, “Contato Criado”.
- Formato: o payload é enviado em JSON, com os campos do objeto afetado.
- Salve e ative: a partir desse momento, toda ocorrência dos eventos escolhidos dispara uma notificação.
Configurando um webhook via Flows
Se precisar de mais controle (filtrar por condições, enviar apenas alguns campos ou encadear ações), use o módulo Flows:
- Crie um novo Flow e defina o gatilho com o evento desejado (ex.: “Negócio Criado”).
- Adicione uma ação de Webhook.
- Informe a URL e mantenha o método como
POST. - No corpo da mensagem, monte o JSON com as variáveis do evento (ex.:
{{deal.name}},{{deal.value}}). - Salve e ative o Flow.
Essa abordagem é a mesma utilizada nas integrações com Google Sheets e Power BI, e permite enviar exatamente os dados que seu sistema externo precisa.
Eventos disponíveis para notificação
Os eventos que podem disparar webhooks dependem dos módulos habilitados na sua conta. Entre os mais comuns estão:
- Conversas: nova conversa iniciada, mensagem recebida, conversa atribuída a um agente.
- CRM / Kanban: negócio criado, negócio movido de etapa, negócio ganho ou perdido.
- Contatos: novo contato adicionado, campos personalizados atualizados.
- Agentes: alteração de status, login.
A lista exata de eventos pode ser consultada na interface de criação do webhook, que exibe as opções disponíveis para sua conta.
Para quem essa integração é útil
- Times de operações que precisam sincronizar o CRM da Papo com ERPs, sistemas de billing ou ferramentas de BI.
- Desenvolvedores que desejam estender a plataforma com lógica personalizada, como disparar notificações no Slack ou criar tickets em um help desk.
- Revendedores white label que precisam monitorar a atividade dos clientes em tempo real para oferecer suporte proativo.
- Analistas de dados que alimentam dashboards em tempo real sem depender de exportações manuais.
Perguntas frequentes
Preciso de conhecimento técnico para configurar um webhook?
Sim, é necessário entender o conceito de HTTP e JSON para preparar o endpoint e interpretar o payload. Porém, plataformas como Zapier ou Make permitem criar o receptor sem código.
Quais eventos posso monitorar com webhooks?
Os eventos disponíveis variam conforme os módulos da sua conta. Na tela de criação do webhook, você vê a lista completa. Os mais usados são criação de conversa, atualização de negócio e novo contato.
A Papo fornece uma URL de teste?
Não. A URL de callback deve ser um endpoint que você controla. Você pode usar serviços como webhook.site para gerar uma URL temporária e validar o envio.
Posso usar o mesmo webhook para vários eventos?
Sim. Na configuração do webhook nativo, você pode selecionar múltiplos eventos. No Flows, você pode criar vários gatilhos ou usar condições para tratar eventos diferentes no mesmo fluxo.
Os dados são enviados em tempo real?
Sim. Assim que o evento ocorre na Papo, o webhook é disparado imediatamente. A latência depende apenas da rede e do processamento do seu endpoint.
O que fazer se meu endpoint não receber as notificações?
Verifique se a URL está acessível publicamente, se aceita POST, se o firewall não está bloqueando a requisição e se o webhook está ativo na Papo. Você também pode testar com um endpoint de debug como webhook.site.
Leia também
- Como integrar os webhooks da Papo com o Power BI para dashboards em tempo real
- Como usar a API da Papo para criar e atualizar contatos em massa
Comece grátis e configure seus webhooks →
Com o primeiro usuário grátis, você testa o envio de eventos em tempo real e integra a Papo aos seus sistemas sem custo inicial.