> For the complete documentation index, see [llms.txt](https://aizy.gitbook.io/aizy-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://aizy.gitbook.io/aizy-docs/aizy-docs-es/channels/telegram.md).

# Telegram

## 1. Descripción

En este apartado conectas tu bot de Telegram con Aizy Agents para recibir y responder mensajes desde ese canal.

## 2. Antes de empezar

Antes de configurar Telegram en Aizy Agents, prepara lo siguiente:

* Un bot creado en Telegram con **@BotFather**.
* El **token del bot** que te entrega BotFather.
* Permiso para configurar el webhook del bot.

Referencias oficiales:

* Crear bot y obtener token: <https://core.telegram.org/bots/tutorial>
* API de bots: <https://core.telegram.org/bots/api>
* Configurar webhook (`setWebhook`): <https://core.telegram.org/bots/api#setwebhook>

## 3. Apartados de Telegram

La sección se reparte en tres tarjetas: credenciales, webhook y generador de enlaces de campaña.

| Subapartado                       | Qué haces en este subapartado                                                                                     |
| --------------------------------- | ----------------------------------------------------------------------------------------------------------------- |
| `Token del bot`                   | Pegas el token que te dio BotFather. Si ya está configurado, el campo aparece vacío: déjalo así para conservarlo. |
| `Nombre de usuario del bot`       | Añades el `@usuario` del bot (opcional). Hace falta para abrir la conversación y para generar enlaces de campaña. |
| `Abrir conversación`              | Abres tu bot en Telegram para probar la conexión. Se activa cuando hay nombre de usuario.                         |
| `URL de webhook`                  | Copias la URL que Telegram debe usar para enviar mensajes a tu agente.                                            |
| `Configurar webhook`              | Abres el enlace directo para registrar el webhook en Telegram. Aparece cuando el token ya está guardado.          |
| `Generador de enlaces de campaña` | Compones enlaces `t.me/tu_bot?start=…` que le dicen a Lead Tracking de dónde viene cada visitante.                |
| `Guardar`                         | Guardas la configuración del canal (botón de la barra inferior).                                                  |

## 4. Enlaces de campaña

Telegram no expone la URL de procedencia, así que el origen viaja en el propio enlace. La tarjeta **Generador de enlaces de campaña** pide **Origen**, **Medio**, **Campaña** y **Contenido**, compone el **Enlace de campaña** y lo copia con **Copiar enlace**. Usa un enlace por campaña.

* Requiere el nombre de usuario del bot y el módulo **Lead Tracking** activo en el bot para que el origen se registre.
* Telegram limita el enlace a 64 caracteres de datos. Si te pasas, la pantalla avisa y no genera el enlace: acorta los valores.
* El enlace no se guarda en el panel: genéralo, cópialo y publícalo donde vaya.
* Telegram solo identifica al visitante en conversaciones privadas; los mensajes de grupo no resuelven identidad.