Bot API
通过简洁的 HTTPS 接口收发更新、发送消息并连接后端服务，适合通知、客服、工具和自动化场景。
- 消息、命令和回调交互
- 群组与频道辅助功能
- 内联结果和自定义键盘
开发能力
从机器人到轻量应用
根据产品场景选择合适的接入方式。正式开发前，请以当前官方接口文档、权限说明和审核要求为准。
机器人
机器人是运行在 Potato 内的第三方应用。用户可在私聊、群组或输入框中通过消息、命令与内联请求调用它。
- 内容订阅与实时通知
- 外部服务集成
- 自定义工具与群组管理
授权登录 SDK
通过用户授权获取必要的基础信息，用于建立账号体系和业务流程。只请求完成服务所必需的权限。
- 明确的用户授权流程
- 基础身份信息获取
- 适用于网站和应用登录
Potato 小程序
构建可在聊天与社区场景中传播的轻量应用或小游戏，为内容、服务和交易提供更短的访问路径。
- 会话内发现与分享
- 轻量交互体验
- 按平台能力接入支付
快速开始
四步完成基础接入
下面是通用流程，具体字段、接口地址和审核步骤以官方文档为准。
明确场景
确定机器人、登录或小程序的目标用户与核心流程。
创建应用
按平台流程创建应用或机器人，并妥善保存授权凭证。
连接服务
通过 HTTPS 接口处理更新、业务逻辑和响应。
测试上线
覆盖错误、权限与安全场景，完成审核后再正式发布。
Bot 交互
适合对话场景的能力
命令
使用以斜杠开头的命令提供稳定、可发现的功能入口。
自定义键盘
通过预设选项降低输入成本，快速收集结构化操作。
内联模式
让用户在任意会话中通过机器人用户名搜索和发送内容。
实时更新
利用回调与内联键盘更新已有消息，保持会话整洁。
群组隐私
遵循最小可见原则，只处理机器人完成任务所需的信息。
深度链接
通过可分享入口把用户带到指定机器人或业务流程。
开发安全清单
- 令牌只保存在服务端，禁止写入前端代码
- 使用 HTTPS 并验证请求来源和参数
- 只申请并保存完成业务所需的数据
- 为敏感操作增加鉴权、限流与审计
- 令牌泄露后立即轮换并排查访问记录
- 上线前准备隐私说明与用户支持渠道