연동

AstrBot으로 Discord, Telegram 같은 채팅 앱에서 답하기

어시스턴트는 웹사이트 밖에서도 답할 수 있어요. OpenAI 호환 모델 제공자로, Discord, Telegram, Slack, WeChat, QQ 등을 지원하는 오픈 소스 챗봇 프레임워크 AstrBot에 추가하거나, Dify, LobeChat 등 같은 API를 쓰는 도구에 추가하세요. 그곳에서도 같은 웹사이트 정보를 바탕으로, 채팅 버튼과 같은 표준 답변, 캐릭터, 규칙으로 답해요.

2026년 10월 21일 업데이트

준비할 것

  • 저희 서비스에 설정되어 있고 유료 요금제(베이직, 스탠다드, 엘리트 또는 엔터프라이즈)를 쓰는 웹사이트. 아직 없다면 이메일로 가입하고 웹사이트 주소를 입력하세요.
  • API 키: 대시보드에서 채팅 앱 및 API를 열고, 키 이름(예: “AstrBot”)을 정한 뒤 API 키 만들기를 누르세요. 키는 그때 한 번만 표시되니 바로 복사하세요.
  • 실행 중이고 채팅 앱에 연결된 AstrBot(또는 다른 도구). AstrBot 설치 방법과 Discord, Telegram, Slack, WeChat, QQ 연결 방법은 AstrBot 문서에 나와 있어요.

어떤 도구든 아래 세 가지 값을 입력하면 돼요.

API Base URL:  https://7x24hrs.com/v1
API Key:       sk-7x24-…
Model:         7x24hrs-assistant
예시예요. sk-7x24-… 부분을 대시보드에서 만든 내 키로 바꾸세요.

AstrBot에서 설정하기

  1. AstrBot 대시보드를 열고 Providers로 이동하세요. Chat Completion 탭에서 Provider Sources 옆의 + Add를 누르세요.
  2. New model provider에서 OpenAI Compatible을 선택하세요.
  3. 알아보기 쉬운 ID(예: 7x24hrs)를 정하세요. API Key에 키를 붙여 넣고, API Base URL을 https://7x24hrs.com/v1로 설정하세요.
  4. Save And Fetch Models를 누르세요. Available Models 아래에서 7x24hrs-assistant 옆의 +를 누르세요. 열린 창의 Model capabilities에서 Text만 체크된 상태로 두고(Image, Audio, Tool use는 체크 해제: 어시스턴트는 텍스트로 답합니다) Save를 누르세요.
  5. 봇이 이 모델을 쓰도록 하세요. Config에서 기본 채팅 모델로 선택하세요(대화 하나에서만 쓰려면 Chat의 모델 전환에서 선택하세요).
  6. AstrBot의 Chat 페이지나 연결된 채팅 앱에서 질문해 보세요. 답변은 내 웹사이트 정보에서 나와요.

AstrBot 자체의 페르소나와 시스템 프롬프트는 비워 두거나 짧게 유지하세요. 어시스턴트는 7x24hrs 대시보드에서 정한 규칙과 캐릭터를 따르고, 채팅 앱의 시스템 프롬프트에 있는 지시는 따르지 않아요.

Dify, LobeChat 및 기타 도구

“OpenAI 호환”이나 “사용자 지정 OpenAI” 제공자가 있는 도구라면 모두 같은 방식이에요. Base URL은 https://7x24hrs.com/v1, 그리고 내 API 키와 7x24hrs-assistant 모델을 입력하세요.

  • Dify: 설정 → 모델 제공자에서 OpenAI-API-compatible을 추가하고, 모델 이름, 키, API 엔드포인트로 Base URL을 입력한 뒤 앱에서 그 모델을 사용하세요.
  • LobeChat: 설정의 언어 모델에서 OpenAI 제공자를 켜고 키를 입력한 뒤 API 프록시 주소를 Base URL로 설정하고, 모델 목록에 7x24hrs-assistant를 추가하세요.
  • 직접 작성한 코드: 아무 OpenAI 클라이언트 라이브러리로 Base URL과 키를 설정해 API를 호출하세요.

