Telegram

Hay dos formas de conectar tu AI Agent con Telegram:

1. Añadir a un grupo de Telegram: el flujo recomendado con un clic. Sin BotFather ni token de bot, en marcha en menos de un minuto.
2. Usa tu propio bot: el flujo avanzado en el que creas un bot con BotFather y proporcionas su token tú mismo.

Recomendamos el flujo con un clic. Puedes cambiar a tu propio bot más adelante si necesitas las funciones avanzadas.

Si te atascas, ve a Solución de problemas y FAQs o contáctanos.

Conectar con Telegram (recomendado)

En el panel de Quickchat AI, abre External Apps en la barra lateral izquierda, busca Telegram y ábrelo. Haz clic en Añadir a un grupo de Telegram.

Telegram se abre y te pregunta a qué grupo añadir el bot compartido Quickchat AI. Elige el grupo y confirma. Necesitas permiso para añadir miembros a ese grupo.

Confirma el grupo en el panel

De vuelta en el panel, el grupo aparece en Esperando tu confirmación. Haz clic en Confirmar junto a él.

Este paso es intencionado. La invitación se entrega como un mensaje normal en el grupo, que cualquiera de ese grupo puede leer, así que Quickchat AI no la toma como prueba por sí sola. Hasta que confirmes, el AI Agent permanece completamente en silencio en ese grupo. La entrada muestra quién añadió el bot, de modo que un grupo que no esperabas es fácil de detectar y eliminar en lugar de confirmarlo.

¡Eso es todo! 🎉 Tu AI Agent está en marcha en Telegram. Los miembros inician una conversación @mencionándolo en el grupo, o respondiendo a uno de sus mensajes.

Nota

El panel muestra una insignia Admin en los chats donde el bot es administrador de Telegram. Es un indicador de estado, no un requisito: el bot compartido responde sea administrador o no. La moderación, como silenciar y bloquear, se hace con AI Actions de Telegram, que necesitan tu propio bot y no el compartido.

Enlace de mensaje directo

Cada AI Agent también recibe un enlace personal que abre un chat individual con él en Telegram. En la página de Telegram, activa Enlace de mensaje directo y copia el enlace que aparece. Cualquiera que lo abra puede escribir a tu Agent en privado, y responde de inmediato sin paso de confirmación, porque un chat privado es entre una persona y el bot.

El enlace está desactivado por defecto. Desactívalo de nuevo cuando quieras para detener nuevos chats privados.

Gestionar tus chats

La página de Telegram lista todos los chats que atiende el bot compartido en Chats conectados. Desde ahí puedes:

• Añadir a otro grupo con el mismo flujo con un clic, para que un AI Agent atienda varios grupos.
• Desactivar un chat para pausar las respuestas ahí sin desconectarlo.
• Desconectar un chat. El bot sale de ese grupo y deja de responder, y puedes añadirlo de nuevo cuando quieras.

Un chat de Telegram puede estar conectado a un solo AI Agent a la vez. Si un grupo ya está conectado a otro Agent, desconéctalo ahí primero, o elige otro grupo.

Cuándo usar tu propio bot

El bot con un clic funciona con la identidad compartida Quickchat AI, lo cual es perfecto para ponerse en marcha rápido. Crea tu propio bot (ver más abajo) cuando quieras:

• Un nombre de bot, nombre de usuario y foto de perfil propios
• AI Actions de Telegram. El bot compartido no expone su token como el System Token {{telegram_bot_token}} que estas Actions necesitan, así que requieren tu propio bot.
• Un bot que responda a cada mensaje de un grupo en lugar de solo cuando se le habla

El bot compartido y tu propio bot pueden funcionar en paralelo, pero en grupos distintos. Mantenlos fuera del mismo grupo: son dos bots de Telegram separados con conexiones separadas, así que si tu propio bot tiene el modo privacidad desactivado responderá junto al compartido y los dos contestarán al mismo mensaje.

Usa tu propio bot (Configuración avanzada)

Crea tu bot de Telegram

Los bots de Telegram se crean a través de BotFather, el bot oficial de Telegram para gestionar bots. Todo ocurre dentro de un chat normal de Telegram, así que no hay ningún portal de desarrollador en el que registrarse.

1. Abre Telegram e inicia un chat con @BotFather (busca la marca de verificación azul).
2. Envía /newbot.
3. Elige un nombre para tu bot. Es el nombre que la gente ve en el chat, por ejemplo “Acme Support”.
4. Elige un nombre de usuario. Debe ser único y terminar en bot, por ejemplo acme_support_bot.

