Conectar un bot toma su token y nada más. Primero necesitas tener el bot creado — lo que Telegram exige cubre BotFather — y después es un solo formulario.
Conéctalo
-
Abre /channels y pulsa Agregar canal.
-
Elige Telegram. La página que se abre es Conectar Telegram, con los tres pasos de BotFather debajo, en Cómo obtener sus credenciales:
Abra Telegram y busque @BotFather Envíe /newbot y siga las indicaciones Copie el token del bot que le da BotFather
-
En Credenciales, llena dos campos:
- Nombre del canal — ya viene lleno con “Telegram”. Déjalo, y el canal toma el nombre del bot cuando se conecta: Telegram — @BrightwaterBikesBot. O escribe el tuyo.
- Token del bot (de @BotFather) — pega el token.
-
Pulsa Conectar y validar.
¡El canal se conectó correctamente! Ya puede implementar un agente en este canal.
Desde ese momento, los mensajes que los clientes envían al bot llegan a Omni Octo. El siguiente paso es elegir quién los contesta — pon un agente en tu bot. Hasta que lo hagas, siguen llegando y esperan en /conversations a tu equipo.
Qué hace Conectar y validar
Dos cosas, en orden:
- Revisa el token con Telegram. Un token que funciona le dice a Omni Octo el @usuario y el nombre del bot.
- Le dice a Telegram que envíe los mensajes del bot a Omni Octo, con un secreto que solo Telegram y Omni Octo conocen. Cada mensaje que Telegram entrega lo lleva, y todo lo que llegue sin él se rechaza, así que nadie más puede meterle mensajes falsos de clientes a tu bandeja.
Si cualquiera de los dos pasos falla, la página dice La validación no se completó con el motivo. El canal igual se crea, marcado Error, y puedes arreglarlo desde su página.
| Lo que dice el motivo | Lo que significa |
|---|---|
| Health check failed: 401: Unauthorized | El token está mal, o lo revocaron en BotFather. Cópialo de nuevo — completo, incluida la parte antes de los dos puntos. |
| … is already connected to another Omni Octo channel | Este bot está conectado en otro lado. Telegram envía los mensajes de un bot a un solo lugar, así que primero elimina el otro canal, o crea un segundo bot. |
| The bot token works, but Telegram could not be told to send this bot’s messages here | El token está bien; Telegram no aceptó el segundo paso. Espera un minuto y pulsa Validar en la página del canal. |
La página del canal
Abre el canal desde /channels. Junto a su nombre están Telegram y su
estado — Activa cuando está conectado. En Información de la plataforma
encontrarás el botUsername y el botName del bot, tal como Telegram los
reportó, y en Agentes el agente que contesta aquí, cuando haya uno.
Validar aparece cuando el canal no figura como Activa. Ejecuta ambos pasos otra vez: úsalo después de arreglar lo que decía el motivo.
Cambiar el token
Si revocas el token en BotFather, o pasas a un bot nuevo:
- En la página del canal, pulsa Actualizar credenciales.
- Pega el token nuevo, y luego pulsa Guardar y validar.
Ambos pasos se ejecutan otra vez con el token nuevo, y a Telegram se le da un secreto nuevo. Un token nuevo para el mismo bot conserva las conversaciones que ya tienes. Un token para un bot diferente es un bot diferente para tus clientes: tendrán que encontrar y escribirle al nuevo.
Eliminar el canal
Eliminar en la página del canal quita el canal y saca a todos los agentes de él (los agentes en sí se conservan):
… y todas sus implementaciones se eliminarán de forma permanente. Esto no se puede deshacer.
El bot en sí sigue existiendo en Telegram, y los clientes pueden seguirle escribiendo, pero nadie contesta. Para conectarlo de nuevo, agrégalo como un canal nuevo.
Conectarlo pidiéndoselo a Octo
Octo puede hacer lo mismo desde una conversación. Dile qué quieres, con el token:
Conecta mi bot de Telegram y que lo atienda la recepcionista de Brightwater. El token es …Octo conecta el bot, le dice a Telegram adónde enviar sus mensajes y pone el agente en él, preguntando antes de los pasos que cambian lo que los clientes ven.
Adónde ir después
- Pon un agente en tu bot — elige qué agente de IA contesta.
- El bot de Telegram no contesta — qué revisar cuando los mensajes no llegan o nadie contesta.