Tu bot de Telegram no contesta

Los mensajes no llegan a la bandeja, o llegan y nadie contesta. Dónde mirar primero, cómo se ve cada causa en la página del canal y en la conversación, y cómo arreglarlo.

Actualizado

Un bot callado tiene uno de dos problemas, y se ven diferentes:

  • Los mensajes no llegan. El mensaje del cliente nunca aparece en /conversations. Algo entre Telegram y Omni Octo se rompió.
  • Los mensajes llegan, y nadie contesta. El mensaje está en el hilo, y no sigue ninguna respuesta. Algo decidió que el agente no debía contestar.

Mándale un mensaje a tu bot desde tu propio Telegram, abre /conversations, y ya sabes cuál de los dos tienes.

Los mensajes no llegan

Abre el canal en /channels y primero mira su estado.

Lo que vesLa causaLa solución
Estado Error, y Información de la plataforma muestra un validationErrorLa última revisión falló: el motivo está escrito ahíArregla lo que dice, y luego pulsa Validar. Conecta tu bot de Telegram explica cada motivo.
Estado Activa, pero revocaste o cambiaste el token en BotFatherA Omni Octo no le avisan cuando un token se revoca; se entera en la siguiente revisiónActualizar credenciales, pega el token nuevo, Guardar y validar.
Estado Activa, y el bot también estaba configurado en otra herramientaTelegram envía los mensajes de un bot a un solo lugar. La otra herramienta se los llevóDeja de usar el bot ahí, luego Actualizar credenciales, pega el mismo token, y Guardar y validar. Eso apunta al bot de vuelta a Omni Octo.
Estado PendienteEl token se guardó y nunca se revisóValidar.
El cliente editó su mensajeLas ediciones no llegan como mensajes nuevosNada que arreglar: el mensaje original es el que llegó.
El mensaje se envió en un grupoTelegram le muestra a un bot solo algunos mensajes de grupo de forma predeterminadaVe grupos.

Actualizar credenciales con el mismo token también es la solución para un bot que se conectó antes de que Omni Octo empezara a registrar bots en Conectar y validar, si nunca ha recibido un mensaje: ejecuta ambos pasos otra vez.

La misma página del canal marcada Error, con Información de la plataforma mostrando validationError: Health check failed: 401: Unauthorized.
El motivo está en la página del canal, en Información de la plataforma.

Los mensajes llegan, y nadie contesta

Abre la conversación.

Lo que vesLa causaLa solución
”Aquí no responde ningún agente de IA. Tome el control para responder.”No hay agente en el botPonle uno — pon un agente en tu bot.
Estado Requiere atención humana, con “Alguien de su equipo tomó este chat, así que la IA está en pausa aquí.”Un compañero tomó el control del chatContéstalo, o pulsa Devolver a la IA ahora.
Sin aviso, sin respuesta, en todas las conversacionesEl agente está apagado, o el espacio de trabajo está pausado por facturaciónEnciende el agente desde su página; revisa la facturación en configuración.
La respuesta está en el hilo, marcada como fallidaTelegram se negó a entregarla — por ejemplo, el cliente bloqueó al botNada de tu lado; el cliente tiene que desbloquear al bot.

Cosas que parecen un problema y no lo son

  • El agente esperó unos segundos antes de contestar una foto. Espera hasta que pasen 5 segundos sin que llegue nada nuevo, para contestar a un álbum y su pregunta juntos — fotos, notas de voz y archivos.
  • Un archivo muestra ”… not available”. Pesaba más de 16 MB, o no se pudo descargar desde Telegram. El mensaje en sí llegó, y al agente se le avisó que un archivo no se pudo cargar.
  • Una conversación empieza con /start. Eso es lo que Telegram envía cuando un cliente pulsa Start. Llega como el primer mensaje del cliente, y el agente lo contesta como cualquier otro. Para que lo conteste con un saludo, dilo en las instrucciones del agente.

Adónde ir después