# Telegram (Beta) Conecta tu cuenta de Telegram existente a la plataforma para que tus conversaciones de Telegram fluyan directamente a la aplicación y un agente de IA pueda responder. Te conectas introduciendo tu número de teléfono y un código de inicio de sesión, de la misma forma que añadirías Telegram en un dispositivo nuevo. > **Beta.** Telegram ya está disponible para todos, pero sigue siendo nuevo; es posible que encuentres algún detalle por pulir mientras lo perfeccionamos. Si algo no funciona como se describe, infórmalo al equipo de soporte. --- ## ¿Qué es la integración de Telegram? La integración de Telegram vincula tu cuenta personal de Telegram a la plataforma utilizando el propio flujo de inicio de sesión de Telegram. No hay ningún bot que crear ni ningún número de teléfono independiente que comprar: inicias sesión con la cuenta de Telegram que ya utilizas y tus chats individuales pasan a estar disponibles dentro de la aplicación. Esto es ideal para empresas que ya hablan con sus clientes en Telegram y desean añadir un agente de IA, difusiones y una bandeja de entrada compartida a su cuenta existente. > **Importante: lee esto antes de conectarte.** Esta es una integración **no oficial** que automatiza una **cuenta personal de Telegram**. Las normas de Telegram desaconsejan la automatización y el envío de mensajes masivos o no solicitados, y las cuentas que infrinjan esas normas pueden ser **restringidas o bloqueadas permanentemente** (en algunos casos, el propio número de teléfono puede quedar bloqueado para volver a registrarse). Utiliza este canal únicamente para enviar mensajes a personas que **ya te hayan contactado o sean contactos guardados**, mantén un volumen bajo y deja que la IA responda a un ritmo natural. **No** lo utilices para envíos masivos en frío. --- ## Telegram frente a WhatsApp Web Ambos conectan una cuenta que ya posees, sin necesidad de una API empresarial oficial. | Función | Telegram | WhatsApp Web | |---|---|---| | **Configuración** | Introducir número de teléfono + código de inicio de sesión | Vincular tu teléfono (código QR o código de vinculación) | | **Tipo de cuenta** | Tu cuenta personal de Telegram | Tu WhatsApp personal/de empresa | | **Coste por mensaje** | Gratuito | Gratuito | | **Mensajes de plantilla** | No aplicable | No compatible | | **Indicadores de escritura** | Compatible | Compatible | | **Multimedia (entrada)** | Fotos, documentos, notas de voz | Fotos, documentos, notas de voz | | **Soporte oficial** | Integración no oficial | Integración no oficial | | **Ideal para** | Empresas ya activas en Telegram, contactos existentes/cálidos | Empresas en WhatsApp, inicio rápido | > **¿El mismo número en ambos?** Sí. Si el mismo número de teléfono está tanto en Telegram como en WhatsApp (Web), puedes conectarlo como **ambos** canales; funcionan como dos conexiones independientes en la página de Canales, cada una con su propio estado, calentamiento y límites. Conectar uno no afecta ni reemplaza al otro. --- ## Configuración de Telegram ### Paso 1: Abrir el flujo de conexión 1. En la barra lateral izquierda, haz clic en **Settings** cerca de la parte inferior. 2. En el panel izquierdo de Settings, bajo **Channels**, haz clic en **Channels**. 3. Busca la tarjeta **Telegram** —que lleva un aviso de **Beta**— y haz clic en **Connect**. ### Paso 2: Introduce tu número de teléfono 1. Escribe el número de teléfono de la cuenta de Telegram que deseas conectar, incluyendo el código de país (por ejemplo `555 123 4567`). 2. Activa **Importar chats existentes** si deseas traer tus conversaciones individuales recientes de Telegram como contactos, para no empezar con una bandeja de entrada vacía. (Al activar esto también puedes controlar **Mantener IA en pausa para chats importados** — recomendado, y activado por defecto, para que la importación de tu historial nunca active respuestas automáticas a mensajes antiguos. Desactívalo por contacto más tarde cuando estés listo). 3. Haz clic en **Enviar código de inicio de sesión**. 4. Telegram envía un código de inicio de sesión **a tu aplicación de Telegram** (normalmente llega como un mensaje del chat oficial del servicio "Telegram", no siempre como un SMS). ### Paso 3: Introduce el código de inicio de sesión 1. Abre Telegram en tu teléfono. 2. Lee el código de inicio de sesión del chat de servicio de **Telegram**. 3. Escribe el código en la aplicación. 4. Haz clic en **Verify Code**. > **El código caduca rápidamente.** Ten tu teléfono a mano antes de hacer clic en **Send Login Code** e introduce el código rápidamente. Si caduca, inicia la conexión de nuevo para obtener uno nuevo. ### Paso 4: Contraseña de dos factores (si tienes una) Si tu cuenta de Telegram tiene activada la **verificación en dos pasos**, la aplicación te pedirá tu **contraseña de 2FA** después del código. Introdúcela y haz clic en **Verify Password**. Tu contraseña se utiliza únicamente para completar el inicio de sesión seguro y nunca se almacena en formato legible. Una vez verificado, tu cuenta aparecerá en la página Channels como **Connected**. Tus conversaciones de Telegram ya son accesibles a través de la plataforma, y un agente de IA asignado a este canal puede responder a los mensajes entrantes. ### Importación de sus chats existentes Si activaste **Import existing chats** en el Paso 2: - Solo se importan los chats privados (uno a uno) recientes. Los chats grupales no se incluyen, y solo se extrae una cantidad limitada del historial reciente por chat. - La importación se ejecuta una vez, en segundo plano, justo después de conectarse. En cuentas más grandes, puede tardar un poco en aparecer todo. - Los mensajes importados completan la conversación en Chats, pero no cuentan para los números o gráficos de su [Dashboard](../get-started/dashboard.md). Allí solo se mide lo que envía y recibe después de conectarse. Si se conecta sin importar, las nuevas conversaciones seguirán llegando normalmente a partir de ese momento; solo se omitirá el historial más antiguo. --- ## Gestión de sesiones ### Comprobación del estado de la conexión El estado de tu conexión de Telegram se muestra en la tarjeta **Telegram** en la página **Channels**: | Estado | Significado | |---|---| | **Conectado** | Activo y enviando/recibiendo mensajes | | **Código enviado** | Esperando a que introduzcas el código de inicio de sesión | | **Verificación en dos pasos requerida** | Esperando tu contraseña de verificación en dos pasos | | **No conectado** | Sin sesión activa | ### Reconexión Si tu sesión se interrumpe, abre **Ajustes → Canales → Canales**, busca la tarjeta de Telegram y utiliza su acción de conectar/gestionar. Si la sesión no se puede restaurar automáticamente (por ejemplo, porque la cerraste desde tu teléfono), se te pedirá que inicies sesión de nuevo con un código nuevo. ### Desconexión Abre la tarjeta de **Telegram** y haz clic en **Desconectar**. Esto cerrará la sesión de la plataforma en tu cuenta de Telegram y eliminará la sesión. También puedes cerrarla desde el propio Telegram: **Ajustes → Dispositivos → Sesiones activas**, y luego termina la sesión de la plataforma. --- ## Mantenerse seguro en Telegram Debido a que esto automatiza una cuenta personal, protegerla de bloqueos es su responsabilidad. La plataforma regula la IA y los envíos salientes para que parezcan naturales, pero siga estas prácticas: - **Envía mensajes solo a contactos conocidos o frecuentes.** Responde a personas que te hayan escrito primero o que sean contactos guardados. Evita enviar mensajes a desconocidos de forma masiva; esa es la forma más rápida de activar el filtro de spam de Telegram. - **Mantén los volúmenes bajos**, especialmente en una cuenta recién conectada. Aumenta el ritmo lentamente a lo largo de los días, no todo de golpe. - **Evita enviar enlaces a personas que no te conocen**; los mensajes llenos de enlaces a desconocidos son un motivo común de bloqueo. - **Deja que la IA responda a un ritmo natural.** Los retrasos integrados y el indicador de escritura están ahí para mantener la conversación con un toque humano; no intentes evitarlos. - **Usa un número real que controles.** Los números desechables o virtuales (VoIP, un número de teléfono basado en internet, no una tarjeta SIM física) tienen muchas más probabilidades de ser marcados. > **Advertencia.** Si Telegram marca la cuenta por spam, el envío se detiene hasta que el comportamiento cambie; esperar por sí solo no soluciona el problema. Las infracciones repetidas pueden bloquear permanentemente la cuenta y su número de teléfono. --- ## Límites de envío, calentamiento y controles de seguimiento Telegram utiliza los mismos límites de envío protectores, calentamiento automático y el interruptor de seguridad para seguimientos por cuenta que WhatsApp Web. Estos existen para evitar que una cuenta personal parezca una granja de spam y sea marcada. En la página de **Canales**, una vez que tu cuenta de Telegram esté conectada, verás: - Una tarjeta de **Límites de envío y calentamiento** con los mismos medidores que WhatsApp Web: mensajes enviados hoy, nuevos contactos hoy y el día actual de calentamiento. - Un interruptor de **Seguimientos automatizados**: se activa **por defecto** para un número recién conectado, así que desactívelo usted mismo mientras el número aún se está calentando. Permanece interactivo en todo momento, pero muestra qué puertas de calentamiento (antigüedad del número, aumento de actividad, interacción reciente con contactos) aún no se han superado. ### Calentamiento automático (rampa) Una cuenta de Telegram recién conectada está limitada intencionalmente y desbloquea más capacidad con el tiempo. La cuenta obtiene un "día de calificación" solo en los días en que realmente envía al menos el 75% de su límite actual; los días de inactividad no cuentan, por lo que la cuenta no puede avanzar sin un uso real y constante. - **Límite diario de mensajes** = `50 + 8 × (day − 1)`, con un tope de **500/día** (alcanzado en el día 58). - **Límite diario de nuevos contactos** = `floor((day − 1) × 5 / 6)` (redondeado hacia abajo al número entero más cercano), con un tope de **50/día** (alcanzado en el día 61). Por lo tanto, en una cuenta nueva comienzas con 50 mensajes/día y 0 nuevos contactos/día, subiendo hasta el límite máximo en aproximadamente dos meses. La página de Canales muestra el día actual, el uso de hoy frente al límite y cuánto falta para alcanzarlo. ::: tip **Consejo:** Si conectas una cuenta que **ya** tiene meses de historial genuino en Telegram, el panel de aumento te permite adelantar el día de calentamiento para que los límites se levanten inmediatamente. Usa esto con honestidad; solo para cuentas que realmente tengan un historial orgánico. Una cuenta nueva que se salta el calentamiento tiene muchas más probabilidades de ser bloqueada. ::: ### Anulación manual más allá de la rampa Una vez que una cuenta ha terminado la rampa completa de 58 días, una anulación opcional te permite aumentar el límite diario de mensajes por encima de 500 (desde 750 hasta 5,000, en incrementos de 250 mensajes). No existe un número "seguro" publicado para Telegram; mantente conservador, vigila las señales de spam y retrocede en el momento en que veas problemas. La anulación solo está disponible en cuentas completamente calentadas; una cuenta nueva no puede saltarse el calentamiento de esta manera. ### Interruptor de desactivación de seguimiento por cuenta El interruptor de **Seguimientos automatizados** controla solo esta cuenta. Cuando está desactivado, **no se envía ningún tipo de seguimiento automatizado** desde esa cuenta, independientemente de tus ajustes de difusión o campaña. En una cuenta nueva (con menos de unos 30 días de aumento), lo más seguro es dejar los seguimientos desactivados y enviar solo la respuesta inicial; los seguimientos son lo que más a menudo hace que una cuenta de baja confianza sea clasificada como "esto es un bot". Vuelve a activarlo una vez que la cuenta esté caliente y estable. Cuando se alcanza el límite diario de mensajes, los seguimientos programados se trasladan automáticamente al día siguiente en lugar de fallar. --- ## Mensajes multimedia Las fotos, documentos y notas de voz entrantes se introducen en el chat para que la IA pueda entenderlos (las notas de voz se transcriben automáticamente). Las respuestas salientes de la IA son **solo texto** en esta versión. Las respuestas largas se recortan automáticamente al límite de 4096 caracteres de Telegram. --- ## Leer estado en tu teléfono Cuando la IA responde a un chat de Telegram, o tú abres ese chat en Chats, el chat también se marca como leído en tu propia aplicación de Telegram, por lo que el indicador de mensajes no leídos de tu teléfono se mantiene sincronizado en lugar de acumular cientos de chats sin leer. Los chats que el bot **no** responde (por ejemplo, cuando está desactivado, fuera de su horario activo o decidió no responder) se dejan **sin leer** a propósito, para que puedas verlos y gestionarlos tú mismo. --- ## Limitaciones - **Solo chats personales 1 a 1.** Los mensajes de grupos y canales no se gestionan en esta versión. - **Sin botones integrados.** Los menús de botones interactivos no son compatibles. - **Envío solo de texto.** La IA responde con texto; el envío de archivos multimedia está previsto para una actualización posterior. - **Integración no oficial.** Se basa en el inicio de sesión del cliente de Telegram y no está respaldada por Telegram; los cambios en la plataforma por su parte pueden afectarla. - **Riesgo de la cuenta.** La automatización excesiva o no solicitada puede hacer que la cuenta sea restringida o bloqueada; sigue las directrices de seguridad anteriores. --- ## Solución de problemas ### El código de inicio de sesión nunca llega - Compruebe el chat de servicio de **Telegram** dentro de la aplicación de Telegram; el código suele enviarse allí, no por SMS. - Asegúrese de haber introducido el número de teléfono con el código de país correcto. - Telegram limita los códigos para cuentas/números que considera sospechosos. Espere unos minutos e inténtelo de nuevo. ### "Código caducado" o "Código no válido" - El código solo es válido por un breve periodo. Inicie la conexión de nuevo para solicitar uno nuevo e introdúzcalo rápidamente. ### Se solicita una contraseña inesperadamente - Tu cuenta tiene activada la verificación en dos pasos. Introduce tu contraseña de Telegram para terminar de iniciar sesión. Si la has olvidado, restablécela desde **Ajustes → Privacidad y seguridad → Verificación en dos pasos** en Telegram. ### Los mensajes no se envían - Verifique que el estado de la conexión indique **Conectado** en la página de Canales. - Confirme que el contacto sea alguien a quien pueda enviar mensajes en Telegram. - Si la cuenta fue marcada recientemente por spam, reduzca el volumen y limítese a los contactos existentes. ### Sesión de cuenta cerrada - Tu sesión ha finalizado (por ti, desde otro dispositivo o por Telegram). Ve a **Ajustes → Canales → Canales**, haz clic en **Desconectar** y vuelve a iniciar sesión. --- ## Mejores prácticas - **Conecte una cuenta que ya hable con clientes en Telegram**, no una nueva cuenta desechable. - **Comience con un volumen de automatización bajo** y auméntelo gradualmente. - **Responda a contactos entrantes y conocidos** en lugar de enviar mensajes en frío a desconocidos. - **Mantenga su cuenta saludable**: un número real, un uso normal y un ritmo conservador reducen drásticamente el riesgo de bloqueo.