安裝整合

用 AstrBot 在 Discord、Telegram 等聊天軟體裡回答

您的助理在網站之外也能回答。把它新增為 OpenAI 相容的模型供應商:可以加到 AstrBot(一個開源聊天機器人框架,支援 Discord、Telegram、Slack、WeChat、QQ 等),也可以加到 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,填入模型名稱、您的金鑰,並把 Base URL 填為 API 端點,然後在應用中使用這個模型。
  • LobeChat:在設定的語言模型區塊開啟 OpenAI 供應商,填入金鑰,把 API 代理位址設為 Base URL,再把 7x24hrs-assistant 加進模型清單。
  • 您自己的程式:用任何 OpenAI 用戶端函式庫呼叫 API,設定好 Base URL 和金鑰即可。

在終端機裡試試 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 後,回答會以伺服器推送事件(SSE)的形式逐段傳回,與 OpenAI 的方式相同:

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 中撤銷它:它會立即失效。接著建立一把新金鑰,貼到您的工具裡。金鑰只以指紋形式儲存,所以我們也無法再次顯示某把金鑰。

來源