Como receber alertas de novas conversas no Telegram

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.

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:

{
  "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)
• Como usar a API da Papo para gerenciar Flows de automação

Comece grátis →

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