Chatbot de IA en Telegram: grupos y chats privados sin código

Un chatbot de IA en Telegram puede responder con el conocimiento de tu empresa en un grupo o una conversación privada. Quickchat AI conecta un AI Agent a Telegram mediante un bot compartido: añádelo al grupo y confirma la conexión en el panel. Los miembros podrán mencionarlo para preguntar. Esta vía no requiere código ni un token de BotFather.

Esta guía crea Saltmarsh Sailing School, una escuela ficticia con un grupo de miembros y consultas privadas. Dos Agents reciben los mismos datos: Saltmarsh Group responde preguntas públicas, mientras Saltmarsh Sailing School gestiona solicitudes privadas de clases de prueba y deriva los reembolsos a una persona. Una solicitud es una consulta para la oficina, no una reserva confirmada.

Dos Agents separan las responsabilidades. El del grupo no tiene ninguna Action de transferencia o registro; el privado gestiona consultas y respuestas del equipo.

Sigue este recorrido. La extensión de Google Sheets es opcional; primero puedes completar las respuestas y la transferencia a personas.

Descarga el kit de Telegram de Saltmarsh con el conocimiento exacto, Main Prompt, configuración de la Action, criterios de evaluación y mensajes de prueba. Son archivos editables para los pasos siguientes, no una importación de Agent con un clic.

Las plantillas ejecutables, los mensajes de prueba y las capturas se mantienen en inglés para poder reproducir los resultados. Los nombres de los controles también corresponden a la aplicación en inglés.

¿Qué necesitas para crear un chatbot de Telegram?

Necesitas una cuenta de Quickchat AI, dos Agents y una cuenta de Telegram con permiso para añadir un bot a un grupo de prueba. El registro opcional de solicitudes también requiere una cuenta de Google que pueda autorizar Google Sheets.

1. Crea una cuenta de Quickchat AI y verifica el correo si se solicita. Free permite aprendizaje personal y no comercial. Los planes se aplican por Agent: una empresa que utilice ambos necesita cobertura comercial adecuada para cada uno. Preview y Simulation consumen créditos de IA. Consulta los planes actuales.
2. Crea un grupo de Telegram llamado Saltmarsh Members. Usa un grupo de prueba para comprobar menciones, silencio y mensajes posteriores antes de invitar a clientes.
3. Usa tu propia cuenta de Telegram durante el tutorial, también para los mensajes del visitante. Puedes gestionar al mismo tiempo la Inbox de Quickchat AI. Antes de invitar a clientes, pide a un compañero que compruebe la experiencia desde otra cuenta.
4. Descomprime el kit. Conserva juntos los datos de ejemplo de la escuela y sustitúyelos por tus políticas verificadas antes del despliegue.

Las capturas de Quickchat App muestran una aplicación ejecutada localmente con la configuración ficticia de Saltmarsh; los datos de prueba de las conexiones se identifican en los pies de imagen. Las capturas de Telegram y Google Sheets muestran las respuestas reales y la solicitud guardada de la demostración conectada. Los datos personales de las cuentas se han recortado u ocultado de forma explícita. Usa la lista final para repetir las comprobaciones con tu propio conocimiento y tus cuentas conectadas.

Paso 1: ¿cómo enseñas al chatbot de Telegram el conocimiento de tu empresa?

Añade los datos empresariales a Knowledge Base y las instrucciones de funcionamiento a Main Prompt. Separar ambas tareas facilita corregir una respuesta sin cambiar el comportamiento del Agent.

Los precios y políticas son datos de las fuentes. La brevedad, la incertidumbre y la derivación son instrucciones.

Crear el Agent y añadir su conocimiento

