Telegram

Objetivo

Conecta un bot de Telegram para que un agent de IA responda tus conversaciones de Telegram. Telegram es el único canal social que no necesita Meta App Review ni OAuth: creas un bot con @BotFather y pegas su token. El webhook se registra por ti automáticamente, y los tokens se guardan cifrados y no se muestran de nuevo.

Acceso

Sidebar -> Messaging -> Telegram Rutas:

• /app/{tenant}/telegram (conectar y gestionar bots)
• /app/{tenant}/telegram/conversations (conversaciones de Telegram)

Roles

• owner, admin, agent

Disponibilidad y requisitos previos

• Acceso anticipado: el módulo de Telegram se libera de forma gradual, así que algunos workspaces aún no lo verán. (A diferencia de Instagram y Messenger, Telegram no necesita Meta App Review.)
• Tu plan debe incluir Telegram; se pueden añadir espacios de bot con el Social Accounts Pack.
• Al menos un agent para asignar.
• Un email verificado (un workspace sin verificar no puede conectar un canal).

Conectar un bot

1. En Telegram, abre @BotFather, crea un bot y copia su token.
2. En el módulo de Telegram, pulsa Connect bot.
3. Completa el modal (Connect Telegram bot):

El token se valida, el @username del bot se lee desde Telegram, y el webhook se registra automáticamente. Si el paso del webhook falla, el bot se guarda como no verificado con "The bot was saved but the webhook could not be registered. Save again to retry." — solo guarda de nuevo para reintentar.

Gestionar bots conectados

Cada bot conectado aparece como una tarjeta que muestra su @username (con el Bot ID numérico), un interruptor activo/inactivo y un selector de agent/team en línea. Expande la fila para ver el interruptor Accept attachments y el Bot ID; el menú de acciones tiene Edit y Disconnect.

Insignias de estado que puedes ver: Solo / Team, Webhook pending, Needs reconnection, Linked agent inactive y Paused by plan limit.

Notas:

• La política Accept attachments se guarda en el agent vinculado, así que es por agent y queda deshabilitada hasta asignar uno.
• Quitar el agent desactiva automáticamente el bot ("Select an agent to start replying.").

Editar y reconectar

• Edit abre el mismo modal titulado "Edit Telegram bot". El bot token es opcional aquí — déjalo en blanco para conservar el token actual.
• Si un token se revoca, el bot muestra Needs reconnection con "The bot token was revoked or is no longer valid. Paste a new token to reconnect." Pega un token nuevo de @BotFather y pulsa Reconnect.

Desconectar

Disconnect pide confirmar: "Disconnect {name}? Your agent will stop replying to its Telegram conversations. This cannot be undone." Quita el webhook y elimina la conexión permanentemente.

Límites del plan

• Una línea de uso muestra "N active bots of M" (o ilimitado).
• Sin el permiso ves "Telegram is not in your plan" con un enlace View plans.
• Los límites se aplican al conectar y al activar un bot; alcanzar un límite abre un diálogo de mejora. El Social Accounts Pack añade un espacio de bot por unidad sobre tu plan.

Conversaciones

Usa View conversations (o el sidebar) para llegar a /app/{tenant}/telegram/conversations. Las conversaciones muestran estado (AI active / Human / Escalated), una marca "Needs attention" y avisos de opt-out. La vista de detalle admite Take over / Hand back to AI, un redactor de respuesta y una insignia Team-assisted cuando ayudó un equipo. Estas conversaciones también aparecen en la bandeja unificada en /app/{tenant}/conversations.

Buenas prácticas

• Asigna el agent antes de activar el bot; un bot sin agent no puede ponerse activo.
• Si las respuestas se detienen, busca una insignia Needs reconnection y pega un token nuevo.
• Mantén Accept attachments activado si los clientes envían fotos o notas de voz que quieres que el agent maneje.