GetMyBot 知識庫

整合

連接 Google 試算表、雲端硬碟、GetCourse 或 AI:先保存存取設定,再在反應中選擇對應動作。

本頁內容

整合讓機器人與其他服務交換資料,例如把申請加入 Google 試算表,或將客戶送到 GetCourse。設定分兩步:先保存連接,再在反應動作中選擇它。

開啟整合 → 新增整合,選擇服務並填寫欄位。憑證會加密儲存;連接卡片可啟用、停用或按設定修改。

可連接的服務

  • AI:OpenAI 相容 API 的語言模型。詳見 AI 回覆與代理。
  • Google Sheets:按欄標題新增、讀取、搜尋及更新列。詳見動作。
  • Google Drive:上傳檔案到資料夾。
  • GetCourse:建立及更新使用者、交易,匯出使用者、交易和群組。
  • Webhook:透過 HTTP 把資料送到其他服務。
  • 外部處理器:透過持續的 WebSocket 連接,把反應交給自己的程式。詳見外部處理器。

Google 日曆不在此頁連接,而是在AI → 日曆透過 OAuth 授權並設定會議類型;詳見會議與 Google 日曆。

amoCRM/Kommo、Bitrix24、RetailCRM 和 OzmaCRM 在整合 → CRM 另行設定,可對應欄位、預先檢查、查看交換記錄並解決衝突,資料雙向同步。amoCRM/Kommo 使用 OAuth,RetailCRM 用 API 金鑰,OzmaCRM 用 OIDC,Bitrix24 用入口 Webhook。詳見 CRM 整合。

設定

新增連接時,選服務、輸入名稱,並填寫對應欄位。

Webhook

  • Webhook URL:接收端網址。
  • HMAC 簽章(秘密值):接收端用來驗證請求來自 GetMyBot;簽章位於 X-Signature: sha256=... 標頭。

GetCourse

填寫帳號(例如學校名稱 myschool)、API 秘密金鑰,並選擇使用者或交易物件。

匯入 GetCourse 時,欄位按官方 API 分為使用者(email、phone、first_name、last_name、city、country、group_name)、匯入設定(如 refresh_if_exists)、流量來源(utm_source、utm_campaign、referer)、交易(offer_code、deal_cost、deal_status、deal_is_paid)及其他使用者欄位。值可取自 {{param.email}} 等客戶資料,或直接輸入 utm_source = telegram 等固定值。

群組及自訂欄位提示來自你的 GetCourse 帳號;讀取不到時仍可手動輸入。既有使用通用欄位清單的動作仍可執行,轉換為分區按鈕會將已知鍵移入對應區域,其他鍵放入自訂欄位。

GetCourse 回傳 HTTP 200 但內容為 success: false 時,動作仍視為失敗並顯示 error_message。成功時 {user_id, deal_id, lead_id} 放入反應暫存情境,缺少的 ID 保持為零。

從 GetCourse 匯出可選使用者、交易或群組。動作等待匯出準備最多 25 秒;若未就緒,回傳 export_not_ready,請稍後重試或縮小篩選範圍。篩選器由「鍵、類型、值」列組成,例如 created_at[from] = 2026-10-01,未知鍵原樣傳送。結果使用該帳號的欄位名稱,每次預設 50 筆、最多 1,000 筆;頁面資訊中的 has_more 指出是否還有後續資料。GetCourse 限制匯出頻率,請用低頻流程或排程,避免每則訊息都觸發。

Google Sheets

填寫試算表連結或 ID,以及服務帳號 JSON。必須把試算表分享給服務帳號的 Email,否則讀寫會因權限不足而失敗;動作編輯器及連接測試會顯示此問題。

欄位按標題列的欄名對應,預設第一列,也可指定其他列。操作包括:

  • 新增列:把欄位值寫入同名欄,欄位順序不限;未知欄名會報錯。結果 {row_number, range}。
  • 讀取列:把標題下方的列讀為物件,附上 _row;預設每頁 50、最多 500,has_more 和 next_offset 可存入另一個鍵。
  • 讀取最後一列與尋找列:分頁檢查試算表。表格太大而無法完整檢查時會報錯,不會回傳可能錯誤的列。
  • 更新列:按 row_number 修改儲存格,例如用搜尋結果 {{ctx.found.row_number}}。

可選擇把值當作使用者輸入(Google 會辨識公式和日期),或作為純文字儲存。編輯器會列出欄標題;讀取不到時可手動輸入。預覽列最多顯示 20 列,不會修改表格;結果可作為解析回應設定的範例,選取下個動作需要的欄位。

Google Drive

填寫資料夾 ID和服務帳號 JSON,並授予服務帳號該資料夾的編輯權限。

Google 雲端硬碟動作會上傳檔案名稱、MIME 類型及內容,將 {file_id, web_view_link} 存入反應情境,例如存為 upload 後可使用 {{ctx.upload.web_view_link}}。亦可設定解析回應。

AI

填寫 Base URL、模型、系統提示詞和 API 金鑰;詳見 AI 回覆與代理。同一個 AI 連接可供反應中的 AI 動作、AI 代理和知識來源索引使用。搜尋會向同一 URL 和金鑰請求文字的數值表示(embeddings),預設模型是 text-embedding-3-small。連接不可用時,知識來源不能建立搜尋索引,AI 代理也不能啟用。

外部處理器

你的伺服器透過 WebSocket 連接 GetMyBot,以 Telegram Bot API 格式的指令處理反應。連接卡片顯示WebSocket 網址及建立時只出現一次的連接權杖,並提供重新簽發按鈕。協定與程式範例見外部處理器。

在反應中使用

AI 可直接作為動作;Webhook 可用網路請求動作發送。GetCourse、Google 試算表和Google 雲端硬碟動作也已在反應編輯器提供。每種動作可選擇解析回應,將所需值放入情境;發生錯誤時,會啟動已設定的錯誤路徑。若方案未包含功能,步驟會以 feature_unavailable 失敗。

檢查連接

連接卡片的檢查按鈕不寫入資料。Google Sheets 讀取表格資訊,Google Drive 讀取資料夾資訊,GetCourse 執行安全的讀取請求,AI 只檢查欄位是否已填寫,不會呼叫需付費的模型。其他類型沒有可執行的檢查。結果逐項顯示成功或失敗及簡短說明。

安全性

GetMyBot 不允許整合請求存取內部網路,並限制回應大小,以防止 SSRF。秘密值會加密保存。

網站擷取和檔案解析另有保護:只使用允許的 HTTPS 網址、遵守 robots.txt、限制轉址、大小與時間,不執行巨集、腳本或嵌入物件。詳見知識來源。

下一步

語音辨識

選擇 OpenAI 相容供應商或自己的服務,設定 API 基本網址、模型與 API 金鑰。可選填 ru、en 等語言代碼作為提示,留空則由供應商判斷;金鑰及模型須屬於所選供應商。