Cómo conectar Telegram mediante un Bot personalizado

• Categoría: Canales y bandejas de entrada
• Disponibilidad: Incluido en todos los planes (Estándar, Premium y Evolución)
• Tiempo estimado de configuración: 4 minutos
• Rol necesario: Administrador

El canal de Telegram en Waclis Inbox te permite ofrecer atención al cliente, soporte técnico y ventas a través de un Bot oficial personalizado con el nombre y logotipo de tu empresa. A diferencia de otros canales, la integración oficial de Telegram no tiene costos por mensaje ni ventanas restrictivas de 24 horas que bloqueen las respuestas a clientes que ya iniciaron el chat. En esta guía aprenderás a crear tu bot paso a paso desde cero usando @BotFather, obtener tu Bot Token, conectarlo en Waclis Inbox y compartir el enlace directo (t.me/TuBot) para que tus clientes inicien conversaciones con tu equipo.

1. ¿Qué puedes hacer y cuándo te sirve?

Crear una bandeja de Telegram en Waclis Inbox ofrece ventajas únicas de velocidad, capacidad de archivos y continuidad:

• Soporte técnico, comunidades digitales y empresas de tecnología / cripto / educación: Si tus clientes o alumnos utilizan Telegram habitualmente, pueden escribir al bot oficial de tu marca (@SoporteMiEmpresaBot) desde su teléfono o computadora, y todos tus agentes recibirán el chat en Waclis Inbox.
• Sin ventana de 24 horas ni costos de plantillas: Una vez que el cliente abre tu bot en Telegram y pulsa Iniciar (Start), tus agentes pueden responderle hoy, dentro de tres días o el mes próximo con texto libre, imágenes, documentos PDF o audios sin cargos por mensaje.
• Canal de contingencia de alta estabilidad: Funciona íntegramente en la nube de Telegram mediante API HTTP; no requiere tener ningún teléfono encendido ni renovar tokens periódicamente.

2. Antes de comenzar (Requisitos previos)

Para completar este tutorial solo necesitas dos cosas:

1. Una cuenta activa de Telegram (en tu teléfono móvil o en Telegram Desktop/Web) para conversar con el asistente oficial @BotFather y crear el bot de tu marca.
2. Rol de Administrador en Waclis Inbox para ingresar a Ajustes → Entradas → + Añadir bandeja de entrada.

3. Paso a paso: Crear el Bot en Telegram y conectarlo en Waclis Inbox

El proceso consta de dos partes muy breves: primero generas la credencial (Bot Token) dentro de Telegram con @BotFather y luego la pegas en Waclis Inbox.

Parte 1: Crear tu Bot oficial en Telegram con @BotFather

1. Abre tu aplicación de Telegram y en el buscador superior escribe @BotFather (verifica que tenga la tilde azul de verificación oficial de Telegram al lado del nombre BotFather).
2. Abre el chat con BotFather y presiona el botón Iniciar (o envía el comando /start).
3. Escribe y envía el comando /newbot para crear un bot nuevo.
4. Define el nombre visible de tu bot: BotFather te preguntará "Alright, a new bot. How are we going to call it?". Escribe el nombre comercial que verán tus clientes en la cabecera del chat (por ejemplo: Soporte Tienda Oficial o Atención Waclis) y envíalo.
5. Define el nombre de usuario (username) del bot: A continuación, BotFather te pedirá un nombre de usuario único que debe terminar obligatoriamente con la palabra bot o -bot (sin espacios, por ejemplo: TiendaOficialSoporteBot o miempresa-atencion-bot).
6. Copia el Bot Token generado: En cuanto el nombre de usuario sea aceptado, BotFather te enviará un mensaje de confirmación que incluye:

• El enlace directo a tu bot (ej. t.me/TiendaOficialSoporteBot).
• Tu clave secreta bajo la línea "Use this token to access the HTTP API:" (tiene el formato 1234567890:AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsaw). Copia ese token completo.

Parte 2: Conectar el Bot en Waclis Inbox

Con el token copiado en tu portapapeles, regresa a Waclis Inbox:

1. En la barra lateral izquierda, ve a Ajustes (icono de engranaje) → Entradas y haz clic en el botón + Añadir bandeja de entrada.
2. En el Paso 1: Elegir canal, haz clic sobre la tarjeta Telegram (Configura el canal de Telegram usando un token de bot).
3. En el Paso 2: Crear bandeja de entrada (pantalla Canal de Telegram), verás un único campo llamado Bot Token. Pega allí el token HTTP API que te entregó @BotFather.
4. Haz clic en el botón Crear canal de Telegram.
5. Waclis Inbox se conectará automáticamente con los servidores de Telegram, tomará el nombre de tu bot, registrará el webhook en segundo plano y avanzará al Paso 3: Añadir agentes.
6. Selecciona en el desplegable Elegir agentes para la bandeja de entrada a los miembros de tu equipo que atenderán las consultas de Telegram y haz clic en Añadir agentes.
7. En la pantalla ¡Tu bandeja de entrada está lista!, haz clic en Llévame allí.

4. Qué significa cada parámetro y cómo funciona el canal Telegram

5. Otras formas de hacerlo y atajos rápidos

• Probar tu bot en 10 segundos: Apenas termines el Paso 6 en Waclis Inbox, abre desde tu teléfono el enlace t.me/NombreDeTuBot que te dio @BotFather, pulsa Iniciar y escribe "Hola". Verás cómo la conversación entra en vivo en la bandeja de Waclis Inbox con tu nombre de usuario de Telegram.
• Colaboración interna en el chat: Mientras atiendes a un usuario de Telegram, puedes usar la pestaña Nota Privada para etiquetar a compañeros con @, cambiar la prioridad de la conversación a Alta o Urgente o usar la barra de comandos Ctrl + K (Cmd + K) para asignarla a otro departamento.

