Cómo conectar un agente de IA a Telegram con Chiho

Conecta un agente de IA a Telegram conectando tu cuenta de Telegram en Chiho, añadiendo https://api.chiho.ai/mcp a un cliente MCP compatible y completando OAuth en el navegador. Después, verifica la cuenta y el alcance con auth_status antes de pedir al agente que lea una conversación seleccionada.

Esta guía cubre la conexión alojada de Chiho y la opción de entorno de ejecución local independiente. MCP proporciona herramientas; una habilidad proporciona instrucciones para flujos de trabajo. Instalar una habilidad no autoriza el acceso a tu cuenta de Telegram.

Nota de verificación — 8 de septiembre de 2026: Estas instrucciones se comprobaron frente a la implementación actual de Chiho, la ayuda local de comandos de Codex y la documentación de los clientes enlazada. Esta actualización no realizó una nueva configuración autenticada de un cliente ni leyó conversaciones de clientes. El ejercicio siguiente es una lista de comprobación de aceptación, no un informe de resultados observados en una cuenta. La imagen existente del encabezado ilustra la bandeja de entrada de Chiho, no una prueba de configuración de OAuth.

Elige la conexión que quieras operar

Chiho Cloud es la opción alojada para trabajar con Telegram y CRM. Tu cliente de IA se conecta al servicio MCP remoto de Chiho y te pide iniciar sesión y dar tu consentimiento en el navegador. Consulta la referencia de configuración de Telegram MCP junto con esta guía.

tgchats local es el entorno de ejecución local independiente de código abierto del repositorio de agentes de Telegram. Sigue las instrucciones actuales de instalación y operación de ese repositorio si quieres mantener el entorno local. Sus responsabilidades de configuración y almacenamiento difieren de las de la conexión alojada; un inicio de sesión correcto en la nube no valida un entorno de ejecución local.

Si todavía estás decidiendo qué tipo de sistema necesitas, la guía de CRM de Telegram explica el flujo de trabajo de relaciones, mientras que CRM frente a bots y bandejas de entrada compartidas compara las opciones.

Antes de conectar: cuenta, cliente y conversación

Necesitas una cuenta de Chiho con Telegram conectado, un cliente que admita MCP HTTP remoto y OAuth en el navegador y una elección clara del contexto personal o de equipo. Selecciona para el primer ejercicio una conversación que estés autorizado a consultar. Evita empezar con toda la bandeja de entrada o con una solicitud de envío de mensajes.

Revisa el tratamiento de datos de tu cliente de IA y las normas de tu organización antes de permitir que recupere contenido de las conversaciones. Chiho mantiene la sesión de Telegram alojada dentro de su servicio, pero la información devuelta por las herramientas se proporciona al cliente de IA conectado. Consulta la política de privacidad de Chiho para conocer sus condiciones publicadas de tratamiento de datos.

Utiliza el recurso de producción exactamente como se muestra arriba. El recurso de staging sirve para pruebas aisladas previas a producción; las concesiones de producción y staging no son intercambiables.

Conecta el servicio MCP alojado

Codex

Ejecuta estos comandos en una terminal donde esté instalado Codex:

codex mcp add chiho --url https://api.chiho.ai/mcp
codex mcp login chiho

El segundo comando inicia la autorización en el navegador. Después de dar tu consentimiento, vuelve a la interfaz de Codex que utilice esa configuración guardada y solicita auth_status. Si el servidor no aparece, comprueba si esa interfaz utiliza la misma configuración que tu terminal. Consulta la referencia de configuración de clientes de Chiho para conocer el endpoint alojado y el contexto de configuración.

Claude Code

Añade el servidor HTTP remoto:

claude mcp add --scope user --transport http chiho https://api.chiho.ai/mcp

En Claude Code, abre /mcp y completa la autenticación de Chiho. Después, solicita auth_status. La documentación de MCP de Anthropic explica la configuración y autenticación de HTTP remoto. Los controles del cliente y las funciones de conexión disponibles pueden variar; consulta la documentación de la versión que utilices.

Otros clientes compatibles

