Saltar al contenido
vocero.net

Documentación

Conectar un bot de Telegram

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

Versión en Markdown — para copiar entera o dársela a una IA

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.

Última actualización: