Telegram

Qué es el canal de Telegram

Telegram expone su superficie de mensajería de negocio a través de la Bot API. Cada bot se crea y administra mediante BotFather, el bot oficial de creación de bots de Telegram, accesible en @BotFather dentro de cualquier app de Telegram. Al crear un bot obtienes un nombre de usuario de bot que termina en bot (p. ej. @MyShop_bot) y un token de bot que autentica cada llamada a la API. Vale la pena saber algunas cosas de entrada:

• Autenticación por token, no OAuth. Pegas una sola cadena secreta. No hay redirección a Telegram, ni pantalla de permisos, ni Portafolio comercial de Meta que autorizar: una diferencia real frente al flujo de WhatsApp / Facebook / Instagram.
• El token de bot es la contraseña del bot. Cualquiera que lo tenga puede leer todos los mensajes enviados al bot, enviar mensajes como el bot y cambiar sus ajustes. Trátalo como un secreto de producción.
• Los usuarios deben escribirle al bot primero. Un bot no puede iniciar una conversación con alguien que nunca le ha enviado un mensaje (normalmente tocando /start). Esta es la garantía anti-spam de Telegram.
• Sin ventana de 24 horas. Una vez que un usuario le ha escrito a tu bot, el Clon puede responder en cualquier momento —días o semanas después—, sin plantillas y sin fallo por ventana expirada. Ve No hay ventana de 24 horas.
• Solo texto y voz. Si alguien le envía al bot una foto, un video, un sticker o un archivo, el bot responde al instante con una nota fija —«Por ahora solo puedo procesar mensajes de texto y de voz.»— y no se guarda nada ni el Clon lo responde, aunque tenga encendido su interruptor Leer fotos y documentos que envían los clientes. Esta nota y las demás respuestas integradas del bot (la bienvenida a /start y un aviso cuando no se puede descargar un mensaje de voz) siguen el idioma de la app de Telegram del cliente cuando es español o inglés; si no, salen en español si el idioma de tu cuenta es español, y en inglés si no lo es.
• Una respuesta se puede retirar durante 48 horas. En Mensajes, el botón de bote de basura Eliminar respuesta de una respuesta, del Clon o de tu equipo, puede quitarla del chat del cliente dentro de las 48 horas siguientes a su envío; después, Telegram ya no lo permite. La respuesta se queda en el hilo, atenuada y con la etiqueta Eliminada.

Agregas Telegram desde la página de Conexiones. Una vez activo, aparece ahí como una fila identificada por el nombre de usuario del bot (mostrado como «Telegram · @tu_bot»), y los mensajes entrantes del bot aparecen en la superficie de Mensajes etiquetados con el canal.

Crea un bot con BotFather

Antes de poder conectar nada, necesitas un bot y su token. Creas ambos dentro de Telegram conversando con BotFather: sin sitio web, sin panel. Si ya tienes un bot y su token, salta a Conectar el bot.

1. Abre BotFather en Telegram

   En la app de Telegram (móvil, escritorio o web), busca @BotFather y abre el chat. Toca Iniciar si es tu primera vez.

   Atención

   Asegúrate de que la cuenta tenga la palomita azul de verificación junto a @BotFather: existen copias de phishing. Nunca pegues un token en algo que no sea el BotFather real.

2. Envía /newbot

   Envía el comando /newbot. BotFather te pide el nombre para mostrar del bot —el nombre que los usuarios ven en su lista de chats (p. ej. MyShop Assistant). Envíalo.

3. Elige un nombre de usuario

   BotFather te pide entonces un nombre de usuario. Debe ser único a nivel global en Telegram y terminar en bot (p. ej. MyShop_Assistant_bot). Si el que quieres está ocupado, BotFather te pide otro.

4. Copia el token del bot

   BotFather confirma que el bot fue creado y muestra el token: una cadena larga como 123456789:AAH1abcde-FGH… (un prefijo numérico, dos puntos, y luego un secreto alfanumérico). Copia todo, ambas partes incluyendo los dos puntos.

   Atención

   Trata el token como una contraseña. No lo captures en pantalla, no lo pegues en un chat y nunca lo subas a un repositorio de código: GitHub y otros escáneres de secretos detectan los tokens de bot de Telegram automáticamente. Si alguna vez se filtra, rótalo (ve las preguntas frecuentes abajo).

5. Configura el perfil del bot (opcional)

   Mientras estás en BotFather puedes enviar /mybots → elige tu bot → Bot Settings para agregar una Descripción (se muestra en el estado de chat vacío), un Acerca de (una frase breve) y una Foto de perfil (p. ej. tu logo). Todo opcional, todo cambiable después, y nada de esto bloquea la conexión con IcloneU.

