Usa este artículo para conectar un bot de Telegram a tu espacio de trabajo de Intercom, entender qué sucede una vez que la conexión está activa y saber qué hacer si necesitas desconectar. Después de la configuración, las conversaciones de Telegram aparecen en el Inbox junto con todos los demás canales, Fin las maneja automáticamente y los Workflows se aplican con plena paridad.
Qué necesitarás antes de conectar
Necesitarás acceso de administrador en tu espacio de trabajo de Intercom para conectar o desconectar un canal de Telegram.
Antes de conectar, necesitarás un bot de Telegram y tu bot token (una credencial que da permiso a Intercom para enviar y recibir mensajes en nombre de tu bot). Crea un bot a través de @BotFather (el bot oficial de Telegram para crear y gestionar bots). Consulta la documentación de Telegram para instrucciones paso a paso.
Nota: Tu bot token da control total sobre el bot. Mantenlo seguro y no lo compartas más allá de lo necesario para la conexión con Intercom.
Cómo conectar Telegram
Ten tu bot token de @BotFather listo antes de comenzar.
Pega tu bot token en el campo Bot token.
Haz clic en Conectar.
Una vez conectado:
Intercom valida tu bot token.
El webhook (el punto final de conexión que recibe mensajes de Telegram) se registra, vinculando tu bot de Telegram al Inbox.
La instalación se registra en el Registro de Actividad de Compañeros (Configuración > Seguridad > Actividad de Compañeros).
El canal de Telegram aparece como activo en Configuración > Canales > Telegram una vez que la configuración está completa. Para verificar la conexión, envía un mensaje de prueba a tu bot de Telegram; debería aparecer como una nueva conversación en tu Inbox de Intercom en unos segundos.
¿Puedo usar el mismo bot en varios espacios de trabajo?
Cada bot de Telegram solo puede estar conectado a un espacio de trabajo de Intercom a la vez. Si intentas conectar un bot que ya está en uso en otro espacio de trabajo, la conexión fallará.
Cómo desconectar Telegram
Para desconectar, ve a Configuración > Canales > Telegram y haz clic en Desconectar.
Las conversaciones existentes en el Inbox no se ven afectadas cuando desconectas; permanecen accesibles y pueden seguir siendo gestionadas por los compañeros. Sin embargo, los clientes no podrán enviar nuevos mensajes al bot hasta que se vuelva a conectar.
Importante: Desconectar elimina permanentemente el bot token y el secreto del webhook (una credencial de seguridad vinculada a la conexión del webhook) de Intercom. Estas credenciales no se pueden recuperar. Para reconectar, necesitarás regenerar tu bot token a través de @BotFather y completar la configuración nuevamente.
Envía formularios de ticket alojados a clientes de Telegram
Puedes recopilar información estructurada de tus clientes de Telegram enviándoles un formulario de ticket alojado, de la misma manera que en Discord, Slack y WhatsApp. El cliente verifica su identidad con un solo toque usando el inicio de sesión integrado de Telegram, luego completa y envía el formulario sin salir del chat.
Nota: Enviar formularios de ticket alojados a clientes de Telegram está actualmente en beta.
Configura el domain de tu bot en BotFather
El widget de inicio de sesión de Telegram solo funciona en un domain registrado con tu bot. Debes configurarlo una vez por bot; el domain depende de la región de hosting de tu espacio de trabajo:
Región | Domain a configurar |
Estados Unidos | app.intercom.com |
Europa | app.eu.intercom.com |
Australia | app.au.intercom.com |
Abre un chat con @BotFather en Telegram.
Envía
/setdomain.Selecciona tu bot.
Envía el domain para tu región de la tabla anterior.
Nota: Si no estás seguro de en qué región está tu espacio de trabajo, revisa la URL que usas para iniciar sesión en Intercom; coincide con uno de los domains anteriores. Configurar el domain de una región incorrecta impedirá que aparezca el widget de inicio de sesión.
Envía un formulario a un cliente de Telegram
Abre la conversación de Telegram en tu Inbox.
En el compositor de respuestas (o mediante las acciones
⌘K/Ctrl+K), elige enviar un formulario de ticket alojado.Selecciona el formulario y envíalo. El cliente recibe un enlace en el chat de Telegram.
Lo que ve el cliente
Abre el enlace desde el chat.
Se le pide que verifique su identidad con el botón Iniciar sesión con Telegram.
Después de un toque, se abre el formulario; lo completa y envía.
El ticket enviado aparece de nuevo en la conversación, igual que cualquier otro formulario de ticket alojado.
Solución de problemas
El botón de inicio de sesión no aparece: el domain del bot no está configurado o se usó el domain de una región incorrecta. Vuelve a ejecutar
/setdomainen BotFather con el domain correcto para tu región."Verificación fallida" después de tocar iniciar sesión: confirma que el bot conectado a tu integración de Telegram coincide con el bot para el que configuraste el domain.