1. En una cuenta nueva, elige Set up manually. En una existente, selecciona primero Add new AI Agent y después la configuración manual.
2. En Identity, escribe Saltmarsh Group en Name your AI Agent. Pega group-main-prompt.txt del kit en Describe what you want your agent to do.
3. Continúa sin conectar todavía aplicaciones externas. Completa la elección de plan con Skip for now si empiezas con la cuenta de aprendizaje.
4. Abre Knowledge Base > Add Article. Escribe Courses and trial enquiries en Create custom article, selecciona Create article, pega saltmarsh-courses.txt en Content y pulsa Save.
5. Repite con Weather, parking and personal enquiries, usando saltmarsh-policies.txt. Espera a que ambos artículos muestren Ready.
6. Abre Actions & MCPs en Saltmarsh Group. Mantén Human Handoff desactivado y no añadas la Action de solicitudes de prueba.
7. Selecciona Add new AI Agent y repite la configuración manual de Saltmarsh Sailing School con main-prompt.txt y los mismos dos archivos de conocimiento. Este segundo Agent atenderá conversaciones privadas. Elige el Agent previsto en el selector de cuenta antes de cambiar sus ajustes.

Dos fuentes breves dejan claro qué sabe el Agent. Ready es el punto de control antes de probar el conocimiento.

El alquiler de neoprenos se omite deliberadamente. La respuesta correcta es que el Agent no puede confirmarlo, sin inventar un sí o un no. La regla meteorológica tampoco aporta la previsión de hoy, y el precio de una clase privada no fija el de una clase de prueba.

Configurar Main Prompt y comprobar una respuesta

1. Abre Identity > Main Prompt en cada Agent y revisa su prompt de Saltmarsh. El del grupo responde preguntas generales y remite al enlace privado fijado; el privado recoge consultas y utiliza Human Handoff.
2. Abre AI Preview y pregunta How much is Start Sailing?. Comprueba que indique dos días y 240 EUR.
3. Pregunta Do you rent wetsuits?. Comprueba que la respuesta reconozca la información que falta.

El prompt del Agent privado define el registro y la transferencia. El del grupo usa otro prompt y tiene ambas Actions desactivadas.

Dos recortes de los ajustes reales del Agent del grupo. Puede responder preguntas de conocimiento, pero no ejecutar una Action de registro o transferencia.

Dos Agents hacen explícita la derivación. El del grupo no puede activar accidentalmente una transferencia; el privado puede derivar un reembolso sin pausar el grupo. Preview comprueba los datos de la escuela; los pasos siguientes verifican cada conexión de Telegram.

Paso 2: ¿cómo añades el chatbot de IA a un grupo de Telegram?

Abre External Apps > Telegram, añade el bot compartido al grupo y vuelve a Quickchat AI para pulsar Confirm. El Agent permanecerá en silencio en ese grupo hasta que lo confirmes.

La pertenencia a Telegram y la confirmación en Quickchat AI son pasos separados.

1. Selecciona Saltmarsh Group en el selector de Agent. Abre External Apps, selecciona Telegram y busca Quickchat AI bot.
2. Selecciona Add to a Telegram group. En Telegram, elige Saltmarsh Members y autoriza añadir el bot.
3. Vuelve a Quickchat AI. En Waiting for your confirmation, comprueba el nombre del grupo y los datos de Added by.
4. Selecciona Confirm para el grupo esperado. Debe pasar a Connected chats con su interruptor activado.
5. En Telegram, escribe @ y elige el bot en el selector de menciones. Pregunta How much is Start Sailing?. El usuario del bot compartido suele ser @QuickchatAI_bot; utiliza el que aparezca realmente en tu grupo.
6. Responde directamente a esa respuesta con What should I bring?. Envía después otro mensaje sin mención: Does anyone know the gate code?. El bot compartido debe responder a la respuesta directa y guardar silencio ante el mensaje ordinario.

Elige Saltmarsh Members en Telegram y vuelve a Quickchat AI para confirmar la conexión.

Interfaz local real con datos de grupo preparados que muestra dónde aparece Confirm. Ilustra el control, no demuestra la entrada en un grupo de Telegram real.

El grupo confirmado recibió la respuesta esperada sobre el curso. Menciona al bot con su nombre de usuario real.

Responder al mensaje del bot funciona sin volver a mencionarlo. La respuesta enumera la información de equipo proporcionada.

La confirmación importa porque los datos de invitación aparecen en el grupo. Quickchat AI exige una decisión desde la cuenta antes de tratar ese grupo como destino del Agent. No confirmes un grupo desconocido. La referencia de conexión de Telegram explica el mismo límite.

