導入ガイド

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 で無効にしてください。すぐに使えなくなります。そのあと新しいキーを作成し、ツールに貼り付けてください。キーはフィンガープリントとしてのみ保存されているため、当社でもキーを再表示することはできません。

出典