BotFather responde con tu token de bot, una cadena parecida a 5175890488:AAEI8qpz.... Lo pegarás en Quickchat en el siguiente paso, así que deja el chat abierto.

Precaución

Trata tu token de bot como una contraseña. Cualquiera que lo tenga puede controlar tu bot. Si alguna vez se filtra, envía /revoke a BotFather para invalidar el token antiguo y obtener uno nuevo.

Consejo

Puedes personalizar tu bot en cualquier momento desde BotFather: /setdescription, /setabouttext, /setuserpic (foto de perfil) y /setcommands. Envía /help para ver la lista completa.

Conecta tu bot con Quickchat AI

1. Abre la App de Quickchat AI y ve a External Apps.
2. Haz clic en Telegram.
3. En Tu propio bot, haz clic en Conectar con Telegram y pega tu token de bot.
4. Activa Activar tu propio bot.
5. Guarda.

Eso es todo. ¡Tu AI Agent ya está en marcha en Telegram! 🎉

Pruébalo

Abre tu bot en Telegram y envía /start. Tu AI Agent responde con su mensaje de bienvenida y luego contesta a lo que le preguntes. Con el bot compartido, usa tu Enlace de mensaje directo; con tu propio bot, BotFather te da un enlace t.me/<tu_nombre_de_usuario_bot>.

Cada conversación aparece también en tu Bandeja de entrada de Quickchat AI, donde puedes leer la transcripción completa, ver el nombre de Telegram del visitante y tomar el control de la AI cuando quieras.

Solución de problemas y FAQs

Añadí el bot a un grupo pero no pasa nada.

• Comprueba en la página de Telegram si hay una entrada en Esperando tu confirmación y haz clic en Confirmar. El AI Agent permanece en silencio en un grupo hasta que lo hagas.
• En un grupo, el bot compartido responde cuando lo @mencionas o respondes a uno de sus mensajes. Ignora a propósito la conversación normal entre miembros, para no interrumpir.
• Si ese grupo ya está conectado a otro AI Agent, la conexión se rechaza y nunca aparece ninguna entrada. Desconecta el grupo de ese Agent primero, o elige otro grupo.

Mi propio bot no responde.

• Asegúrate de que la Activar tu propio bot está activado y de que el token de bot está pegado correctamente (sin espacios de más). Si tienes dudas, /revoke en BotFather y pega el token nuevo.
• Envía primero /start al bot. Así es como Telegram activa el chat.
• Un bot se conecta a un AI Agent. No reutilices el mismo token en varios Agents de Quickchat AI.

¿Puedo pegar el token del bot compartido de Quickchat AI en la configuración avanzada?

• No, y Quickchat AI lo rechaza. Ese token pertenece al bot que atiende a todos los clientes con un clic, así que aceptarlo rompería su Telegram de golpe. Usa el flujo con un clic, o crea tu propio bot con BotFather.

¿Funciona el bot en chats de grupo?

• Sí. El bot compartido responde cuando se le @menciona o se responde a su mensaje. Tu propio bot funciona por defecto en el modo de privacidad de Telegram, así que solo ve los mensajes que lo mencionan o empiezan por /. Para que tu propio bot responda a cada mensaje de un grupo, abre BotFather, envía /setprivacy, elige tu bot y luego Disable, y después quita y vuelve a añadir el bot al grupo.

¿Cómo cambio el mensaje de bienvenida?

• El mensaje enviado con /start es el saludo de tu AI Agent, configurado en la App de Quickchat AI. Actualízalo ahí y se aplica a todos los canales, incluido Telegram.

¿Puedo conectar un bot que ya tengo?

• Por supuesto. Ábrelo en BotFather, ejecuta /token para recuperar su token (o /revoke para restablecerlo) y pégalo en la integración de Telegram. No hace falta crear un bot nuevo.

¿Puede el bot gestionar imágenes y archivos?

• Las fotos las analiza tu AI Agent, que puede describirlas y responder preguntas sobre lo que muestran. Para otros archivos (PDFs, documentos), al Agent se le indica que se envió un archivo y su nombre, pero no lee su contenido. Consulta Imágenes y archivos para más detalles.

Mira el vídeo

Play

¿Necesitas ayuda?

¿Sigues atascado? Escríbenos en Discord o contáctanos y te ayudaremos a poner tu bot en marcha.