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）用於回報錯誤，請按常規做好重試處理。