開發者入口網站 / 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 目前也不支援附件、編輯或刪除訊息。