整合
連接 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、限制轉址、大小與時間,不執行巨集、腳本或嵌入物件。詳見知識來源。
下一步
- AI 回覆與代理:模型設定。
- 知識來源:AI 代理的資料。
- 會議與 Google 日曆:日曆連接。
- 外部處理器:自有後端。
- CRM 整合:amoCRM/Kommo、Bitrix24、RetailCRM、OzmaCRM。
- 資料來源與金鑰:REST/OzmaDB 連接器。
- 網路請求與 Webhook:傳入與傳出的 HTTP。
語音辨識
選擇 OpenAI 相容供應商或自己的服務,設定 API 基本網址、模型與 API 金鑰。可選填 ru、en 等語言代碼作為提示,留空則由供應商判斷;金鑰及模型須屬於所選供應商。