터미널에서 API를 시험해 보려면:

curl https://7x24hrs.com/v1/chat/completions \
  -H "Authorization: Bearer sk-7x24-…" \
  -H "Content-Type: application/json" \
  -d '{"model": "7x24hrs-assistant", "user": "visitor-42",
       "messages": [{"role": "user", "content": "Do you ship to Canada?"}]}'
예시예요. sk-7x24-… 부분을 대시보드에서 만든 내 키로 바꾸세요.

"stream": true를 넣으면 OpenAI와 같은 방식으로 답변이 Server-Sent Events로 도착해요.

curl -N https://7x24hrs.com/v1/chat/completions \
  -H "Authorization: Bearer sk-7x24-…" \
  -H "Content-Type: application/json" \
  -d '{"model": "7x24hrs-assistant", "stream": true,
       "messages": [{"role": "user", "content": "Do you ship to Canada?"}]}'
예시예요. sk-7x24-… 부분을 대시보드에서 만든 내 키로 바꾸세요.

채팅 앱에서 답변이 이루어지는 방식

웹사이트의 채팅 버튼API를 통한 채팅 앱
답변의 근거웹사이트 정보, 표준 답변, 캐릭터같음
확실하지 않을 때그렇다고 말하고 방문자를 나에게 넘겨요그렇다고 말하고 답변에 내 연락처를 알려 줘요
나에게 오는 알림이메일, Slack, Discord, Telegram같음(“API / AstrBot 경유” 표시)
방문자에게 직접 답하기채팅 앱이나 대시보드에서여기서는 불가: 이메일로 답하세요
대화 집계방문자와 대화마다 한 건같음(같은 월 사용량에서 차감)
어떤 요금제에서 채팅 앱을 쓸 수 있나요?

모든 유료 요금제에서 쓸 수 있어요. 베이직은 월 $19에 90건, 스탠다드는 $59에 275건, 엘리트는 $199에 1,000건, 엔터프라이즈는 $1,099에 6,000건이에요. API를 통한 대화는 채팅 버튼과 같은 월 사용량으로 집계돼요. 무료 요금제에는 채팅 앱이 포함되지 않아요. 무료 요금제에서 만든 키는 유료 요금제를 선택할 때까지 일시 중지돼요. 요금을 확인하세요.

무엇을 대화 한 건으로 세나요?

채팅 버튼과 똑같이, 방문자 한 명과의 대화가 질문 수와 관계없이 한 건이에요. 요청마다 user 필드를 보내는 도구라면 방문자를 구분할 수 있고, 그렇지 않으면 첫 메시지로 대화를 구분해요.

AstrBot의 시스템 프롬프트로 어시스턴트의 답변을 바꿀 수 있나요?

아니요. 채팅 앱이 보낸 시스템 프롬프트는 따르지 않아요. 어시스턴트는 내 규칙을 지켜요. 웹사이트 정보만 바탕으로 답하고, 모르면 모른다고 말하고, 웹사이트에 없는 내용은 약속하지 않아요. 캐릭터는 대시보드에서 정한 그대로예요.

사진, 음성 메시지, 도구 호출도 지원하나요?

아직은 지원하지 않아요. 텍스트에만 답하고, 사진 같은 첨부 파일은 메시지에서 빠지며, 텍스트가 없는 메시지에는 알기 쉬운 오류를 돌려줘요. 클라이언트가 보낸 도구 정의는 무시해요.

키가 유출되면 어떻게 하나요?

채팅 앱 및 API에서 키를 폐기하세요. 바로 작동을 멈춰요. 그다음 새 키를 만들어 도구에 붙여 넣으세요. 키는 지문(fingerprint) 형태로만 저장되므로 저희도 키를 다시 보여 드릴 수 없어요.

출처