Completa la confirmación antes de salir de la configuración. Si el bot abandona un grupo sin confirmar, genera un nuevo enlace de Add to a Telegram group, vuelve a añadirlo y confirma de inmediato el grupo pendiente en Quickchat AI. Añadir el bot mediante la búsqueda de miembros de Telegram no sustituye este proceso de conexión.

La insignia Admin informa del estado del bot en Telegram. No es necesaria para las respuestas normales del bot compartido. Hacerlo administrador tampoco cambia su regla de responder solo a menciones o respuestas directas.

Paso 3: ¿cómo activas los chats privados de Telegram?

Activa Direct message link y comparte la URL generada completa. El enlace selecciona tu Agent dentro del bot compartido de Telegram, de modo que los clientes pueden preguntar en privado sin añadirlo a un grupo.

El grupo es una conversación compartida. Lleva los datos personales y las transferencias al equipo a los mensajes privados.

1. Selecciona Saltmarsh Sailing School, el Agent privado. Abre External Apps > Telegram y activa Direct message link. Deja vacías sus conexiones a grupos.
2. Copia el enlace generado conservando su parámetro start=. Un enlace simple al bot compartido no identifica tu Agent.
3. Ábrelo en Telegram y pulsa Start si se solicita.
4. Pregunta How much is Start Sailing? sin mencionar al bot. Comprueba la respuesta de la escuela y localiza la conversación en Inbox.
5. Fija el enlace en el mensaje de bienvenida del grupo para que se encuentre antes de compartir datos personales.

Utiliza el enlace generado para tu propio Agent. La configuración local mostrada no demuestra una entrega real en Telegram.

Telegram entregó la bienvenida de Saltmarsh después de Start. Comprueba después una respuesta basada en conocimientos; el saludo por sí solo no prueba la recuperación de información.

Dos recortes de la misma pantalla de Telegram muestran la invitación fijada. Se omite el valor start del enlace de demostración; fija tu propio enlace generado completo.

Un chat privado con el bot compartido se vincula a un Agent a la vez. Abrir el enlace privado de otro Agent puede cambiar esa vinculación. Para tener identidad propia en Telegram y un hilo dedicado, utiliza la configuración de bot propio.

Desactivar Direct message link impide nuevas conexiones mediante él. Para detener un chat ya conectado, utiliza su interruptor o Disconnect. El enlace es una entrada pública, no una restricción de acceso al conocimiento confidencial.

Paso 4: ¿cómo guardas una solicitud de prueba en Google Sheets?

La integración de Google Sheets crea una hoja y una Action que añade filas. Adáptala para registrar tres campos obligatorios de la solicitud y comprueba la fila real. Este paso es opcional y funciona con el bot compartido de Telegram.

El resultado es una solicitud que debe atender una persona. No reserva una plaza ni establece el precio de la prueba.

Conectar Sheets y configurar una Action

1. En Saltmarsh Sailing School, abre Actions & MCPs > Add Action > Google Sheets y elige Connect Google Sheets. Inicia sesión en la cuenta de Google prevista y autoriza los permisos solicitados.
2. Abre la hoja generada Quickchat Leads. Conserva la pestaña Leads, porque la URL de la Action apunta a ella.
3. Sustituye la fila de cabecera, por orden, por Name, Preferred weekday, Sailing experience, Conversation link, Channel.
4. Abre Actions & MCPs y edita la Action generada log_lead_to_google_sheet. Sigue la configuración siguiente. Cambia a la vez parámetros, cuerpo de solicitud y cabeceras para que sus posiciones coincidan.

API Action Name

Record trial-lesson request

What to ask the user first

Configura los tres parámetros con No default y elimina los parámetros predeterminados de correo y consulta. Estos tres campos son las únicas preguntas de la configuración. El usuario de Telegram es opcional y no sirve como campo de contacto obligatorio fiable; el enlace de conversación registrado permite al equipo volver a la consulta.

