開發者入口網站 / API v1

串連您的支援工具。

透過工作區範圍 API、已簽署事件 webhook,以及 Node.js SDK 預覽版,將 Sajama One 串連至您的工具。

對話 API

使用可撤銷且綁定工作區的金鑰,並分開授予讀取與寫入範圍。以不透明游標分頁讀取對話,或透過持久非同步佇列傳送純文字回覆。金鑰應保留在伺服器端,切勿放入瀏覽器程式碼。

curl "https://sajamaone.com/api/v1/conversations?limit=50" \
  -H "X-API-Key: YOUR_READ_KEY"

對話 API

curl -X POST "https://sajamaone.com/api/v1/conversations/CONVERSATION_ID/messages" \
  -H "X-API-Key: YOUR_WRITE_KEY" \
  -H "Idempotency-Key: YOUR_UNIQUE_REQUEST_ID" \
  -H "Content-Type: application/json" \
  -d '{"text":"Thanks for getting in touch."}'

輸出 Webhook

訂閱 conversation.created 與 message.created。使用完全未修改的原始本文驗證 HMAC-SHA256,並以穩定傳遞 ID 去重重試。傳遞模型為至少一次。

Node.js SDK 預覽版

原始碼版本支援讀取對話、具冪等性的文字回覆,以及含時間戳記的 webhook 簽章驗證。尚未發佈至 npm。

目前限制

目前沒有公開的瀏覽器端 widget 執行階段 API,也沒有原生 Zapier 連接器。公開 API 目前也不支援附件、編輯或刪除訊息。