REST API 與 Token

除了視覺化編輯器，GetMyBot 也提供程式化存取：可透過 REST API 管理機器人資料。Token 分兩種——存取特定機器人的 Token，以及個人 Token（用於帳號級自動化與整合）。

機器人 API Token

在設定 → API Token 中建立。每個 Token 與特定機器人繫結，可用於呼叫其 REST 端點（反應、使用者、集合、統計等）。Token 僅在建立時顯示一次，請妥善保存；清單僅顯示名稱、遮罩及建立日期。請刪除不再使用的 Token。

個人存取 Token（PAT）

個人存取 Token（PAT，以 mbp_ 開頭）作用於帳號層級，用於自動化與整合。在個人後台建立；以 Authorization: Bearer mbp_… 標頭傳遞。Token 具有存取範圍（scopes）——資源:動作 格式的權限集合（例如 reactions:read、bots:write），* 代表完整存取。可設定有效期限，Token 本身以雜湊方式儲存。這是授予腳本有限存取權限而無需提供密碼的便利方式。

API 可存取的內容

透過 API 可存取與介面相同的資源：機器人及其設定、反應（含匯入／匯出）、訂閱者與標籤、集合與記錄、統計與請求記錄、群發。這讓你能在 GetMyBot 之上建構自訂儀表板、同步及自動化流程。

頻道與 WhatsApp

GetMyBot 是多頻道的（Telegram + WhatsApp + VK），機器人的頻道同樣可以透過 REST 管理。頻道和 WhatsApp 範本受 共用 scope bots:read / bots:write 控制——沒有單獨的頻道 scope。

  • GET /api/channels/capabilities — 頻道能力矩陣（工作階段端點，無需 PAT scope）。
  • GET /api/bots/{botID}/channels（bots:read）— 列出機器人的頻道。
  • POST /api/bots/{botID}/channels（bots:write）— 連接 WhatsApp 或 VK 頻道。
  • DELETE /api/bots/{botID}/channels/{channelID}（bots:write）— 中斷頻道連接。
  • GET /api/bots/{botID}/channels/{channelID}/templates（bots:read）— 頻道的 WhatsApp 範本目錄。
  • POST /api/bots/{botID}/channels/{channelID}/templates（bots:write）— 建立範本並提交給 Meta 審核。
  • POST /api/bots/{botID}/channels/{channelID}/templates/sync（bots:write）— 從 Meta 重新同步目錄。
  • PUT /api/bots/{botID}/channels/{channelID}/templates/{templateID}（bots:write）— 編輯範本。
  • DELETE /api/bots/{botID}/channels/{channelID}/templates/{templateID}（bots:write）— 刪除範本。
  • POST /api/bots/{botID}/channels/{channelID}/templates/media（bots:write）— 上傳標頭媒體範例（圖片/影片/文件）。

請求／回應的結構、參數和範例見 API 參考文件。

行動裝置存取

平台提供行動應用程式，有獨立的授權機制（access 與 refresh Token）及機器人總覽儀表板，使用相同的後端服務。

API 參考文件

完整的互動式公開 API 參考文件位於 API 參考 頁面：列出所有可透過 PAT 存取的端點、參數、請求與回應 Schema、所需 scopes，以及現成的請求範例（curl、JavaScript、Python）。可直接在頁面上使用自己的 Token 進行試用。

安全性

  • Token 僅顯示一次；請將其視為機密保管。
  • 機器人 Secret 及憑證以加密方式儲存。
  • 所有變更操作均記錄於稽核日誌。

延伸閱讀