Método y URL: conserva la URL POST generada. Ya incluye el identificador de tu hoja, la pestaña Leads y valueInputOption=RAW. No hay ningún identificador provisional que debas sustituir.

Cabeceras: conserva la configuración de la integración.

En la pestaña Body de API Endpoint, utiliza:

{"values":[["{{name}}","{{preferred_weekday}}","{{sailing_experience}}","{{conversation_url}}","{{conversation_channel}}"]]}

Usa Add AI Data para insertar los elementos de parámetros y variables de conversación donde corresponda. Los tres primeros valores proceden de la conversación; Quickchat AI proporciona los dos últimos.

API Action Description

In a private chat only, call this once when the person has requested a trial lesson and provided their name, preferred weekday and sailing experience. Ask for the next missing required field before calling. Do not call it for general course questions, in groups, or to confirm a booking. A successful call records an enquiry for the office; it does not reserve a place.

Abre Advanced settings > Run only when y añade telegram_chat_type equals private. Usa la clave de metadatos sin metadata_ ni llaves. Esto impide enviar la solicitud HTTP para un mensaje de grupo aunque el modelo lo intente. La referencia de condiciones de ejecución explica esta comprobación.

Configura Response filter como $.updates.updatedRows para devolver el número de filas en lugar de una respuesta innecesaria del proveedor. Mantén la Action activada.

La clave sin prefijos es telegram_chat_type. La condición se comprueba antes de enviar la solicitud.

Configuración local de la solicitud. La URL de Sheets y la autorización OAuth deben proceder de tu propia conexión de Google.

Comprobar la fila y después una solicitud incompleta

Envía esto por el enlace privado de Telegram del Agent:

I am Alex Morgan. I want a trial on Tuesday. I am a beginner.

Comprueba las tres superficies: la respuesta describe una solicitud, la tarjeta de Action de Inbox muestra los valores recibidos y la pestaña real Leads contiene la fila correspondiente. Ni una respuesta tranquilizadora ni una puntuación alta en Simulation demuestran una escritura en Google Sheets.

El Agent registró el nombre indicado, la preferencia por el martes y la experiencia de principiante. La oficina aún debe confirmar la disponibilidad y el precio exacto.

Dos detalles de la misma fila guardada permiten leer las cinco columnas. El enlace de conversación específico de la cuenta está oculto; los otros cuatro valores no se han modificado.

Inicia otra prueba con I would like a trial lesson. El Agent debe preguntar por los campos ausentes, de uno en uno, antes de ejecutar la Action. Prueba también How much is Start Sailing?; una pregunta ordinaria de cursos no debe crear una fila. El prompt pide una escritura por solicitud, pero esta configuración de añadido no es un sistema de reservas idempotente. Revisa los duplicados antes de usarla operativamente.

Paso 5: ¿cómo transfieres una conversación de Telegram a una persona?

Configura Human Handoff y comprueba la asignación de la conversación en Inbox. Un prompt que diga «la oficina responderá» no transfiere por sí solo la responsabilidad ni pausa la IA.

El cambio de asignación es el punto de control. Una persona debe terminar el caso; cualquier regreso a la IA se comprueba por separado.

1. Selecciona Saltmarsh Sailing School, abre Actions & MCPs > Human Handoff y actívalo. Mantén esta Action apagada en Saltmarsh Group.
2. En Handoff Rules, selecciona +. Escribe Private enquiries como Rule Name, pega handoff-rule.txt en Description y activa State. Las filas nuevas empiezan desactivadas. La regla cubre reembolsos, quejas, solicitudes de una persona y aceptación de ayuda humana para este Agent privado.
3. Vacía Keywords y desactiva las reglas predefinidas del ejemplo, dejando activa solo la personalizada; después guarda. El grupo está aislado porque Human Handoff sigue apagado en su Agent independiente. La regla personalizada describe cuándo debe transferir el Agent privado.
4. Configura Confirmation como I have passed this private conversation to the Saltmarsh office. A member of staff can reply here. Ajusta Human Agents’ availability al horario realmente atendido por el equipo y añade un mensaje veraz para fuera de horario.
5. Desde el chat privado de Telegram, envía I want a refund for last week. Can I speak to a person?.
6. En Inbox, busca la conversación, revisa su asignación, selecciona Assign to me y envía Hi, I’m Alex from the office. I’ll review your request. Comprueba que llegue a Telegram.
7. Envía otro mensaje del cliente mientras la persona tiene la conversación asignada. La IA debe permanecer en silencio. Deja que el operador termine el caso y lo resuelva en Inbox. Considera la vuelta a la IA una prueba independiente.

