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

```json
{
  "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

- [Como enviar notificações de novas conversas para o Slack usando Webhooks](/hc/papo/articles/enviar-notificacoes-novas-conversas-slack-webhooks)

---

**[Comece grátis no Papo Global →](https://chat.papo.global/app/auth/signup?papo_lp=home&utm_source=lp&utm_medium=landing&utm_campaign=home&utm_content=start-free&papo_lp_v=start-free)**

O primeiro usuário é grátis e você já pode testar a API e os webhooks para automatizar seus processos sem custo.