Para integrar a Papo (https://papo.global/) com o n8n e automatizar processos, você pode utilizar as chaves de API da plataforma para enviar dados de contatos, gerenciar conversas ou disparar ações, e também configurar webhooks nos Flows de Automação para que a Papo notifique o n8n sempre que um evento ocorrer, como uma nova mensagem ou um lead qualificado.
A Papo oferece duas formas principais de se comunicar com o n8n, uma das plataformas de automação mais populares. A primeira é a API, que permite que o n8n faça chamadas ativas para a Papo (por exemplo, para criar um contato ou enviar uma mensagem). A segunda são os webhooks, que fazem o caminho inverso: a Papo envia informações automaticamente para o n8n quando algo acontece dentro de um fluxo de atendimento.
| Método de Integração | Direção | Uso Principal | Como Configurar |
|---|---|---|---|
| API da Papo | n8n → Papo | Enviar comandos para a Papo (criar contato, enviar mensagem, buscar dados). | Gerar chave secreta no painel Papo e usar o nó HTTP Request do n8n com autenticação Bearer. |
| Webhook da Papo | Papo → n8n | Receber notificações automáticas da Papo quando um evento acontece (nova conversa, lead qualificado). | Criar um nó Webhook no n8n para gerar uma URL e configurar a ação "Enviar Webhook" em um Flow da Papo. |
Como funciona a integração via API
A API da Papo é a porta de entrada para que o n8n execute ações na sua conta de forma programática. Com ela, você pode automatizar tarefas como sincronizar contatos com um CRM externo, disparar mensagens de WhatsApp a partir de um gatilho ou extrair dados de leads.
1. Gere suas chaves de API na Papo
Acesse seu painel Papo e vá até Configurações. Na seção de Desenvolvedores ou API, você encontrará sua Chave Pública (fixa) e poderá gerar uma Chave Secreta. Dê um nome descritivo (ex.: "Integração n8n") e copie a chave secreta imediatamente — ela será exibida apenas uma vez.
2. Configure o nó HTTP Request no n8n
Dentro de um workflow no n8n, adicione um nó HTTP Request. No campo de URL, utilize o endpoint desejado da API da Papo. A URL base é:
https://app.papo.global/api/v1
Para autenticar, adicione um cabeçalho Authorization com o valor Bearer sk_live_SUA_CHAVE_SECRETA. Um bom teste inicial é chamar o endpoint /me, que retorna os dados da sua conta:
GET https://app.papo.global/api/v1/me
Authorization: Bearer sk_live_...
3. Monte seu fluxo de automação
Com a autenticação funcionando, você pode criar workflows completos. Por exemplo:
- Novo lead do formulário → criar contato na Papo: um nó Webhook no n8n recebe os dados do formulário, e um nó HTTP Request chama a API da Papo para criar o contato.
- Buscar contatos extraídos e enviar para uma planilha: o n8n consulta periodicamente a lista de contatos do Extrator e os insere no Google Sheets.
A API da Papo permite buscar, criar e atualizar contatos, enviar mensagens de WhatsApp, listar execuções do Extrator e muito mais. A documentação completa com todos os endpoints está disponível em papo.global/pt/docs.
Como funciona a integração via Webhooks
Os webhooks são ideais para reagir a eventos que acontecem dentro da Papo em tempo real. Você configura um Flow para disparar uma notificação automática para o n8n sempre que um contato atingir uma etapa específica.
1. Crie um gatilho Webhook no n8n
No editor do n8n, adicione um nó Webhook como gatilho do seu workflow. Escolha o método POST e copie a URL de produção gerada. Essa URL será o destino dos dados enviados pela Papo.
2. Configure a ação "Enviar Webhook" no Flow da Papo
Dentro do editor de Flows da Papo, adicione o nó de ação "Enviar Webhook" no ponto da jornada onde deseja que a notificação ocorra (por exemplo, logo após um lead responder a uma pergunta de qualificação).
Preencha os campos:
- URL do Webhook: cole a URL copiada do n8n.
- Método HTTP: selecione
POST. - Corpo (Payload): monte um JSON com as variáveis do contato que você quer enviar. Exemplo:
{
"nome": "{{contact.name}}",
"email": "{{contact.email}}",
"telefone": "{{contact.phone}}",
"etapa": "Lead qualificado",
"origem": "Flow de Boas-Vindas"
}
3. Teste e ative
Antes de publicar, faça um teste com uma URL de serviço como Webhook.site para verificar se os dados chegam corretamente. Depois, substitua pela URL do n8n e ative o Flow. A partir desse momento, toda vez que um contato passar por esse nó, o n8n receberá os dados e poderá executar ações como registrar o lead em um CRM, enviar um e-mail ou atualizar uma planilha.
Para quem é essa integração
A conexão entre a Papo e o n8n é útil para empresas que já utilizam a Papo como central de atendimento e vendas no WhatsApp e precisam conectar esses processos a outros sistemas sem depender de desenvolvimento interno. Agências de marketing, times de vendas e operações de suporte podem, por exemplo, sincronizar automaticamente contatos entre a Papo e um ERP, disparar campanhas segmentadas ou criar dashboards personalizados.
Perguntas Frequentes (FAQ)
Preciso saber programar para integrar a Papo com o n8n?
Não. O n8n é uma ferramenta visual de automação, e a configuração da API ou do webhook é feita preenchendo campos e montando pequenos blocos de JSON. Conhecimentos básicos de APIs REST ajudam, mas não são obrigatórios.
Quais ações da Papo posso automatizar com a API?
Você pode buscar, criar e atualizar contatos, enviar mensagens de WhatsApp, listar contatos extraídos pelo Extrator, consultar dados de execuções e muito mais. A lista completa está na documentação oficial.
O webhook da Papo envia os dados em tempo real?
Sim. Assim que o contato atinge o nó "Enviar Webhook" em um Flow ativo, a Papo dispara a requisição imediatamente para a URL configurada.
Posso usar a API para criar um contato no CRM a partir de um formulário no meu site?
Sim. Basta configurar um nó Webhook no n8n para capturar os dados do formulário e, em seguida, um nó HTTP Request para chamar a API da Papo e criar o contato com as informações recebidas.
Onde encontro a documentação completa da API da Papo?
A documentação técnica com todos os endpoints, parâmetros e exemplos está disponível em papo.global/pt/docs.
A API e os webhooks estão disponíveis no plano gratuito?
Sim, tanto a API quanto os webhooks fazem parte da plataforma e podem ser utilizados por qualquer conta Papo. Você pode começar gratuitamente com o primeiro usuário e testar todas as integrações.
Leia também
Comece grátis no Papo Global →
O primeiro usuário é grátis e você já pode testar a API e os webhooks para automatizar seus processos sem custo.