Bot API
通過簡潔的 HTTPS 接口收發更新、發送消息並連接後端服務，適合通知、客服、工具和自動化場景。
- 消息、命令和回調交互
- 羣組與頻道輔助功能
- 內聯結果和自定義鍵盤
開發能力
從機器人到輕量應用
根據產品場景選擇合適的接入方式。正式開發前，請以當前官方接口文檔、權限説明和審核要求為準。
機器人
機器人是運行在 Potato 內的第三方應用。用户可在私聊、羣組或輸入框中通過消息、命令與內聯請求調用它。
- 內容訂閲與實時通知
- 外部服務集成
- 自定義工具與羣組管理
授權登錄 SDK
通過用户授權獲取必要的基礎信息，用於建立賬號體系和業務流程。只請求完成服務所必需的權限。
- 明確的用户授權流程
- 基礎身份信息獲取
- 適用於網站和應用登錄
Potato 小程序
構建可在聊天與社區場景中傳播的輕量應用或小遊戲，為內容、服務和交易提供更短的訪問路徑。
- 會話內發現與分享
- 輕量交互體驗
- 按平台能力接入支付
快速開始
四步完成基礎接入
下面是通用流程，具體字段、接口地址和審核步驟以官方文檔為準。
明確場景
確定機器人、登錄或小程序的目標用户與核心流程。
創建應用
按平台流程創建應用或機器人，並妥善保存授權憑證。
連接服務
通過 HTTPS 接口處理更新、業務邏輯和響應。
測試上線
覆蓋錯誤、權限與安全場景，完成審核後再正式發佈。
Bot 交互
適合對話場景的能力
命令
使用以斜槓開頭的命令提供穩定、可發現的功能入口。
自定義鍵盤
通過預設選項降低輸入成本，快速收集結構化操作。
內聯模式
讓用户在任意會話中通過機器人用户名搜索和發送內容。
實時更新
利用回調與內聯鍵盤更新已有消息，保持會話整潔。
羣組隱私
遵循最小可見原則，只處理機器人完成任務所需的信息。
深度鏈接
通過可分享入口把用户帶到指定機器人或業務流程。
開發安全清單
- 令牌只保存在服務端，禁止寫入前端代碼
- 使用 HTTPS 並驗證請求來源和參數
- 只申請並保存完成業務所需的數據
- 為敏感操作增加鑑權、限流與審計
- 令牌泄露後立即輪換並排查訪問記錄
- 上線前準備隱私説明與用户支持渠道