# Conectar un bot de Telegram — Vocero

> Tres pasos y una sola vez: crear el bot, ponerle cara y darlo de alta en Vocero.

Guía oficial: https://vocero.net/documentacion/telegram/ · Más documentación: https://vocero.net/llms.txt

## Qué vas a conseguir

Un bot con el nombre de tu empresa —algo como `@TuEmpresaBot`— al que tus clientes le escriben desde Telegram. Lo que escriban llega al grupo de tu equipo, cualquiera de tus agentes lo toma, y contesta desde su celular. Para el cliente es una conversación normal de Telegram.

Es el canal más barato de todos: **Telegram no cobra por mensaje** y no tiene plazos para contestar, a diferencia de WhatsApp o Instagram.

> **Ojo con no confundir dos bots.** Este es el bot **público**, el que ven tus clientes. El bot donde trabajan tus agentes es otro, el de Vocero, y ya existe: a ese le escriben `/start` una vez y listo.

## 1. Crear el bot

Se crea en Telegram, hablando con un bot oficial que se llama **@BotFather**:

1. En Telegram, buscar **@BotFather** y tocar **Empezar**.
2. Mandarle **`/newbot`**.
3. Te pide el **nombre visible**: el que van a ver tus clientes arriba del chat. Puede tener espacios y mayúsculas — por ejemplo `Panadería La Espiga`.
4. Después te pide el **nombre de usuario**, que es único en todo Telegram y **tiene que terminar en `bot`** — por ejemplo `LaEspigaBot`. Si está ocupado, te lo dice y probás otro.
5. Te responde con un **token**: una línea larga con dos partes separadas por dos puntos. Ese token es lo que hace falta en el paso 3.

## 2. Ponerle cara (recomendado)

Antes de darlo a conocer, sigue siendo @BotFather:

- **`/setuserpic`** — la foto de perfil, el logo de tu empresa.
- **`/setdescription`** — lo que se lee **antes** de empezar la conversación, cuando alguien abre el chat por primera vez. Es el lugar para decir qué se puede consultar y en qué horario.
- **`/setabouttext`** — el texto corto de la ficha del bot.

No es imprescindible, pero un bot sin foto ni descripción parece abandonado y la gente desconfía.

## 3. Darlo de alta en Vocero

En el panel de Vocero, en **Canales → Crear un canal → Bot público de Telegram**:

1. Pegá el **token** del paso 1. Vocero le pregunta a Telegram quién es ese bot, confirma el `@usuario` y guarda todo solo: no hay que copiar ningún identificador.
2. Elegí el **área** que va a atender esos mensajes. Si elegís más de una, al primer mensaje el sistema le pregunta al cliente con cuál quiere hablar, con botones.

Listo. Probalo vos mismo: buscá el `@usuario` del bot desde otra cuenta de Telegram, tocá **Empezar** y escribí. Tiene que aparecer en el grupo de tu equipo en un par de segundos.

## Cuidado con el token

**El token es la llave del bot**: cualquiera que lo tenga puede leer y contestar los mensajes de tus clientes haciéndose pasar por vos. Tratalo como una contraseña.

- No lo pegues en un grupo, en un correo compartido ni en un documento que circule.
- Si se filtró, mandale **`/revoke`** a @BotFather: te da un token nuevo y el viejo deja de servir en el acto. Después pegá el nuevo en Vocero, en **Canales → el canal → Editar**.
- Mientras el token viejo esté en Vocero y el nuevo en Telegram, el canal no funciona: por eso conviene hacer las dos cosas seguidas.

## Cosas que vas a notar al usarlo

- **El cliente tiene que tocar "Empezar" primero.** Es una regla de Telegram: un bot no puede escribirle a nadie que no le haya escrito antes. Por eso el enlace que compartas conviene que sea `t.me/TuBot`, que abre el chat con el botón puesto.
- **No hay plazo para contestar.** A diferencia de WhatsApp o Instagram, en Telegram se puede responder cuando sea.
- **Archivos:** tus clientes pueden mandar hasta 20 MB (es lo que un bot puede descargar) y tus agentes hasta 50 MB. Fotos, audios, videos, documentos y stickers viajan en los dos sentidos.
- **Las reacciones con emoji se ven.** Si un cliente reacciona a un mensaje, el agente lo ve en su chat; no abre una conversación nueva ni cuenta como consulta.
- **La encuesta de satisfacción** —si la tenés activada— usa la encuesta nativa de Telegram: el cliente toca una opción en vez de escribir un número.
- **El bot no lee lo que se hable en grupos.** Está en modo privacidad, que es lo que corresponde: solo recibe lo que le escriben a él.