Utiliza el flujo del cliente para conexiones MCP remotas personalizadas con la misma URL de producción. Para el flujo OAuth de cliente público de Chiho, deja vacíos los campos opcionales de ID de cliente y secreto, salvo que soporte haya proporcionado credenciales para una implementación administrada. Completa el consentimiento en el navegador en lugar de copiar un token de portador en un archivo de configuración.

Chiho está disponible en el catálogo de plugins de ChatGPT. Instala el plugin en ChatGPT o Codex y completa la autorización en el navegador desde ese cliente. Una configuración local de Codex no instala el plugin en ChatGPT web.

Que un cliente pueda acceder al servidor no significa que haya completado la autorización. No tomes el icono de transporte conectado como prueba de que la cuenta de Telegram prevista está disponible.

Lee la pantalla de consentimiento como una decisión de acceso

Comprueba la identidad del cliente, el host de redirección, la cuenta de Chiho, el alcance personal o de equipo y el conjunto completo de permisos antes de dar tu consentimiento. La concesión interactiva de Chiho incluye capacidades de lectura y escritura compatibles; empezar con una solicitud de solo lectura no convierte la concesión en una de solo lectura.

Las concesiones de equipo restringen las herramientas a las cuentas y conversaciones visibles para ese equipo. La búsqueda de mensajes de equipo requiere un chat específico y las operaciones personales de carpetas y cierre de sesión para toda la cuenta no se ofrecen en el contexto de equipo. Por tanto, la ausencia de una conversación puede deberse a un límite de acceso y no a una conexión rota.

Las solicitudes de confirmación de herramientas del cliente y las salvaguardas de ejecución de Chiho son controles independientes. Revisa ambos antes de ampliar el trabajo más allá de las lecturas:

• Existen escrituras directas. El envío de mensajes individuales, las etiquetas de CRM, las tareas, las reglas de automatización, las operaciones de carpetas, la actualización de resúmenes y el cierre de sesión de cuentas pueden ejecutarse después de los controles aplicables del cliente y las comprobaciones del servidor. Una herramienta llamada message_send_draft envía un mensaje; no deduzcas que solo guarda un borrador.
• La aprobación de la bandeja de salida depende de la operación. Las vistas previas con varios destinatarios requieren aprobación. Una vista previa de la bandeja de salida con un solo destinatario también la requiere cuando la conexión utiliza el modo de preguntar siempre.
• Las invitaciones de miembros y las salidas de grupos requieren vistas previas almacenadas y aprobación antes de ejecutarse.
• Crear una vista previa no equivale a enviar, pero una vista previa puede guardar el estado de aprobación. No es una herramienta adecuada para un ejercicio de aceptación estrictamente de solo lectura.

Una frase como «no envíes» ayuda a definir la tarea, pero no sustituye los permisos de las herramientas. Del mismo modo, instalar una habilidad de flujo de trabajo no cambia la concesión. Revisa cualquier habilidad que cree tareas o actualice resúmenes como un flujo de trabajo que contiene escrituras.

Realiza un ejercicio de aceptación de solo lectura

Utiliza esta solicitud de ejemplo después de la autorización. Sustituye la descripción por la conversación autorizada que hayas seleccionado:

Primero llama a auth_status y confirma la cuenta conectada y el contexto personal o de equipo. Localiza la conversación que seleccioné y pídeme que resuelva cualquier coincidencia ambigua. Lee únicamente sus mensajes recientes. Enumera las preguntas pendientes, los compromisos explícitos y los puntos poco claros, con referencias a mensajes para cada uno. Indica el intervalo de tiempo y los límites de paginación. No envíes mensajes, crees tareas, cambies campos del CRM, actualices resúmenes, inicies sincronizaciones ni prepares vistas previas de escritura.

Comprueba tú mismo el resultado frente a la conversación:

