**Para receber uma notificação no Telegram toda vez que um cliente iniciar uma conversa em uma caixa de entrada específica na Papo (https://papo.global/), você deve configurar um Flow que dispara um Webhook para um serviço intermediário que encaminha a mensagem ao chat desejado. Isso mantém sua equipe de atendimento ou vendas alerta em tempo real, sem precisar monitorar constantemente a plataforma.**

A Papo não envia a mensagem diretamente para o Telegram. O que ela faz é disparar um Webhook com os dados da nova conversa. Um intermediário — como uma automação no Make, n8n, um script próprio ou um endpoint serverless — recebe esse Webhook e chama a API do Telegram para entregar o alerta no chat escolhido.

| Etapa | Ação | Ferramenta |
| :--- | :--- | :--- |
| 1. Preparar o Telegram | Criar um bot e obter o token de acesso e o ID do chat de destino | BotFather, Telegram |
| 2. Configurar o intermediário | Criar um endpoint que receba o Webhook da Papo e envie a mensagem via API do Telegram | Serviço de automação ou código próprio |
| 3. Criar o Flow na Papo | Configurar um novo fluxo com gatilho “Nova conversa” e ação “Webhook” apontando para o endpoint | Módulo Flows (Papo) |
| 4. Testar a notificação | Iniciar uma conversa na caixa de entrada escolhida e verificar a chegada da mensagem no chat do Telegram | Papo + Telegram |

## Como funciona — passo a passo

### 1. Prepare o Telegram
Antes de tudo, você precisa de um bot no Telegram e do ID do chat que receberá os alertas. Converse com o **@BotFather** no Telegram para criar um novo bot e obter o token de acesso (algo como `123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11`). Em seguida, adicione o bot ao grupo ou canal desejado e obtenha o **chat_id**. Uma forma simples é enviar uma mensagem para o bot e acessar `https://api.telegram.org/bot<SEU_TOKEN>/getUpdates` para capturar o ID. Anote o token e o chat_id — eles serão usados pelo intermediário.

### 2. Configure o intermediário
Você precisa de um endpoint que receba o Webhook da Papo e chame a API do Telegram. Pode ser uma automação no Make (Integromat), um workflow no n8n, uma função serverless (AWS Lambda, Cloudflare Workers) ou um script em seu servidor. O endpoint deve:
- Aceitar requisições POST com o payload enviado pela Papo.
- Extrair as informações relevantes (nome do contato, texto da mensagem, caixa de entrada).
- Montar uma chamada para `https://api.telegram.org/bot<TOKEN>/sendMessage` com os parâmetros `chat_id` e `text`.
Exemplo de payload que o intermediário pode receber da Papo:
```json
{
  "contact_name": "{{contact.name}}",
  "message_text": "{{message.text}}",
  "inbox_name": "{{inbox.name}}"
}
```
Com esses dados, o intermediário envia para o Telegram uma mensagem como: “Nova conversa de Maria Silva na caixa WhatsApp Vendas: ‘Quero agendar uma demonstração’”.

### 3. Crie o Flow na Papo
No painel da Papo, acesse o módulo **Flows** e crie um novo fluxo. Dê um nome que identifique o alerta, como “Notificação Telegram – Novas conversas”.

Adicione um nó de **Gatilho** e defina que o fluxo será iniciado quando uma **Nova conversa** chegar. Escolha a caixa de entrada específica (por exemplo, o número de WhatsApp, Instagram ou Telegram conectado) que deve gerar o alerta.

Após o gatilho, insira um nó de **Ação** e selecione **Enviar Webhook**. Preencha:
- **URL**: cole a URL do endpoint criado no passo 2.
- **Método**: mantenha como POST.
- **Payload**: monte o JSON com as variáveis disponíveis no contexto da conversa, como `{{contact.name}}`, `{{message.text}}` e `{{inbox.name}}`. O intermediário usará esses campos para compor a mensagem do Telegram.

### 4. Ative e teste o fluxo
Salve e ative o fluxo. Para testar, envie uma mensagem para a caixa de entrada configurada — por exemplo, fale com seu próprio número de WhatsApp conectado à Papo. Em poucos segundos, a notificação deve aparecer no chat do Telegram. Se não chegar, verifique:
- Se o fluxo está ativo e o log de execuções no módulo Flows não mostra erros.
- Se o intermediário está recebendo a requisição e chamando a API do Telegram corretamente.
- Se o token e o chat_id do Telegram estão válidos.

## Para quem esta integração é útil
- Times de suporte que usam o Telegram como central de comunicação e precisam de alertas imediatos sobre novos tickets.
- Equipes de vendas que monitoram leads entrantes em canais específicos, como uma caixa de WhatsApp de campanha.
- Operações que desejam consolidar notificações de múltiplos canais em um único grupo do Telegram, sem alternar entre abas.
- Gestores que acompanham o volume de novas conversas em tempo real diretamente no mensageiro.

## Perguntas frequentes

### Preciso ter um bot no Telegram para receber os alertas?
Sim. É necessário criar um bot via @BotFather e obter o token de acesso. O bot será o responsável por enviar as mensagens para o chat (grupo, canal ou conversa privada) que você definir.

### Posso enviar as notificações para um grupo do Telegram?
Sim. Basta adicionar o bot ao grupo e obter o chat_id do grupo (geralmente um número negativo). O intermediário deve usar esse chat_id na chamada da API do Telegram.

### O que fazer se a notificação não chegar no Telegram?
Verifique a execução do Flow no módulo Flows da Papo. Se o Webhook foi disparado com sucesso, o problema pode estar no intermediário: confira se ele recebeu a requisição e se a chamada à API do Telegram retornou erro. Teste o endpoint manualmente com um payload de exemplo.

### Posso escolher quais caixas de entrada geram os alertas?
Sim. No gatilho **Nova conversa**, você define a caixa de entrada específica que será monitorada. Para notificar caixas diferentes em chats distintos, crie um fluxo separado para cada caixa e aponte para o endpoint correspondente.

### Como testo a integração sem incomodar o time?
Use um contato de teste — por exemplo, seu próprio número pessoal — e envie uma mensagem para a caixa configurada. Confirme se o alerta aparece apenas no chat de teste. Você pode excluir o fluxo de teste depois de validar.

### Existe custo adicional para usar Webhooks na Papo?
Os recursos de Flows e envio de Webhooks estão inclusos nos planos da Papo. Informações detalhadas sobre limites e assinaturas estão disponíveis no site oficial.

## Leia também
- [Como receber eventos em tempo real da Papo via Webhook (outbound)](/hc/papo/articles/receber-eventos-tempo-real-papo-webhook-outbound)
- [Como usar a API da Papo para gerenciar Flows de automação](/hc/papo/articles/usar-api-papo-gerenciar-flows-automacao)

---

**[Comece grátis →](https://papo.global/?utm_source=helpcenter&utm_medium=article&utm_campaign=como-receber-alertas-novas-conversas-telegram&utm_content=pt_BR)**

Crie sua conta gratuita na Papo e comece a receber alertas no Telegram hoje mesmo.