Conectar el bot

Con el token copiado, el lado de IcloneU toma alrededor de un minuto. Lo único que hay que entender es que es una comprobación en dos pasos: Verificar token confirma que el token es válido y te dice a qué bot pertenece, y luego Conectar registra el webhook de IcloneU con Telegram y crea la Conexión.

1. Inicia una nueva conexión de Telegram

   Abre Conexiones en la barra lateral izquierda, haz clic en Nueva conexión y elige Telegram. Se abre el cuadro Conectar Bot de Telegram, que explica «Estás a punto de conectar tu bot de Telegram con la aplicación IcloneU.» También trae un enlace de ayuda —«¿Necesitas ayuda para crear un bot?» → «Consulta la Guía de bot de Telegram»— que apunta de vuelta a la creación del bot.

2. Pega el token del bot

   Pega el token completo en el campo etiquetado «Ingresa el token de tu bot de Telegram...»: ambas partes, incluidos los dos puntos (p. ej. 123456789:AAH1abc…).

   Atención

   Hazlo en un dispositivo de confianza. Trata el pegado del token exactamente como el pegado de una contraseña: cierra el cuadro antes de alejarte.

3. Verifica el token

   Haz clic en Verificar token. IcloneU valida el token y resuelve el bot, y luego confirma textualmente: «El token que ingresaste es válido y pertenece al bot <bot_username>. ¿Te gustaría que IcloneU se conecte a este bot?» Esta es tu oportunidad de confirmar que pegaste el token del bot correcto antes de comprometerte.

4. Conecta

   Haz clic en Conectar. IcloneU registra un webhook para los mensajes entrantes y crea la Conexión de inmediato. El panel de configuración por Conexión («Opciones para la cuenta <bot>») se abre automáticamente, con el Clon más antiguo de tu cuenta ya asignado en el menú de Clon.

Tras conectar, la Conexión de Telegram aparece en la página de Conexiones identificada por el nombre de usuario del bot con un indicador de estado activo. Verifica que funcionó escribiéndole al bot desde una cuenta de Telegram y viendo el mensaje llegar a la superficie de Mensajes en segundos.

Asignar un Clon y habilitarlo

Conectar el bot también le asigna el Clon más antiguo de tu cuenta y enciende la Conexión, así que el bot responde mensajes reales desde el momento en que haces clic en Conectar: el panel de configuración que se abre justo después sirve para cambiar eso, no para terminar la configuración. Puedes reabrirlo en cualquier momento seleccionando la fila de la Conexión y haciendo clic en Configuración.

1. Elige el Clon

   En el panel de configuración, elige el Clon en el menú Clon —«El clon que responderá en nombre de esta integración.» Aquí ya está asignado el Clon más antiguo de tu cuenta; confirma que sea el que quieres.

2. Revisa que esté Habilitada

   El interruptor Habilitada controla si tu Clon y tus flujos responden —«Si la apagas, los mensajes y comentarios entrantes de esta cuenta se ignoran. Los tokens se conservan para que puedas volver a activarla sin reconectar.» En una Conexión nueva de Telegram ya viene encendido; apágalo y guarda si el bot todavía no debe responder (el propio bot sigue enviando sus respuestas integradas, como la bienvenida a /start, «¡Te damos la bienvenida!» en español).

3. Guarda

   Haz clic en Guardar para conservar cualquier cambio que hayas hecho aquí.

   Nota

   Cancelar solo descarta los cambios de esta visita: el Clon asignado al conectar sigue asignado y el bot sigue respondiendo. A diferencia de Facebook, Instagram y YouTube, una Conexión de Telegram no espera a este panel para salir en vivo.

Para el recorrido completo de asignar y habilitar que aplica a todos los canales —incluidos los Tiempos de respuesta y cómo se relacionan Clones y Conexiones—, ve Asignando un Clon a una plataforma.

No hay ventana de 24 horas

Los canales de Meta (WhatsApp, Facebook Messenger, Instagram) imponen una ventana conversacional de 24 horas: tras el último mensaje de un cliente tienes 24 horas para responder libremente, y luego necesitas una plantilla aprobada. Telegram no tiene nada de esto. Una vez que un usuario le ha escrito a tu bot al menos una vez, el Clon puede responder en cualquier momento —días, semanas o meses después— hasta que el usuario bloquee al bot.

