Repolode
Enviar
bostrot

bostrot/telegram-support-bot

Bot de soporte autoalojado que convierte mensajes de Telegram o Signal en tickets para un grupo de atención, con respuestas automáticas opcionales mediante LLM.

Alternativa open source a:ZendeskIntercom

Ver en GitHubSitio web
Estrellas
615
Forks
205
Issues abiertos
7
Último commit
hace 19 horas

¿Qué es?

Telegram Support Bot (TSB) permite que los usuarios escriban a un bot en Telegram o Signal. Cada mensaje se convierte en un ticket que se publica en un grupo de atención, donde los administradores responden directamente. Las fotos y los archivos se reenvían en ambas direcciones, y el bot añade automáticamente un saludo.

Además de las funciones básicas de gestión de tickets, admite asignaciones, prioridades, etiquetas, notas internas, respuestas predefinidas, categorías que se derivan a distintos grupos de atención, reglas de escalamiento, cierre automático de tickets inactivos y horarios de atención. Las herramientas de analítica incluyen /stats, un resumen diario, encuestas CSAT y webhooks con firmas HMAC. También están disponibles un widget de chat web y complementos experimentales para Slack y Discord.

La integración opcional con LLM funciona con OpenAI o cualquier endpoint compatible con OpenAI. Responde preguntas usando una base de conocimiento que proporcionas, crea un ticket normal si la respuesta no está cubierta y puede clasificar tickets y traducir las respuestas del personal. El proyecto funciona con Node.js 24+ y MongoDB, o mediante una pila de Docker Compose.

Funciones clave

  • 01Reenvía los mensajes de los usuarios a un grupo de atención como tickets, y el personal responde directamente.
  • 02Admite asignaciones, prioridades, etiquetas, notas internas y respuestas predefinidas.
  • 03Deriva los tickets según su categoría a distintos grupos de atención.
  • 04Funciona con Telegram o Signal e incluye un widget de chat web integrable.
  • 05Ofrece respuestas automáticas opcionales mediante LLM basadas en tu propia base de conocimiento, además de clasificación y traducción con IA.
  • 06Incluye webhooks, encuestas CSAT y comandos de analítica.

Casos de uso

  • Gestionar solicitudes de soporte al cliente mediante un grupo de Telegram en el que el personal responde directamente.
  • Atender a una comunidad o a usuarios de un producto por Signal con una bandeja de entrada para el equipo.
  • Responder automáticamente preguntas frecuentes a partir de una base de conocimiento y derivar las demás al personal.
  • Integrar eventos de tickets en otros sistemas mediante webhooks firmados.

Inicio rápido

  1. 1

    Copia el archivo de configuración de ejemplo

    cp config/config-sample.yaml config/config.yaml
  2. 2

    Configura bot_token, staffchat_id y owner_id en config.yaml y, después, inicia la pila de Docker Compose

    docker compose up -d

Antes de usarlo

  • Para ejecutarlo sin Docker, necesitas Node.js 24 o posterior y una instancia de MongoDB.
  • La versión 5 incluye cambios incompatibles y requiere actualizar la configuración al actualizar desde versiones anteriores.
  • Las respuestas automáticas opcionales con IA requieren una clave de API de OpenAI o compatible.

Temas

#telegram-bot#ticketing#support#customer-support#signal#llm#typescript#self-hosted#bot#staff-groups

Preguntas frecuentes

¿Qué es telegram-support-bot?
Bot de soporte autoalojado que convierte mensajes de Telegram o Signal en tickets para un grupo de atención, con respuestas automáticas opcionales mediante LLM. Telegram Support Bot (TSB) permite que los usuarios escriban a un bot en Telegram o Signal. Cada mensaje se convierte en un ticket que se publica en un grupo de atención, donde los administradores responden directamente. Las fotos y los archivos se reenvían en ambas direcciones, y el bot añade automáticamente un saludo.
¿telegram-support-bot es gratuito? ¿Qué licencia tiene?
telegram-support-bot es open source bajo la licencia GPL-3.0. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿telegram-support-bot sigue mantenido?
Mantenimiento activo. El último commit de telegram-support-bot fue el 20 oct 2026.
¿Para qué puedo usar telegram-support-bot?
Gestionar solicitudes de soporte al cliente mediante un grupo de Telegram en el que el personal responde directamente. Atender a una comunidad o a usuarios de un producto por Signal con una bandeja de entrada para el equipo. Responder automáticamente preguntas frecuentes a partir de una base de conocimiento y derivar las demás al personal. Integrar eventos de tickets en otros sistemas mediante webhooks firmados.
¿Cómo se instala telegram-support-bot?
Copia el archivo de configuración de ejemplo: cp config/config-sample.yaml config/config.yaml Configura bot_token, staffchat_id y owner_id en config.yaml y, después, inicia la pila de Docker Compose: docker compose up -d
¿Dónde consigo telegram-support-bot?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/bostrot/telegram-support-bot

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados