必要なもの
- 当サービスで設定済みで、有料プラン(ベーシック、スタンダード、エリート、エンタープライズのいずれか)をご利用中のウェブサイト。まだの場合はメールアドレスで登録し、ウェブサイトのアドレスを入力してください。
- 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-assistantAstrBot での設定
- AstrBot のダッシュボードを開き、Providers に移動します。Chat Completion タブで、Provider Sources の横にある + Add を押します。
- New model provider で OpenAI Compatible を選びます。
- わかりやすい ID(例:
7x24hrs)をつけます。API Key にキーを貼り付け、API Base URL にhttps://7x24hrs.com/v1を入力します。 - Save And Fetch Models を押します。Available Models の下で、
7x24hrs-assistantの横にある + を押します。開いたウィンドウで、Model capabilities の Text だけにチェックを入れた状態にして(Image、Audio、Tool use のチェックは外します。アシスタントはテキストで回答します)、Save を押します。 - ボットがこのモデルを使うようにします。Config でデフォルトのチャットモデルに選びます(一つの会話だけで使う場合は、Chat のモデル切り替えで選びます)。
- 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?"}]}'"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?"}]}'チャットアプリでの回答の仕組み
| ウェブサイトのチャットボタン | API 経由のチャットアプリ | |
|---|---|---|
| 回答の情報源 | ウェブサイトの情報、定型回答、キャラクター | 同じ |
| 確信が持てない時 | そう伝えて、訪問者をあなたに引き継ぐ | そう伝えて、回答の中であなたの連絡先を案内する |
| あなたへの通知 | メール、Slack、Discord、Telegram | 同じ(「API / AstrBot 経由」と表示) |
| 訪問者に自分で答える | チャットアプリかダッシュボードから | ここからはできません。メールで返信してください |
| 会話のカウント | 訪問者と会話ごとに一件 | 同じ(同じ月間の枠から) |
チャットアプリはどのプランで使えますか?
すべての有料プランで使えます。ベーシックは月$19で90件、スタンダードは$59で275件、エリートは$199で1,000件、エンタープライズは$1,099で6,000件の会話です。API 経由の会話は、チャットボタンと同じ月間の枠でカウントされます。無料プランにはチャットアプリは含まれず、無料プランで作成したキーは有料プランを選ぶまで一時停止されます。詳しくは料金をご覧ください。
何が会話一件になりますか?
チャットボタンとまったく同じで、一人の訪問者とのやり取りが、質問の数にかかわらず一件です。リクエストごとに user フィールドを送るツールなら訪問者を区別できます。そうでない場合は、最初のメッセージで会話を見分けます。
AstrBot のシステムプロンプトでアシスタントの発言を変えられますか?
いいえ。チャットアプリから送られたシステムプロンプトには従いません。アシスタントはあなたのルールを守り、ウェブサイトの情報だけをもとに答え、分からないことは分からないと伝え、ウェブサイトに書かれていないことは約束しません。キャラクターはダッシュボードで設定したものです。
画像、音声メッセージ、ツール呼び出しには対応していますか?
まだ対応していません。回答するのはテキストのみで、画像などの添付ファイルはメッセージから除かれ、テキストのないメッセージにはわかりやすいエラーを返します。クライアントから送られたツール定義は無視されます。
キーが漏れてしまったら?
チャットアプリと API で無効にしてください。すぐに使えなくなります。そのあと新しいキーを作成し、ツールに貼り付けてください。キーはフィンガープリントとしてのみ保存されているため、当社でもキーを再表示することはできません。