1. Identidad: la cuenta y el alcance devueltos coinciden con el contexto que pretendías utilizar. Detente si no coinciden.
2. Destino: la conversación seleccionada es correcta. Los títulos similares requieren aclaración, no adivinar el destinatario.
3. Cobertura: el agente indica qué ha leído. Una página de diálogos o mensajes no demuestra que se haya leído el historial completo; continúa la paginación solo si es necesario y está autorizado.
4. Fundamento: cada compromiso o pregunta pendiente que se afirme tiene mensajes que lo respaldan. La información ausente sigue siendo desconocida, en lugar de convertirse en un plazo o responsable inventado.
5. Efectos: el historial de herramientas contiene únicamente las lecturas previstas. Un resumen escrito útil en la conversación con la IA no requiere guardar un resumen en el CRM ni crear una tarea.

Por ejemplo, en un intercambio ficticio en el que un cliente pide una propuesta y un compañero dice «la enviaré el viernes», una respuesta útil distingue la pregunta del cliente del compromiso del compañero. No debe afirmar que la propuesta se envió sin un mensaje que lo respalde. Este es un caso ilustrativo de evaluación, no evidencia de clientes ni un resultado medido.

Registra tu cliente y versión, la fecha de comprobación, el contexto de cuenta sin identificadores privados, las herramientas utilizadas y si cada una de las cinco comprobaciones se superó o falló. No incluyas tokens ni mensajes privados en un registro de pruebas compartido. Amplía el flujo de trabajo únicamente cuando este pequeño ejercicio se comporte como se espera.

Identifica el paso que falló

La autorización nunca se completa: vuelve a comprobar la URL remota exacta, termina el consentimiento en el navegador y confirma que estás iniciando sesión en el entorno de Chiho previsto. Una conexión revocada requiere un nuevo consentimiento. Elimina las credenciales y el contenido privado antes de compartir un error con soporte.

La autorización funciona, pero faltan conversaciones: comprueba la conexión de Telegram en Chiho, la cuenta seleccionada y los límites de equipo de la concesión. Compara inventarios equivalentes: dialogs_list pagina los diálogos de Telegram; crm_dialogs_list pagina el inventario persistido del CRM de Chiho. La cantidad de elementos de una página devuelta no es el total de la cuenta y ninguna de las listas es un recuento de contactos de la agenda.

Solo se resume una parte del historial: pide al agente que informe del intervalo solicitado, el devuelto y el estado de continuación. No permitas que describa una lectura parcial como una auditoría de toda la bandeja de entrada.

Telegram pide al sistema que espere: respeta la información de espera y reintento devuelta. La sincronización duradera de Chiho puede informar de waiting_for_telegram con una hora de reanudación. Reiniciar el trabajo repetidamente no elimina los límites de Telegram y esta guía no promete una capacidad de procesamiento ilimitada.

Falta una herramienta o se rechaza una escritura: comprueba la lista de herramientas autenticadas, el alcance, los controles del cliente y cualquier estado de vista previa o aprobación necesario. No amplíes el acceso solo para hacer desaparecer el error. Vuelve a la acción mínima que realmente requiere tu flujo de trabajo.

Revoca el acceso y elige el siguiente flujo de trabajo

Abre Clientes de IA conectados en Chiho para inspeccionar el cliente y el alcance. Revoca la conexión cuando ya no la necesites; Chiho invalida sus tokens de acceso y actualización, y reconectarse requiere volver a dar consentimiento. Eliminar el servidor de la configuración del cliente de IA es un paso de mantenimiento independiente. La revocación no puede retirar contenido que ya se haya devuelto a ese cliente.

Para trabajos controlados sin supervisión, consulta la guía avanzada de tokens de servicio. Los tokens de servicio no son el flujo habitual de incorporación interactiva y no deben aparecer en capturas de pantalla, configuraciones compartidas ni mensajes de soporte.

Después del ejercicio de solo lectura, elige un flujo de trabajo acotado: identifica compromisos con la habilidad de tareas de seguimiento u organiza una conversación con la habilidad de evaluación de clientes potenciales. Revisa las escrituras de la habilidad antes de ejecutarla. La guía de seguimiento por prioridad explica cómo las tareas y los mensajes a clientes cumplen funciones diferentes.

Conecta Telegram en Chiho, completa la autorización en el navegador y verifica una conversación seleccionada antes de asignar un trabajo más amplio a un agente.