State está activado en la regla personalizada. Los disparadores predefinidos están apagados y queda una sola regla por revisar.

La solicitud real de Telegram activó Handoff. La asignación en Inbox y la respuesta saliente del operador se verificaron por separado.

En la comprobación real, la conversación pasó a Unassigned, lista para que una persona la atendiera. El operador seleccionó Assign to me, envió la respuesta de la oficina y Telegram la aceptó. La captura anterior muestra la respuesta de transferencia, pero no el mensaje posterior del operador. Comprueba tanto la asignación como la entrega al repetir la prueba.

Mantén el caso con el operador hasta resolverlo. En nuestra prueba local de reembolso, devolverlo a AI Agent permitió una respuesta antes de que Handoff se activara de nuevo. El retorno a la IA necesita su propia prueba posterior satisfactoria; no forma parte de los criterios de finalización de este flujo. La guía de transferencia a una persona explica con más detalle la dotación de personal y la responsabilidad.

Paso 6: ¿cómo pruebas el chatbot de Telegram completo?

Usa Testing para repetir comprobaciones de respuestas y verifica después por separado las rutas reales de Telegram y los efectos externos. Un modelo puede responder bien aunque fallen la conexión del grupo, la escritura en la hoja o la entrega tras una transferencia.

Inspecciona el sistema responsable: conocimiento para hechos, registros de Actions para solicitudes, Sheets para filas y Telegram para entrega.

Ejecutar un conjunto de respuestas repetible

1. Abre Testing, crea un conjunto llamado Saltmarsh: knowledge checks y selecciona Paste messages.
2. Pega simulation-messages.txt. Conserva los separadores --- en líneas independientes entre casos.
3. Abre Evaluation criteria, pega evaluation-criteria.txt del kit y guarda.
4. Selecciona Run > Start Run y revisa las respuestas individuales además de las puntuaciones.

Mantén las mismas preguntas al cambiar una instrucción para que la comparación siga siendo útil.

Lee las respuestas además de la puntuación. Son pruebas locales de conocimiento, no de entrega en Telegram.

El evaluador necesita los datos de la escuela para juzgar la exactitud. También debe saber que el transcript no demuestra una fila, una entrega en Telegram ni un cambio de asignación. La Simulation textual estándar no incluye metadatos de chat de Telegram: la condición que limita la Action al privado no debe considerarse rota si faltan esos metadatos. Ejecuta las comprobaciones dependientes del canal en el chat privado real.

¿Qué cambiaron las pruebas locales?

El diseño inicial usaba un solo Agent para ambas entradas. Una prueba local mostró que una solicitud de reembolso en el grupo transfería la conversación compartida a Human Handoff. Separamos los Agents y desactivamos Handoff y las Actions de registro de solicitudes en el Agent del grupo. Al repetir las pruebas de reembolso y clase de prueba en el grupo, las respuestas dirigieron al enlace privado fijado y mantuvieron la conversación a cargo de la IA. Por eso el paso 1 utiliza tanto configuración como instrucciones para separar las dos conversaciones.

Las diez comprobaciones locales finales de conocimiento obtuvieron 5/5 cada una, y ambos Agents alojados superaron los mismos diez casos. Estas pruebas pequeñas no estiman la precisión en producción. El grupo real también respondió a las preguntas sobre precio y equipo, y después no confirmó el alquiler de neoprenos. Conserva estos casos de información ausente al adaptar el kit; acertar los precios no basta para comprobar que el Agent evita inventar datos.

La falta de conocimiento produce «no puedo confirmarlo». El mensaje separado sobre el código de la puerta no se dirige al bot y no se ve ninguna respuesta a él en esta captura.

