Repolode
Enviar
bostrot

bostrot/telegram-support-bot

Um bot de suporte self-hosted que transforma mensagens do Telegram ou Signal em tickets em um grupo da equipe, com respostas automáticas opcionais via LLM.

Alternativa open source a:ZendeskIntercom

Ver no GitHubSite
Estrelas
615
Forks
205
Issues abertas
7
Último commit
há 19 horas

O que é?

O Telegram Support Bot (TSB) permite que usuários enviem mensagens para um bot no Telegram ou Signal. Cada mensagem vira um ticket publicado em um grupo da equipe, onde os admins respondem diretamente. Fotos e arquivos são encaminhados nos dois sentidos, e o bot adiciona uma saudação automaticamente.

Além do sistema básico de tickets, o bot oferece atribuição, prioridades, tags, notas internas, respostas prontas, categorias encaminhadas para diferentes grupos da equipe, regras de escalonamento, fechamento automático de tickets sem atividade e horário comercial. As análises incluem /stats, um resumo diário, pesquisas CSAT e webhooks com assinaturas HMAC. Também há um widget de chat para web e addons experimentais para Slack e Discord.

A integração opcional com LLM é compatível com OpenAI ou qualquer endpoint compatível com OpenAI. Ela responde a perguntas com base em uma base de conhecimento fornecida por você, cria um ticket normal quando a resposta não está coberta e pode fazer a triagem dos tickets e traduzir as respostas da equipe. O projeto roda com Node.js 24+ e MongoDB ou por meio de uma stack Docker Compose.

Recursos principais

  • 01Encaminha mensagens dos usuários para um grupo da equipe como tickets, que são respondidos pela própria equipe.
  • 02Oferece atribuição, prioridades, tags, notas internas e respostas prontas.
  • 03Encaminha tickets por categoria para diferentes grupos da equipe.
  • 04Funciona com Telegram ou Signal e inclui um widget de chat para incorporar em sites.
  • 05Oferece respostas automáticas opcionais via LLM com base na sua própria base de conhecimento, além de triagem e tradução com IA.
  • 06Disponibiliza webhooks, pesquisas CSAT e comandos de análise.

Casos de uso

  • Atender solicitações de suporte ao cliente por meio de um grupo do Telegram, onde a equipe responde diretamente.
  • Manter um canal de suporte para uma comunidade ou produto no Signal, com uma caixa de entrada para a equipe.
  • Responder automaticamente a perguntas frequentes com base em uma base de conhecimento no estilo FAQ e encaminhar as demais para atendimento humano.
  • Integrar eventos de tickets a outros sistemas por meio de webhooks assinados.

Início rápido

  1. 1

    Copie o arquivo de configuração de exemplo

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

    Defina bot_token, staffchat_id e owner_id em config.yaml e, em seguida, inicie a stack do Docker Compose

    docker compose up -d

Antes de usar

  • Para executar sem Docker, é necessário ter o Node.js 24 ou posterior e uma instância do MongoDB.
  • A versão 5 inclui alterações incompatíveis e exige atualizações na configuração ao migrar de versões anteriores.
  • As respostas automáticas opcionais com IA exigem uma chave de API da OpenAI ou compatível.

Tópicos

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

Perguntas frequentes

O que é telegram-support-bot?
Um bot de suporte self-hosted que transforma mensagens do Telegram ou Signal em tickets em um grupo da equipe, com respostas automáticas opcionais via LLM. O Telegram Support Bot (TSB) permite que usuários enviem mensagens para um bot no Telegram ou Signal. Cada mensagem vira um ticket publicado em um grupo da equipe, onde os admins respondem diretamente. Fotos e arquivos são encaminhados nos dois sentidos, e o bot adiciona uma saudação automaticamente.
telegram-support-bot é gratuito? Qual é a licença?
telegram-support-bot é open source sob a licença GPL-3.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
telegram-support-bot ainda é mantido?
Manutenção ativa. O último commit de telegram-support-bot foi em 20 de out. de 2026.
Para que posso usar telegram-support-bot?
Atender solicitações de suporte ao cliente por meio de um grupo do Telegram, onde a equipe responde diretamente. Manter um canal de suporte para uma comunidade ou produto no Signal, com uma caixa de entrada para a equipe. Responder automaticamente a perguntas frequentes com base em uma base de conhecimento no estilo FAQ e encaminhar as demais para atendimento humano. Integrar eventos de tickets a outros sistemas por meio de webhooks assinados.
Como instalar telegram-support-bot?
Copie o arquivo de configuração de exemplo: cp config/config-sample.yaml config/config.yaml Defina bot_token, staffchat_id e owner_id em config.yaml e, em seguida, inicie a stack do Docker Compose: docker compose up -d
Onde consigo telegram-support-bot?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/bostrot/telegram-support-bot

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados