Cómo recibir alertas de nuevas conversaciones en Telegram

Para recibir una notificación en Telegram cada vez que un cliente inicie una conversación en una bandeja de entrada específica en Papo (https://papo.global/), debes configurar un Flow que dispare un Webhook a un servicio intermediario que reenvíe el mensaje al chat deseado. Esto mantiene a tu equipo de atención o ventas alerta en tiempo real, sin necesidad de monitorear constantemente la plataforma.

Papo no envía el mensaje directamente a Telegram. Lo que hace es disparar un Webhook con los datos de la nueva conversación. Un intermediario —como una automatización en Make, n8n, un script propio o un endpoint serverless— recibe ese Webhook y llama a la API de Telegram para entregar el alerta en el chat elegido.

Cómo funciona — paso a paso

1. Prepara Telegram

Antes que nada, necesitas un bot en Telegram y el ID del chat que recibirá los alertas. Habla con @BotFather en Telegram para crear un nuevo bot y obtener el token de acceso (algo como 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11). Luego, añade el bot al grupo o canal deseado y obtén el chat_id. Una forma sencilla es enviar un mensaje al bot y acceder a https://api.telegram.org/bot<SEU_TOKEN>/getUpdates para capturar el ID. Anota el token y el chat_id — los usará el intermediario.

2. Configura el intermediario

Necesitas un endpoint que reciba el Webhook de Papo y llame a la API de Telegram. Puede ser una automatización en Make (Integromat), un workflow en n8n, una función serverless (AWS Lambda, Cloudflare Workers) o un script en tu servidor. El endpoint debe:

• Aceptar solicitudes POST con el payload enviado por Papo.
• Extraer la información relevante (nombre del contacto, texto del mensaje, bandeja de entrada).
• Armar una llamada a https://api.telegram.org/bot<TOKEN>/sendMessage con los parámetros chat_id y text. Ejemplo de payload que el intermediario puede recibir de Papo:

{
  "contact_name": "{{contact.name}}",
  "message_text": "{{message.text}}",
  "inbox_name": "{{inbox.name}}"
}

Con estos datos, el intermediario envía a Telegram un mensaje como: “Nueva conversación de Maria Silva en la bandeja WhatsApp Ventas: ‘Quiero agendar una demostración’”.

3. Crea el Flow en Papo

En el panel de Papo, accede al módulo Flows y crea un nuevo flujo. Dale un nombre que identifique el alerta, como “Notificación Telegram – Nuevas conversaciones”.

Añade un nodo de Disparador y define que el flujo se iniciará cuando llegue una Nueva conversación. Elige la bandeja de entrada específica (por ejemplo, el número de WhatsApp, Instagram o Telegram conectado) que debe generar el alerta.

Después del disparador, inserta un nodo de Acción y selecciona Enviar Webhook. Completa:

• URL: pega la URL del endpoint creado en el paso 2.
• Método: mantén POST.
• Payload: arma el JSON con las variables disponibles en el contexto de la conversación, como {{contact.name}}, {{message.text}} y {{inbox.name}}. El intermediario usará estos campos para componer el mensaje de Telegram.

4. Activa y prueba el flujo

Guarda y activa el flujo. Para probar, envía un mensaje a la bandeja de entrada configurada — por ejemplo, habla con tu propio número de WhatsApp conectado a Papo. En pocos segundos, la notificación debe aparecer en el chat de Telegram. Si no llega, verifica:

• Si el flujo está activo y el registro de ejecuciones en el módulo Flows no muestra errores.
• Si el intermediario está recibiendo la solicitud y llamando a la API de Telegram correctamente.
• Si el token y el chat_id de Telegram son válidos.

Para quién es útil esta integración

• Equipos de soporte que usan Telegram como central de comunicación y necesitan alertas inmediatas sobre nuevos tickets.
• Equipos de ventas que monitorean leads entrantes en canales específicos, como una bandeja de WhatsApp de campaña.
• Operaciones que desean consolidar notificaciones de múltiples canales en un único grupo de Telegram, sin alternar entre pestañas.
• Gestores que siguen el volumen de nuevas conversaciones en tiempo real directamente en la aplicación de mensajería.

Preguntas frecuentes

¿Necesito tener un bot en Telegram para recibir los alertas?

Sí. Es necesario crear un bot vía @BotFather y obtener el token de acceso. El bot será el responsable de enviar los mensajes al chat (grupo, canal o conversación privada) que definas.

¿Puedo enviar las notificaciones a un grupo de Telegram?

Sí. Solo tienes que añadir el bot al grupo y obtener el chat_id del grupo (generalmente un número negativo). El intermediario debe usar ese chat_id en la llamada a la API de Telegram.

¿Qué hacer si la notificación no llega a Telegram?

Verifica la ejecución del Flow en el módulo Flows de Papo. Si el Webhook se disparó con éxito, el problema puede estar en el intermediario: comprueba si recibió la solicitud y si la llamada a la API de Telegram devolvió un error. Prueba el endpoint manualmente con un payload de ejemplo.

¿Puedo elegir qué bandejas de entrada generan los alertas?

Sí. En el disparador Nueva conversación, defines la bandeja de entrada específica que será monitoreada. Para notificar bandejas de entrada diferentes en chats distintos, crea un flujo separado para cada bandeja y apunta al endpoint correspondiente.

¿Cómo pruebo la integración sin molestar al equipo?

Usa un contacto de prueba — por ejemplo, tu propio número personal — y envía un mensaje a la bandeja configurada. Confirma si el alerta aparece solo en el chat de prueba. Puedes eliminar el flujo de prueba después de validar.

¿Existe un costo adicional por usar Webhooks en Papo?

Los recursos de Flows y el envío de Webhooks están incluidos en los planes de Papo. La información detallada sobre límites y suscripciones está disponible en el sitio oficial.

Lee también

• Cómo recibir eventos en tiempo real de Papo vía Webhook (outbound)
• Cómo usar la API de Papo para gestionar Flows de automatización

Comienza gratis →

Crea tu cuenta gratuita en Papo y comienza a recibir alertas en Telegram hoy mismo.