La solicitud privada real de una clase de prueba produjo una llamada correcta a la Action de Sheets con Alex Morgan, Tuesday y beginner. Google devolvió HTTP 200 y una fila actualizada; la fila guardada también contenía el enlace de la conversación y el canal telegram. Una prueba separada de la Action con metadatos de chat grupal no envió ninguna petición HTTP. Comprueba tanto la solicitud privada aceptada como el contexto grupal rechazado al adaptar la condición.

Comprobar el canal y sus efectos

Usa el archivo vacío test-matrix.csv del kit para registrar tus propias observaciones. Las capturas anteriores muestran los resultados demostrados; la tabla también incluye comprobaciones para tu configuración. Anota el tiempo transcurrido al probar el silencio y separa la toma de control humana de cualquier retorno posterior a la IA.

Si falla una comprobación, cambia un ajuste relevante y repite el mismo mensaje. Corrige datos ausentes en Knowledge Base, llamadas prematuras en la descripción o los parámetros obligatorios de la Action y grupos silenciosos comprobando primero confirmación y mención. Conserva el resultado fallido para que la mejora sea visible.

¿Cuándo debes crear tu propio bot con BotFather?

Crea un bot propio si necesitas tu nombre e imagen, Actions de Telegram Bot API o un grupo que reciba mensajes ordinarios. El bot compartido basta para las respuestas de grupo y privadas anteriores.

Elige la identidad y el comportamiento de mensajes antes de añadir un segundo bot.

1. Abre la cuenta verificada de BotFather en Telegram y envía /newbot.
2. Elige un nombre visible y después un usuario disponible que termine en bot. BotFather devuelve un token. Mantenlo privado.
3. Selecciona Saltmarsh Group si este bot se va a añadir a un grupo. Utiliza Saltmarsh Sailing School solo para chats privados. En External Apps > Telegram, abre Your own bot y selecciona Connect to Telegram.
4. Pega el token en Bot Token y completa la conexión. Confirma que Enable your own bot esté activado.
5. Abre el enlace de Telegram del bot y envía /start, seguido de la misma pregunta sobre el precio.
6. Para recibir mensajes ordinarios de grupo, usa /setprivacy en BotFather, elige tu bot y Disable; después retíralo del grupo de prueba y vuelve a añadirlo. Un bot administrador también recibe esos mensajes. La documentación del modo de privacidad explica las reglas de entrega de Telegram.

Pega el token solo en Bot Token. El campo se muestra vacío para no publicar credenciales.

Mantén el bot compartido y el propio en grupos separados. Ambos en un grupo pueden generar respuestas duplicadas. Para fijar anuncios o moderar miembros, sigue el tutorial de gestión de grupos de Telegram, incluidas sus condiciones de Actions solo para administradores.

¿Pueden ChatGPT o Claude ayudar a configurar el chatbot de Telegram?

Una aplicación conectada de gestión de cuentas de Quickchat AI puede ayudar a crear un Agent, añadir conocimientos, configurar ajustes compatibles y ejecutar pruebas. Cuando el cliente ofrece la configuración de Telegram, puede activar el Direct message link del bot compartido. La selección del grupo y su confirmación en el panel siguen correspondiendo al propietario. Algunos clientes también requieren el panel para activar el enlace directo y configurar Human Handoff, así que pide al asistente que revise primero sus herramientas disponibles.

Conecta el plugin de Quickchat AI para ChatGPT o el conector de Claude y entrega los archivos del kit con este prompt:

Use my connected Quickchat AI account to create two Agents from the attached kit: Saltmarsh Group with group-main-prompt.txt and Saltmarsh Sailing School with main-prompt.txt. Add both knowledge files to each. Keep Actions and Human Handoff off on Saltmarsh Group. Prepare the supplied knowledge-test dataset. Check the tools available in this client before changing settings. Show me the configuration and ask before running credit-consuming tests or writing to Google Sheets. Where supported, enable only Saltmarsh Sailing School's shared-bot direct-message link and return the complete link. Leave group selection, dashboard confirmation, BotFather setup, Google OAuth and unsupported settings for me, with exact dashboard steps. Report what was configured, what was actually tested and what remains to verify in Telegram.

