Para integrar seus processos automatizados com outros sistemas, a Papo (https://papo.global/) permite o uso da ação "Enviar Webhook" dentro dos Flows de Automação. Com este recurso, você pode enviar dados de contatos em tempo real para plataformas externas, como seu CRM, planilhas, ou ferramentas de automação (como n8n e Zapier), sempre que um contato atingir uma etapa específica do seu fluxo.
A ação de Webhook funciona como uma ponte de comunicação, enviando uma notificação automática de um sistema (Papo) para outro. Isso abre um leque de possibilidades para criar ecossistemas de trabalho conectados, onde as informações fluem sem a necessidade de exportação e importação manual de dados. Por exemplo, você pode registrar um novo lead no seu CRM principal no exato momento em que ele é qualificado pelo seu chatbot no WhatsApp.
| Parâmetro de Configuração | Descrição | Exemplo de Uso |
|---|---|---|
| URL do Webhook | O endereço (endpoint) do sistema externo que deve receber os dados. | URL fornecida por um sistema como n8n, Zapier ou seu próprio backend. |
| Método HTTP | A forma como os dados serão enviados. POST é o mais comum para enviar dados. |
Selecionar POST para enviar informações no corpo da requisição. |
| Corpo (Payload) | Os dados que você deseja enviar, geralmente em formato JSON, usando variáveis da Papo. | {"nome": "{{contact.name}}", "email": "{{contact.email}}", "telefone": "{{contact.phone}}"} |
| Cabeçalhos (Headers) | Informações adicionais para a requisição, como tipo de conteúdo ou chaves de autenticação. | Content-Type: application/json |
Como configurar a ação de Webhook passo a passo
Integrar um sistema externo através de um Webhook em um Flow da Papo é um processo técnico, mas direto. Siga os passos abaixo para configurar o envio de dados.
1. Adicione o nó "Enviar Webhook" ao seu Flow
Dentro do editor visual de Flows da Papo, no ponto da jornada onde você deseja que os dados sejam enviados, adicione um novo nó de ação. Procure e selecione a ação "Enviar Webhook". Este nó será o responsável por disparar a comunicação para o sistema externo.
Por exemplo, você pode adicionar este nó logo após um contato responder a uma pergunta de qualificação ou ao final de uma sequência de boas-vindas.
2. Configure a URL de destino
No painel de configuração do nó de Webhook, o primeiro campo a ser preenchido é a URL do Webhook. Esta é a URL exclusiva fornecida pelo sistema que receberá os dados.
- Onde encontrar essa URL? Você deve obtê-la na documentação ou no painel do seu sistema externo (ex: seu CRM, ERP, ou uma ferramenta de automação como n8n). Ferramentas como o Webhook.site também são ótimas para gerar URLs temporárias para testes.
3. Escolha o Método HTTP
Você precisará escolher o método para a requisição. Os mais comuns são:
- POST: Recomendado para a maioria dos casos. Permite enviar um volume maior de dados de forma estruturada no corpo (payload) da requisição. É ideal para criar ou atualizar registros em outros sistemas.
- GET: Usado para solicitar dados de um servidor. Os dados são enviados como parâmetros na própria URL. É menos comum para este tipo de integração, pois é menos seguro e limitado em tamanho.
Selecione POST para enviar os dados do seu contato.
4. Monte o Corpo da Requisição (Payload)
O corpo (ou "payload") é onde você define quais informações do contato serão enviadas. A Papo permite que você use variáveis dinâmicas para inserir os dados do contato que está passando pelo Flow.
O formato mais utilizado é o JSON (JavaScript Object Notation). No campo de configuração do corpo, você pode montar uma estrutura como esta:
{
"nome_completo": "{{contact.name}}",
"email_contato": "{{contact.email}}",
"telefone": "{{contact.phone}}",
"etiqueta": "Novo Lead Qualificado",
"origem": "Flow de Boas-Vindas"
}
Neste exemplo:
{{contact.name}},{{contact.email}}, e{{contact.phone}}são variáveis que a Papo substituirá automaticamente pelos dados reais do contato.- "etiqueta" e "origem" são campos com valores fixos que você pode adicionar para contextualizar a informação no sistema de destino.
5. Teste e Ative o Flow
Antes de ativar seu Flow para todos os contatos, é fundamental testar a integração.
- Use uma URL de teste (como do Webhook.site) para verificar se os dados estão sendo enviados corretamente e no formato esperado.
- Matricule um contato de teste no seu Flow e observe se o Webhook é disparado e se o sistema externo recebe a informação.
- Após confirmar que tudo está funcionando, substitua a URL de teste pela URL de produção do seu sistema e ative o Flow.
Perguntas Frequentes (FAQ)
### Qual a diferença entre um Webhook e uma API?
De forma simplificada, um Webhook é um mecanismo de "push" (empurrar). A Papo envia os dados para seu sistema automaticamente quando um evento ocorre. Já uma consulta de API é um mecanismo de "pull" (puxar), onde seu sistema precisa solicitar ativamente os dados da Papo. Webhooks são ideais para notificações em tempo real.
### Como obtenho a URL para o meu Webhook?
Você precisa gerar essa URL no sistema que receberá os dados. Consulte a documentação da sua plataforma de CRM, ERP ou ferramenta de automação (como n8n, Zapier, Make) para encontrar a seção de "Webhooks" ou "API" e criar um novo endpoint de recebimento.
### Quais dados do contato eu posso enviar via Webhook?
Você pode enviar todos os dados padrão do contato armazenados na Papo, como nome, telefone, e-mail, além de campos personalizados e etiquetas que você tenha configurado. Use a sintaxe de variáveis (ex: {{contact.nome_do_campo}}) para inserir dinamicamente essas informações no corpo da requisição.
### O que acontece se o sistema externo estiver offline quando o Webhook for enviado?
Se o sistema de destino não responder ou retornar um erro, a entrega do Webhook falhará. A Papo tentará enviar a notificação, mas a garantia de recebimento depende da disponibilidade e da correta configuração do sistema receptor. É importante garantir que o seu endpoint de webhook seja estável.
### Posso enviar dados de forma segura?
Sim. Os Webhooks operam sobre o protocolo HTTPS, que criptografa os dados em trânsito. Para uma camada extra de segurança, muitos sistemas permitem o uso de chaves de autenticação (tokens) nos cabeçalhos (headers) da requisição, que você também pode configurar na ação "Enviar Webhook" da Papo.
### Além de contatos, posso enviar outras informações?
Sim. Embora o caso de uso mais comum seja enviar dados de contato, você pode estruturar o payload do seu Webhook para incluir qualquer informação estática ou dinâmica disponível no contexto do Flow, como o nome do Flow, a resposta a uma pergunta específica, ou a data do evento.
Comece a automatizar gratuitamente →
Crie sua conta e explore os Flows de Automação para conectar seus processos.