bostrot/telegram-support-bot

これは何？

主な機能

• 01ユーザーのメッセージをチケットとしてスタッフ用グループに転送し、スタッフは返信して対応できます。
• 02担当者の割り当て、優先度、タグ、内部メモ、定型文に対応しています。
• 03カテゴリに応じて、チケットを異なるスタッフ用グループに振り分けます。
• 04TelegramまたはSignalで利用でき、埋め込み可能なWebチャットウィジェットも備えています。
• 05独自のナレッジベースを使ったオプションのLLM自動返信に加え、AIによるトリアージと翻訳にも対応しています。
• 06Webhook、CSATアンケート、分析用コマンドを利用できます。

ユースケース

• スタッフが直接返信するTelegramグループを通じて、カスタマーサポートの問い合わせに対応する。
• チーム用の受信トレイを備えたSignal上のコミュニティや製品サポート窓口を運営する。
• FAQ形式のナレッジベースを使って繰り返し寄せられる質問に自動回答し、それ以外を人間に引き継ぐ。
• 署名付きWebhookを使って、チケットのイベントを他のシステムに連携する。

クイックスタート

1. 1

   サンプル設定ファイルをコピーします

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

   config.yaml で bot_token、staffchat_id、owner_id を設定し、Docker Compose スタックを起動します

   docker compose up -d

使う前に知っておきたいこと

• !Docker を使わずに実行するには、Node.js 24 以降と MongoDB インスタンスが必要です。
• !バージョン 5 には互換性を損なう変更が含まれており、以前のバージョンからアップグレードする際は設定の更新が必要です。
• !AI による自動返信（任意）には、OpenAI または互換性のある API キーが必要です。

トピック

よくある質問

telegram-support-bot とは？

TelegramやSignalのメッセージをスタッフ用グループのチケットに変換し、LLMによる自動返信にも対応するセルフホスト型サポートボット。 Telegram Support Bot (TSB)を使うと、ユーザーはTelegramまたはSignal上でボットにメッセージを送れます。各メッセージはスタッフ用グループにチケットとして投稿され、管理者はそのメッセージに返信して対応します。写真やファイルは双方向に転送され、ボットが自動で挨拶を追加します。

telegram-support-bot は無料で使えますか？ライセンスは？

telegram-support-bot は GPL-3.0 ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。

telegram-support-bot は今もメンテナンスされていますか？

活発にメンテナンス中。telegram-support-bot の最終コミットは 2026年10月20日 です。

telegram-support-bot は何に使えますか？

スタッフが直接返信するTelegramグループを通じて、カスタマーサポートの問い合わせに対応する。 チーム用の受信トレイを備えたSignal上のコミュニティや製品サポート窓口を運営する。 FAQ形式のナレッジベースを使って繰り返し寄せられる質問に自動回答し、それ以外を人間に引き継ぐ。 署名付きWebhookを使って、チケットのイベントを他のシステムに連携する。

telegram-support-bot のインストール方法は？

サンプル設定ファイルをコピーします: cp config/config-sample.yaml config/config.yaml config.yaml で bot_token、staffchat_id、owner_id を設定し、Docker Compose スタックを起動します: docker compose up -d

telegram-support-bot はどこで入手できますか？

ソースコードとインストール手順は GitHub にあります：https://github.com/bostrot/telegram-support-bot