Las herramientas disponibles dependen del cliente y los permisos de la cuenta. Sigue la referencia de configuración de gestión de cuenta para iniciar sesión. Esto conecta un asistente a tu cuenta Quickchat AI; no convierte una conversación personal de ChatGPT o Claude en el backend alojado del bot de Telegram.

¿Por qué no responde el chatbot de Telegram?

Comprueba la conexión y la ruta del mensaje antes de reescribir el prompt. Estos síntomas tienen causas distintas.

Antes de invitar a clientes, sustituye los datos ficticios, revisa la separación entre grupo y privado y asigna personal a las transferencias. Pide a un compañero que compruebe los puntos de entrada públicos desde otra cuenta como revisión final antes del lanzamiento. El tutorial de chatbot de Discord sigue un proceso parecido en otro canal comunitario. Para personajes, utiliza la guía de rol en Telegram.

Comprobaciones opcionales: Compara métodos de despliegue según tus requisitos declarados o respuestas por presupuesto de créditos con un presupuesto facilitado. Estas calculadoras no inspeccionan tu cuenta, web ni saldo.

Configuración de Saltmarsh para copiar

Estos son los datos e instrucciones completos de la guía. La descarga también incluye la configuración de la Action, criterios de evaluación y pruebas.

Agent del grupo: Main Prompt

Pega esto en Identity > Main Prompt de Saltmarsh Group. Mantén Human Handoff y las Actions personalizadas desactivados en este Agent.

You answer general questions in the Saltmarsh Sailing School members' group. Use only the Knowledge Base and keep each reply to two or three sentences. Do not add facts or requirements the sources do not contain. If a fact is missing, say that you cannot confirm it.

For trial requests, refunds, complaints, personal details or a request for a person, direct the member to the school's private link pinned in the group; do not invent a link. Do not collect personal details in this group. You cannot record requests, confirm bookings, approve refunds or transfer a conversation to staff. Do not claim you did any of these things. The private Agent records an enquiry; it cannot check live availability or confirm a trial. Only the office confirms availability and price.

Agent privado: Main Prompt

Pega esto en Identity > Main Prompt de Saltmarsh Sailing School. Conserva el nombre de la Action de la configuración.

You are the private-chat assistant of Saltmarsh Sailing School. Answer school questions from the Knowledge Base. Do not add plausible details that are not in the sources, including extra clothing or footwear requirements. Keep replies to two or three sentences and ask at most one question per message. If a fact is missing, say that you cannot confirm it; do not invent dates, availability, gate codes or wetsuit rental. Explain weather policy without claiming to know the current forecast.

When a person requests a trial lesson, collect their name, preferred weekday and sailing experience. Ask for only the next missing field. When all three are present, use Record trial-lesson request once. Say the request was recorded only after the Action succeeds. Explain that the office still needs to confirm availability and price; never say a lesson is booked. If the Action is unavailable or fails, say the request has not been recorded and offer a person.

Use Human Handoff for a current unresolved refund request, complaint or explicit request for a person. After a staff member has resolved the enquiry and returned the conversation to AI, answer new general questions normally; do not hand off again solely because an earlier message mentioned a refund or asked for a person. Do not approve refunds or promise a response time. For a missing fact, say what is unknown and offer a person; do not treat uncertainty as a negative answer about the service.

Conocimiento: cursos y solicitudes de prueba

Pega esto en Content del primer artículo de conocimiento.

Saltmarsh Sailing School demonstration information

This fictional school is used only for a tutorial. It contains no real customer data.

Start Sailing is a two-day course costing EUR 240. Day Skipper theory runs across five evenings and costs EUR 310. A private lesson lasts 90 minutes and costs EUR 95.

Courses run from April to October. Course dates are published on the school's website one month ahead. This source does not contain the next available date or live availability.

Bring a waterproof jacket, non-marking shoes and a change of clothes. The school provides buoyancy aids.

