Telegram

Conecta un bot de Telegram a Zelta Chat para recibir y responder mensajes de clientes que te contacten a través de esta plataforma de mensajería. Ideal para equipos que atienden mercados donde Telegram es popular.

Requisitos previos

Antes de comenzar

• Una cuenta de Telegram activa
• Familiaridad básica con BotFather (el bot oficial de Telegram para crear bots)

Configuración paso a paso

Paso 1: Crear un bot con BotFather

1. Abre Telegram y busca @BotFather.
2. Inicia una conversación y envía el comando /newbot.
3. BotFather te pedirá un nombre para tu bot (el nombre visible, ej: "Soporte Mi Empresa").
4. Luego te pedirá un username (debe terminar en bot, ej: miempresa_soporte_bot).
5. BotFather generará un Token de API. Copia este token, lo necesitarás en el siguiente paso.

Importante

El token de API otorga control total sobre tu bot. No lo compartas públicamente ni lo incluyas en código del lado del cliente.

Paso 2: Configurar el bot (opcional)

Puedes personalizar tu bot con estos comandos de BotFather:

Comando	Descripción
/setdescription	Define la descripción que ven los usuarios al iniciar el chat
/setabouttext	Define el texto "Acerca de" del perfil del bot
/setuserpic	Establece la foto de perfil del bot
/setcommands	Define la lista de comandos disponibles

Paso 3: Conectar en Zelta Chat

1. En Zelta Chat, ve a Ajustes > Canales > + Agregar canal.
2. Selecciona Telegram.
3. Completa los campos:

Campo	Descripción
Nombre del canal	Nombre descriptivo (ej: "Telegram Soporte")
Token del bot	El token proporcionado por BotFather

4. Haz clic en Crear canal.

Zelta Chat configurará automáticamente el webhook de tu bot para recibir mensajes.

Paso 4: Verificar la conexión

1. Abre Telegram y busca tu bot por su username.
2. Inicia una conversación enviando /start o cualquier mensaje.
3. El mensaje debe aparecer en la bandeja de entrada de Zelta Chat.

Funcionalidades soportadas

Tipos de contenido

Tipo	Enviar	Recibir	Notas
Texto	Sí	Sí	Sin límite práctico de caracteres
Imágenes	Sí	Sí	JPEG, PNG, GIF
Videos	Sí	Sí	MP4 (hasta 50 MB)
Documentos	Sí	Sí	Cualquier formato (hasta 50 MB)
Audio	Sí	Sí	MP3, OGG
Mensajes de voz	No	Sí	Se reciben como archivos de audio
Stickers	No	Sí	Se muestran como imagen en la conversación
Ubicación	No	Sí	Se muestra en la conversación con coordenadas
Contactos	No	Sí	Se muestra la información del contacto compartido

Comandos del bot

Configura comandos personalizados que los usuarios pueden ejecutar al escribir /:

1. En BotFather, usa el comando /setcommands.
2. Define los comandos disponibles:

inicio - Iniciar una conversación
ayuda - Ver opciones de ayuda
horario - Consultar horarios de atención
contacto - Información de contacto

Cuando un usuario ejecute un comando, el texto se recibirá como un mensaje normal en Zelta Chat y podrás configurar automatizaciones basadas en su contenido.

Configuración del webhook

Zelta Chat configura el webhook de tu bot automáticamente al crear el canal. Si necesitas verificar o reconfigurar:

1. Ve a Ajustes > Canales > [Tu canal de Telegram].
2. En la sección Webhook, verifica que la URL sea correcta.
3. Haz clic en Reconfigurar webhook si es necesario.

Nota técnica

Cada bot de Telegram solo puede tener un webhook activo. Si conectas el mismo bot a otra herramienta, la conexión con Zelta Chat se interrumpirá.

Limitaciones

Limitación	Detalle
Iniciar conversaciones	El bot no puede enviar el primer mensaje; el usuario debe escribir primero o usar /start
Grupos	Los mensajes de grupos no se sincronizan con Zelta Chat
Llamadas	No soportadas a través del bot
Pagos	La funcionalidad de pagos de Telegram no está integrada
Botones inline	No se pueden enviar desde Zelta Chat; solo se reciben
Edición de mensajes	Los mensajes editados por el usuario se reciben como una actualización

Solución de problemas

Problema	Solución
No se reciben mensajes	Verifica que el token sea correcto y el webhook esté configurado
Bot no responde	Confirma que el canal esté activo en Zelta Chat
Error de token inválido	Genera un nuevo token con BotFather usando /revoke y actualiza la configuración
Webhook no se configura	Verifica que no haya otro servicio usando el webhook del bot
Mensajes duplicados	Asegúrate de que el bot solo esté conectado a Zelta Chat

Consejo

Puedes verificar el estado del webhook de tu bot visitando https://api.telegram.org/bot<TU_TOKEN>/getWebhookInfo en tu navegador.