ABC Salesbot 公开 API：概览与快速上手

ABC Salesbot 提供有完整文档的公开 REST API。任何联网系统都可以推送潜在客户、读取对话、发送消息，并实时响应事件。本文是一张导航图，完整的交互式文档在开发者文档中。

• 开发者指南：app.abcsalesbot.com/docs/api
• 交互式文档（Swagger）：api.abcsalesbot.com/docs/api

身份验证

每个请求都使用 Bearer 令牌：

• 在仪表板的「集成（Integration）」部分获取你的 API 密钥
• 每个请求都带上请求头 Authorization: Bearer YOUR_API_KEY
• 基础地址：https://api.abcsalesbot.com/v1

API 能做什么

• 从任何地方创建潜在客户： POST /v1/webhooks/leads 接收来自网站表单、漏斗页、CRM 或任何自建系统的新潜在客户，无需 Zapier。
• 读取潜在客户的对话： GET /v1/leads/{leadID}/conversations 返回 AI 员工与该客户的完整消息记录。
• 通过程序发送消息： POST /v1/leads/{leadID}/conversations/reply 让你自己的系统通过 ABC Salesbot 回复客户。
• 列出已连接的渠道： GET /v1/messaging-channel-connections 显示账户下所有 WhatsApp、LINE、Facebook、Instagram、Telegram 连接。
• 下载附件： GET /v1/attachments/{id}/download 获取客户在聊天中发送的文件。
• 验证密钥： GET /v1/companies/me 返回密钥所属的公司，可用作连接测试。

Webhook 订阅（事件推送）

订阅会在事件发生的一刻，把事件从 ABC Salesbot 推送到你的系统：

• GET /v1/webhook-subscriptions/events 列出所有可订阅的事件触发器
• 通过 POST、PUT、DELETE /v1/webhook-subscriptions 创建、更新、删除订阅
• 每个订阅都有签名密钥用于验证负载，可随时通过 POST /v1/webhook-subscriptions/{subscriptionId}/regenerate-secret 轮换

关于 Webhook 负载与使用场景的完整讲解，请参阅系统集成传出 Webhook 指南。

频率限制

在合理使用范围内目前没有硬性频率限制。标准 HTTP 状态码（400、401、403、404、429）用于报错，请按常规做好重试处理。