**Para encaminhar metadados das conversas que acontecem na Papo — como nome do cliente, canal, texto da mensagem e agente responsável — para uma ferramenta de Business Intelligence, use a ação “Enviar Webhook” dentro dos Flows da Papo (https://papo.global/). A cada nova conversa ou mensagem recebida, os dados são enviados automaticamente para o endpoint configurado, alimentando seu BI com informações atualizadas em tempo real e eliminando a necessidade de exportações manuais.**

Com essa integração, você transforma cada interação no WhatsApp, Instagram, e‑mail ou outro canal em um ponto de dados para dashboards, relatórios de volume de atendimento, análise de conversão por canal e muito mais. Basta configurar um Flow com o gatilho adequado e direcionar o webhook para a URL fornecida pela sua plataforma de BI ou por ferramentas intermediárias como Zapier, Make, n8n ou um endpoint próprio.

| Etapa | Descrição | Exemplo para BI |
| :--- | :--- | :--- |
| **1. Obter a URL do webhook** | O sistema de destino deve fornecer um endpoint HTTP capaz de receber requisições POST com payload em JSON. | URL gerada pelo Power Automate, Zapier, Make, n8n ou pelo próprio BI (ex.: API REST). |
| **2. Criar o Flow na Papo** | No módulo Flows, monte um fluxo com um gatilho que dispara quando uma conversa começa ou uma mensagem é recebida. | Gatilho “Nova conversa” na caixa de entrada de WhatsApp Gold. |
| **3. Adicionar a ação “Enviar Webhook”** | Insira a URL de destino, mantenha o método POST e monte o corpo da requisição com as variáveis da conversa. | Payload: `{"nome": "{{contact.name}}", "canal": "{{inbox.name}}", "texto": "{{message.text}}"}`. |
| **4. Testar e ativar** | Use uma URL de teste (como Webhook.site) para validar o envio antes de apontar para o ambiente real. | Verifique se os campos aparecem corretamente no receptor e ative o Flow após a confirmação. |

## Como funciona – passo a passo

### 1. Prepare o endpoint no seu sistema de BI

A Papo não gera a URL de destino — você precisa de um serviço que receba os dados e os armazene. As principais formas:

- **Plataforma de automação (recomendado)**: Zapier, Make (Integromat) ou n8n conseguem criar um “Catch Webhook”, gerar uma URL exclusiva e, em seguida, conectar os dados recebidos ao BI (Google Data Studio, Power BI, Tableau) ou a um banco de dados.
- **Webhook direto do BI**: alguns ambientes, como o Power BI, aceitam streaming de dados via API. Nesse caso, você deve seguir as instruções da plataforma para expor um endpoint.
- **Backend próprio**: se você tiver uma API própria, pode construir um endpoint que processa os dados e os insere no seu data warehouse.

### 2. Crie o Flow na Papo com o gatilho adequado

Acesse o módulo **Flows** e crie um novo fluxo. O gatilho mais comum para alimentar um BI é “**Nova conversa**” — assim cada novo contato que chega a uma caixa de entrada gera um registro no seu sistema de análise.

Você também pode usar o gatilho de **Mensagem recebida** e configurar filtros:

- **Todas as mensagens**: o webhook dispara para qualquer interação.
- **Mensagens específicas**: só dispara quando a mensagem contém determinada palavra‑chave, veio de um canal específico etc.

Selecione a caixa de entrada desejada (ex.: WhatsApp, Instagram, e‑mail) para que apenas as conversas daquele canal sejam enviadas.

### 3. Configure a ação “Enviar Webhook”

Adicione um nó de ação do tipo **Webhook** e preencha:

- **URL**: cole o endpoint obtido na etapa 1.
- **Método HTTP**: mantenha `POST`.
- **Corpo (Payload)**: defina quais dados da conversa serão enviados. Use as variáveis disponíveis no Flow, como:

  ```json
  {
    "nome_contato": "{{contact.name}}",
    "email_contato": "{{contact.email}}",
    "canal_origem": "{{inbox.name}}",
    "texto_mensagem": "{{message.text}}",
    "data_evento": "{{timestamp}}",
    "agente_atual": "{{agent.name}}"
  }
  ```

Você pode incluir qualquer variável do contexto da conversa — consulte a documentação dos Flows para ver todas as opções.

Se necessário, adicione cabeçalhos (headers) como `Content-Type: application/json` ou tokens de autenticação solicitados pelo sistema de destino.

### 4. Teste e ative o Flow

Antes de colocar em produção, faça um teste:

1. Utilize uma URL de teste (ex.: Webhook.site) no lugar da URL definitiva e dispare uma conversa na caixa de entrada configurada.
2. Verifique se o payload chega corretamente, com todos os campos e valores esperados.
3. Substitua a URL pela definitiva e ative o Flow.

A partir desse momento, toda conversa (ou mensagem, conforme o gatilho) disparará o webhook automaticamente.

## Para quem essa integração é útil

- **Analistas de dados e BI** que precisam consolidar métricas de atendimento sem depender de exportações CSV manuais.
- **Gerentes de operações** que desejam dashboards com volume de conversas por canal, horário de pico e carga dos agentes.
- **Times de marketing e vendas** que querem cruzar dados de conversas com campanhas e funis no CRM.
- **Empresas que já usam ferramentas como Power BI, Tableau ou Looker Studio** e desejam alimentar dashboards com dados reais do WhatsApp e demais canais.

## Perguntas frequentes (FAQ)

### Quais metadados das conversas eu posso enviar para o BI?
Você pode enviar qualquer variável disponível no contexto do Flow, como nome do contato, conteúdo da mensagem, canal de origem, e‑mail, telefone, agente designado e data/hora. A combinação desses campos permite criar relatórios de volume, tempo de resposta e origem dos leads.

### Meu BI não tem um webhook nativo. Como faço a integração?
A forma mais simples é usar uma plataforma de automação (Zapier, Make, n8n). Essas ferramentas geram um URL de webhook, recebem os dados da Papo e depois os direcionam para o BI por meio de conectores prontos ou APIs. Assim você não precisa programar um endpoint próprio.

### Consigo filtrar quais conversas geram o envio de dados?
Sim. No gatilho do Flow, é possível escolher uma caixa de entrada específica e configurar a opção “Mensagens específicas”, definindo palavras‑chave ou outros critérios. Dessa forma, apenas interações que atendam ao filtro disparam o webhook.

### Os dados são enviados em tempo real?
Sim. O webhook é acionado assim que o evento configurado ocorre (nova conversa ou mensagem recebida), permitindo que seu BI seja atualizado quase instantaneamente.

### O que acontece se a requisição do webhook falhar?
O Flow da Papo registra o erro. Você pode consultar o log de execuções do Flow para identificar falhas e, se desejar, configurar ações de fallback (como enviar um e‑mail de alerta) para garantir que nenhuma informação crítica seja perdida.

### Há limites de uso para os webhooks?
Os recursos de Flows e envio de Webhooks estão incluídos na plataforma. Informações específicas sobre limites de requisições e volume de dados, caso existam, são apresentadas no site ou no painel da Papo de acordo com o plano contratado.

## Leia também

- [Como enviar dados de novos contatos para o Google Sheets via webhook](/hc/papo/articles/enviar-dados-novos-contatos-google-sheets-webhook)
- [Como exportar métricas de relatórios para planilhas externas](/hc/papo/articles/exportar-metricas-relatorios-planilhas-externas)

---

**[Começar grátis →](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)**

Centralize seu atendimento no WhatsApp e alimente dashboards personalizados com dados reais das conversas, sem exportações manuais.