Repolode
Submit
bostrot

bostrot/telegram-support-bot

A self-hosted support bot that turns Telegram or Signal messages into tickets in a staff group, with optional LLM auto-replies.

Open-source alternative to:ZendeskIntercom

View on GitHubWebsite
Stars
615
Forks
205
Open issues
7
Last commit
18 hours ago

What is it?

Telegram Support Bot (TSB) lets users message a bot on Telegram or Signal. Each message becomes a ticket posted in a staff group, where admins answer by replying to it. Photos and files are forwarded in both directions, and the bot adds a salutation automatically.

Beyond basic ticketing, it supports assignment, priorities, tags, internal notes, canned responses, categories routed to different staff groups, escalation rules, auto-close of stale tickets, and business hours. Analytics include /stats, a daily summary, CSAT surveys and webhooks with HMAC signatures. A web chat widget and experimental Slack and Discord addons are also available.

Optional LLM integration works with OpenAI or any OpenAI-compatible endpoint. It answers questions from a knowledge base you supply, falls back to a normal ticket when the answer isn't covered, and can triage tickets and translate staff replies. The project runs on Node.js 24+ with MongoDB, or via a Docker Compose stack.

Key features

  • 01Forwards user messages to a staff group as tickets, and staff reply to answer.
  • 02Supports assignment, priorities, tags, internal notes and canned responses.
  • 03Routes tickets by category to different staff groups.
  • 04Works with Telegram or Signal, with an embeddable web chat widget.
  • 05Optional LLM auto-replies from your own knowledge base, plus AI triage and translation.
  • 06Provides webhooks, CSAT surveys and analytics commands.

Use cases

  • Handling customer support requests through a Telegram group where staff reply directly.
  • Running a community or product support channel on Signal with a team inbox.
  • Answering repetitive questions automatically from a FAQ-style knowledge base, escalating the rest to humans.
  • Integrating ticket events into other systems through signed webhooks.

Quick start

  1. 1

    Copy the sample config file

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

    Set bot_token, staffchat_id and owner_id in config.yaml, then start the Docker compose stack

    docker compose up -d

Things to know

  • Running without Docker requires Node.js 24+ and a MongoDB instance.
  • Version 5 has breaking changes and requires config updates when upgrading from older versions.
  • Optional AI auto-replies need an OpenAI or compatible API key.

Topics

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

FAQ

What is telegram-support-bot?
A self-hosted support bot that turns Telegram or Signal messages into tickets in a staff group, with optional LLM auto-replies. Telegram Support Bot (TSB) lets users message a bot on Telegram or Signal. Each message becomes a ticket posted in a staff group, where admins answer by replying to it. Photos and files are forwarded in both directions, and the bot adds a salutation automatically.
Is telegram-support-bot free to use? What license does it have?
telegram-support-bot is open source under the GPL-3.0 license. Check the license terms before using it in commercial products.
Is telegram-support-bot still maintained?
Actively maintained. The last commit to telegram-support-bot was on Oct 20, 2026.
What can I use telegram-support-bot for?
Handling customer support requests through a Telegram group where staff reply directly. Running a community or product support channel on Signal with a team inbox. Answering repetitive questions automatically from a FAQ-style knowledge base, escalating the rest to humans. Integrating ticket events into other systems through signed webhooks.
How do I install telegram-support-bot?
Copy the sample config file: cp config/config-sample.yaml config/config.yaml Set bot_token, staffchat_id and owner_id in config.yaml, then start the Docker compose stack: docker compose up -d
Where can I get telegram-support-bot?
The source code and installation instructions are on GitHub: https://github.com/bostrot/telegram-support-bot

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects