Repolode
bostrot

bostrot/telegram-support-bot

Telegram이나 Signal 메시지를 직원 그룹의 티켓으로 전환하고, 선택적으로 LLM 자동 답변을 제공하는 셀프 호스팅 지원 봇입니다.

대체할 수 있는 제품:ZendeskIntercom

스타
615
포크
205
열린 이슈
7
마지막 커밋
19시간 전

어떤 프로젝트인가요?

Telegram Support Bot (TSB)을 사용하면 사용자가 Telegram이나 Signal에서 봇에 메시지를 보낼 수 있습니다. 각 메시지는 직원 그룹에 티켓으로 게시되며, 관리자는 해당 메시지에 답글을 달아 응답합니다. 사진과 파일은 양방향으로 전달되고, 봇이 자동으로 인사말을 덧붙입니다.

기본 티켓 관리 외에도 담당자 지정, 우선순위, 태그, 내부 메모, 미리 작성한 답변, 서로 다른 직원 그룹으로 전달되는 카테고리, 에스컬레이션 규칙, 오래된 티켓 자동 종료, 업무 시간 설정을 지원합니다. 분석 기능으로는 /stats 명령어, 일일 요약, CSAT 설문, HMAC 서명이 포함된 웹훅이 있습니다. 웹 채팅 위젯과 실험 단계의 Slack 및 Discord 애드온도 제공됩니다.

선택 사항인 LLM 통합은 OpenAI 또는 OpenAI 호환 엔드포인트를 지원합니다. 직접 제공한 지식 베이스를 바탕으로 질문에 답하고, 답변을 찾지 못하면 일반 티켓으로 전환하며, 티켓 분류와 직원 답변 번역도 할 수 있습니다. 이 프로젝트는 Node.js 24+와 MongoDB를 사용하거나 Docker Compose 스택으로 실행할 수 있습니다.

핵심 기능

  • 01사용자 메시지를 직원 그룹에 티켓으로 전달하고, 직원은 답글로 응답합니다.
  • 02담당자 지정, 우선순위, 태그, 내부 메모, 미리 작성한 답변을 지원합니다.
  • 03카테고리에 따라 티켓을 서로 다른 직원 그룹으로 전달합니다.
  • 04Telegram이나 Signal을 지원하며, 삽입 가능한 웹 채팅 위젯도 제공합니다.
  • 05자체 지식 베이스를 바탕으로 선택적 LLM 자동 답변을 제공하고, AI 티켓 분류와 번역도 지원합니다.
  • 06웹훅, CSAT 설문, 분석 명령어를 제공합니다.

활용 사례

  • 직원이 Telegram 그룹에서 직접 답변하는 고객 지원 요청을 처리합니다.
  • 팀 받은편지함을 활용해 Signal에서 커뮤니티나 제품 지원 채널을 운영합니다.
  • FAQ 형식의 지식 베이스를 바탕으로 반복 질문에 자동으로 답하고, 나머지는 담당자에게 전달합니다.
  • 서명된 웹훅으로 티켓 이벤트를 다른 시스템에 연동합니다.

빠른 시작

  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 형식의 지식 베이스를 바탕으로 반복 질문에 자동으로 답하고, 나머지는 담당자에게 전달합니다. 서명된 웹훅으로 티켓 이벤트를 다른 시스템에 연동합니다.
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

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트