6. Cómo combinarlo con otras funciones de Waclis Inbox

• Agente de IA Capitán en Telegram (Configuración del bot): Entra a Ajustes → Entradas → [Tu bandeja de Telegram] → pestaña Configuración del bot y selecciona tu asistente de Capitán. De esta manera, tu bot de Telegram dejará de ser un simple buzón de recepción y se convertirá en un asistente de Inteligencia Artificial capaz de responder preguntas frecuentes basándose en tus documentos las 24 horas.
• Horarios de atención (Horarios): Configura tus días y horas hábiles en la pestaña Horarios de la bandeja de Telegram para que, si un usuario escribe fuera de horario, reciba automáticamente el Mensaje no disponible para visitantes.
• Reglas de automatización (Ajustes → Automatización): Como el primer mensaje que envía Telegram cuando un usuario pulsa el botón Iniciar suele ser /start, puedes crear una regla inmediata con el evento Mensaje creado, condición Bandeja de entrada Igual a [Telegram] y Contenido del mensaje Igual a /start, para que ejecute la acción Enviar mensaje dándole una bienvenida personalizada con las opciones de atención de tu empresa.

7. Relación con el ecosistema Waclis

• Waclis (Tienda Online) y WaclisCAL: Puedes publicar el botón o enlace de tu bot de Telegram en tu tienda online o página de reservas para aquellos clientes que prefieren Telegram como canal de consulta rápida.
• Waclis Factur y WaclisPOS: Cuando un cliente que se comunica por Telegram realiza una compra, el agente puede adjuntarle o enviarle el enlace del comprobante electrónico emitido en Waclis Factur directamente dentro de su chat de Telegram.
• Waclis Connect: Si durante la conversación en Telegram el cliente te indica su correo electrónico o número telefónico en formato internacional (+E.164), puedes registrarlo en su ficha de Contacto en el panel lateral derecho para vincular su perfil de Telegram con el resto de sus interacciones en el ecosistema.

8. Problemas frecuentes y cómo resolverlos

8.1 Al pegar el Bot Token y pulsar Crear canal de Telegram aparece un mensaje de error

• Síntoma: Waclis Inbox indica que no se pudo crear el canal o que el token es inválido.
• Causa probable: Copiaste el token con espacios en blanco al principio o al final, omitiste la primera parte numérica antes de los dos puntos (:), o ese mismo bot ya está agregado como bandeja de entrada en Waclis Inbox.
• Cómo resolverlo: Verifica en tu chat con @BotFather la cadena exacta del token (debe tener el formato números:letras-y-guiones sin espacios). Si tienes dudas de que el token haya sido revocado, envía el comando /token a @BotFather, selecciona tu bot y copia el token vigente.

8.2 La bandeja de Telegram dejó de recibir mensajes después de que conectamos el mismo bot en otra plataforma

• Síntoma: El canal funcionaba bien en Waclis Inbox, pero un desarrollador usó el mismo Bot Token para hacer una prueba en otra herramienta externa y desde entonces los mensajes no llegan a Inbox.
• Causa probable: La API oficial de Telegram solo permite una URL de Webhook activa por cada Bot. Cuando otra aplicación registra su propio webhook con ese token, sobrescribe automáticamente el webhook de Waclis Inbox.
• Cómo resolverlo: No compartas el mismo Bot Token entre dos sistemas distintos. Si necesitas integrar automatizaciones externas (como n8n o un ERP), hazlo conectando los Webhooks de Waclis Inbox (Ajustes → Integraciones → Webhooks o mediante la acción Enviar Evento de Webhook en Automatización) en lugar de quitarle el webhook a Telegram.

8.3 Quiero iniciar un chat con un cliente por Telegram buscando su número de teléfono desde Waclis Inbox

• Síntoma: Creas un contacto con su número de celular e intentas enviarle un primer mensaje por la bandeja de Telegram sin que él haya hablado antes.
• Causa probable: Por restricción de privacidad de Telegram a nivel global, ningún Bot de Telegram puede iniciar una conversación con un usuario que no haya abierto el bot primero y pulsado Iniciar (/start).
• Cómo resolverlo: Para contactar proactivamente a un cliente por su número telefónico utiliza tus bandejas de WhatsApp o SMS, o bien envíale el enlace https://t.me/TuBot para que inicie el vínculo en Telegram.

9. Preguntas frecuentes (FAQ)

¿Conectar Telegram en Waclis Inbox tiene algún costo adicional por mensaje cobrado por Telegram?

No. La API de Bots de Telegram (@BotFather) es gratuita y no cobra tarifas por mensaje enviado ni recibido.

¿Puedo conectar mi cuenta personal de Telegram por número de teléfono o código QR como en WhatsApp?

El canal nativo de Telegram en Waclis Inbox opera exclusivamente a través de la API Oficial de Bots de Telegram (Bot Token), lo que brinda máxima estabilidad en la nube y permite que toda la atención salga con la identidad corporativa de tu marca.

¿Cómo cambio el nombre o la foto que ven mis clientes en Telegram?

Tanto el nombre visible como la foto de perfil y la descripción de tu bot se administran directamente desde Telegram enviando los comandos /setname, /setuserpic y /setdescription al asistente oficial @BotFather.

10. Artículos relacionados

• Reglas de automatización en tiempo real para triaje y auto-asignación
• Configuración inicial del Agente de IA Capitan: modelos LLM e instrucciones
• Cómo conectar y gestionar canales SMS y Canal API personalizado