• Sin plantillas ni etiquetas de mensaje. No redactas plantillas de Utilidad / Marketing ni envías nada a aprobación de Telegram: simplemente respondes.
• Sin fallo por fuera de ventana. A un cliente que escribió al bot por última vez hace un año se le puede responder hoy; el envío tiene éxito.
• La regla de primer contacto es estricta. Ningún bot, integración o atajo de terceros te permite escribirle a un usuario de Telegram que nunca ha abierto un chat con el bot. El patrón estilo Meta de «enviar a un número de teléfono» no existe aquí.
• Los bloqueos son definitivos hasta que el usuario desbloquee. Si un usuario bloquea al bot, no hay forma de reanudar desde la API: tiene que desbloquear desde su propio cliente de Telegram.

Solución de problemas

Cuando un bot de Telegram se queda callado, empieza por revisar si el mensaje entrante del cliente llegó a IcloneU: abre la superficie de Mensajes y busca el chat. Dónde se detiene el mensaje te dice cuál mitad del flujo hay que arreglar.

El entrante nunca llega a IcloneU. Eso apunta a una Conexión apagada o sin Clon, al primer contacto, al token o al webhook:

• La Conexión está apagada o no tiene Clon: si su fila en la página de Conexiones dice Desactivado o Sin Clon, IcloneU no guarda nada de lo que recibe el bot y el Clon nunca responde: solo siguen saliendo las respuestas integradas del bot («¡Te damos la bienvenida!» a /start, un aviso de que solo procesa texto y voz cuando alguien manda otra cosa, como un sticker, una foto, un video o un archivo, y un aviso cuando no se puede descargar un mensaje de voz) y, en una Conexión sin Clon que sigue encendida, cualquier flujo vinculado a ella; y esos mensajes se pierden para siempre. Abre Configuración, elige un Clon si no hay ninguno, enciende Habilitada y haz clic en Guardar.
• El usuario nunca envió /start: un bot no puede escribirle a alguien que no le ha escrito primero. Pídele que abra t.me/<tu_bot> y toque Iniciar. Después de eso el bot puede responder en cualquier momento.
• El token que IcloneU tiene está obsoleto: si alguien rotó el token en BotFather, IcloneU está usando uno inválido y deja de recibir eventos. En BotFather envía /token, elige el bot y compáralo con el que tiene IcloneU; si difieren, vuelve a ingresar el nuevo token.
• Otra herramienta reclamó el webhook: Telegram permite un webhook por bot, así que una segunda integración roba los eventos en silencio. Desconecta y reconecta la Conexión de IcloneU para volver a registrar su webhook.
• El Panel marca el bot: la verificación de ESTADO DEL SISTEMA del Panel le pregunta a Telegram por el webhook de cada bot. Marca como fallida la fila del bot cuando el bot no tiene webhook, cuando Telegram está entregando sus mensajes a otra dirección, o cuando Telegram no pudo entregárselos a IcloneU en la última hora. En los dos primeros, vuelve a conectar el bot para volver a registrar el webhook; si falla la entrega, la fila muestra el último error de Telegram, que dice qué corregir. Mira Entiende tu panel.

El entrante aparece en Mensajes pero el Clon no responde. Primero descarta un flujo: cuando un mensaje inicia un flujo o responde a uno que espera respuesta, Mensajes muestra el mensaje pero no las respuestas del flujo, que hoy no aparecen ahí. Si no, es un problema del lado saliente:

• Ese usuario bloqueó al bot: si solo un usuario no recibe respuesta mientras otros sí, probablemente bloqueó al bot. No hay arreglo de tu lado; tiene que desbloquear.
• Se disparó el tope de tasa: si el bot estaba respondiendo en avalancha y luego se quedó callado, puede estar alcanzando el límite de 30/segundo entre usuarios o 1/segundo por chat y recibiendo errores HTTP 429.
• La revisión de DM está reteniendo la respuesta: si la «Revisión de mensajes directos» de esta conexión está en «Retener hasta aprobar», las respuestas de las categorías marcadas esperan tu aprobación en Mensajes y el cliente no recibe nada hasta que actúes; en Telegram una respuesta retenida nunca expira. Apruébala en Mensajes, o regresa el modo a «Enviar de inmediato».
• Configuración de Conocimiento: igual que en cualquier canal, «Responder solo desde la biblioteca» sin contenido que coincida (o una rigurosidad demasiado alta) puede silenciar respuestas por lo demás válidas.

Si ya recorriste todo lo anterior y un mensaje de prueba nuevo desde otra cuenta de Telegram sigue sin recibir respuesta, escala a soporte con el nombre de usuario del bot, el @usuario de la cuenta de prueba, la marca de tiempo de un entrante que no apareció, si es un chat 1:1 o de grupo, y capturas de la página de Conexiones y de la superficie de Mensajes.

Preguntas frecuentes