# Telegram

> Crea un bot con @BotFather, pega su token en Agentclic y tu agente empezará a responder por Telegram en un par de minutos, sin revisión empresarial.

URL: https://agentclic.com/docs/canales/telegram
Última revisión: 2026-11-02

Para que tu agente atienda por Telegram, crea un bot con **@BotFather** dentro de Telegram, copia el **token** que te da y pégalo en **Canales › Telegram › Configurar**. Agentclic comprueba el bot y lo deja listo para recibir mensajes. No hay revisión empresarial: se hace en un par de minutos.

## Antes de empezar

- Necesitas una cuenta de Telegram para hablar con @BotFather.
- Telegram forma parte de los canales avanzados de tu [plan](https://agentclic.com/docs/primeros-pasos/planes-y-creditos).

## Paso a paso

### 1. Crear el bot en Telegram

1. Abre **@BotFather** en Telegram (en la página de configuración tienes el enlace directo).
2. Envía el comando `/newbot` y sigue las instrucciones: te pedirá un **nombre** y un **nombre de usuario** para el bot.
3. BotFather te responderá con un **token** con este formato: `123456789:ABC-DEF1234ghIkl-zyx57W2v1u123ew11`.

### 2. Conectarlo al agente

1. En el agente, abre **Canales** y pulsa **«Configurar»** en **Telegram**.
2. En **Conectar bot**, pega el token en **Bot Token**.
3. Pulsa **«Conectar y registrar webhook»**.
4. Verás «Bot @tubot conectado correctamente» y el recuadro **Bot conectado** con la etiqueta **Conectado**.

### 3. Probarlo

Pulsa **«Abrir chat con el bot»**, escribe un mensaje y comprueba que el agente responde.

> **Importante:** Trata el token como una contraseña: quien lo tenga puede controlar el bot. Si crees que alguien lo conoce, genera uno nuevo en @BotFather y pégalo en **Reemplazar token**.

## Cambiar el token o el bot

En la misma página, el formulario pasa a llamarse **Reemplazar token**. Pega el token nuevo y pulsa **«Actualizar»**.

Para quitar el bot del agente, pulsa **«Desconectar»** y confirma. Si solo quieres que deje de responder un tiempo, pon el canal **En pausa** en la pestaña Canales. Ver [Canales del agente](https://agentclic.com/docs/canales/vision-general#activar-o-pausar-un-canal).

**Detalles técnicos**
- Al conectar, Agentclic valida el token con Telegram y registra automáticamente la dirección a la que Telegram envía los mensajes. En el recuadro **Bot conectado** puedes ver y copiar esa **URL del webhook** y su **Webhook secret**; no tienes que configurarlos en ningún sitio.
- El token se guarda cifrado.
- Cada persona que escribe al bot es una conversación distinta, identificada por su chat de Telegram.


## Problemas frecuentes

### «Token inválido»

El token está mal copiado o se ha revocado. Cópialo de nuevo desde @BotFather, sin espacios, y vuelve a pulsar **«Conectar y registrar webhook»**.

### «Guardado, pero no se pudo registrar el webhook»

El token es correcto, pero Telegram no ha aceptado la dirección de recepción. El estado aparece como **Error** con el detalle. Pulsa **«Actualizar»** con el mismo token para volver a intentarlo.

### El bot está conectado pero no responde

Comprueba que el canal **Telegram** esté **Activo** en la pestaña Canales, que el agente esté **Activo** y que te queden créditos.