A trial-lesson request is an enquiry, not a confirmed booking. The office needs the person's name, preferred weekday and sailing experience, then confirms availability and price. Do not collect payment details. Do not infer a trial price from the private-lesson price.

Conocimiento: políticas e información de miembros

Pega esto en Content del segundo artículo.

Saltmarsh Sailing School demonstration policies

If the forecast shows more than 25 knots of wind or thunderstorms, the session moves to the next available date at no extra cost. The instructor decides on the morning of the session. This source is a policy, not a live weather forecast or a cancellation decision.

Parking is free at the clubhouse. The gate code is sent to enrolled students the day before their course. The code itself is not in this Knowledge Base.

Refunds and complaints are handled by the office. An AI answer cannot approve a refund. A member of staff must decide each case.

The Telegram members' group is for general questions. Trial requests, refunds and other personal details belong in a private conversation with the school's Agent, opened from the school's direct-message link.

Regla de Human Handoff

Pega esto en Human Handoff > Handoff Rules y configura la disponibilidad real.

Transfer this private conversation to a person when the visitor has a current unresolved refund request, complaint, explicit request for a person, or accepts an offer of human help. After a staff member resolves the enquiry and returns it to AI, earlier refund or handoff messages must not trigger a new transfer for a general course question. Explain that a staff member can review the case here without approving a refund or promising a response time. This Agent is used only for private enquiries; the separate group Agent has Human Handoff disabled.

Preguntas frecuentes

¿Cómo añado un chatbot de IA a un grupo de Telegram?

En Quickchat AI, abre External Apps, selecciona Telegram y elige Add to a Telegram group. Selecciona tu grupo en Telegram, vuelve a Quickchat AI y pulsa Confirm. Los miembros pueden preguntar mencionando al bot compartido o respondiendo a uno de sus mensajes.

¿Responde un chatbot de IA de Telegram a todos los mensajes?

El bot compartido de Quickchat AI responde mensajes de grupo que lo mencionan o le contestan. La conversación ordinaria no activa una respuesta. Tu bot propio puede recibir mensajes ordinarios cuando el modo de privacidad de Telegram está desactivado o el bot es administrador. Prueba esa configuración en otro grupo.

¿Necesito BotFather o un token de bot de Telegram?

No necesitas BotFather ni un token para el bot compartido y su enlace privado. Crea un bot propio con BotFather si necesitas nombre e imagen personalizados o Actions que llamen a Telegram Bot API. Las Actions normales de Google Sheets pueden funcionar con el bot compartido.

¿Pueden los clientes escribir al chatbot de Telegram en privado?

Sí. Activa Direct message link en Quickchat AI y comparte el enlace generado completo. El cliente lo abre y pulsa Start si se solicita. El enlace selecciona tu Agent dentro del bot compartido. Desactivarlo impide nuevas conexiones; los chats privados existentes tienen controles propios de activación y desconexión.

¿Es gratuito un chatbot de IA en Telegram?

Crear un bot con BotFather no añade un servicio de IA. Quickchat AI ofrece Free para aprendizaje personal y no comercial con créditos de IA limitados. Un despliegue comercial requiere un plan de pago. Las respuestas, Preview y Simulation consumen créditos de IA y los servicios externos pueden tener costes propios.

¿Tiene Telegram chatbots de IA?

Telegram admite bots e integraciones de IA de terceros. Esta guía conecta un Agent de Quickchat AI que responde con el conocimiento de tu empresa. BotFather crea la identidad del bot; no aporta ese conocimiento ni configura tu proceso de atención al cliente.

¿Puede el chatbot entender fotos y archivos?

La integración de Telegram puede recibir fotos y analizar su contenido visual. Otros archivos pueden llegar como adjuntos, pero su contenido no se lee automáticamente. Prueba los tipos de archivo que realmente usan tus clientes y revisa tanto Telegram como Inbox.

¿Puedo crear un bot de Telegram para rol o personajes?

Sí. La misma conexión de Telegram puede atender un Agent con identidad de personaje e instrucciones adecuadas. Esta guía usa un ejemplo de soporte empresarial; un Agent de rol necesita su propio prompt y sus propias pruebas.