Entwicklerportal / API v1

Verbinden Sie Ihren Support-Stack.

Verbinden Sie Sajama One über eine workspacegebundene API, signierte Webhooks und eine Node.js-SDK-Vorschau mit Ihren eigenen Tools.

Conversations API

Verwenden Sie widerrufbare, workspacegebundene Schlüssel mit getrennten Lese- und Schreibberechtigungen. Lesen Sie Gespräche per undurchsichtigem Cursor oder senden Sie Textantworten über eine dauerhafte asynchrone Warteschlange. Schlüssel gehören auf Ihren Server, nicht in Browsercode.

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

Conversations 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."}'

Ausgehende Webhooks

Abonnieren Sie conversation.created und message.created. Prüfen Sie HMAC-SHA256 anhand des unveränderten Rohinhalts und deduplizieren Sie Wiederholungen über die stabile Zustellungs-ID. Die Zustellung erfolgt mindestens einmal.

Node.js-SDK-Vorschau

Der Quellcode unterstützt Gesprächsabfragen, idempotente Textantworten und die zeitgebundene Prüfung von Webhook-Signaturen. Das SDK ist noch nicht auf npm veröffentlicht.

Derzeitige Grenzen

Eine öffentliche Browser-API zur Laufzeitsteuerung des Widgets und einen nativen Zapier-Connector gibt es derzeit nicht. Anhänge sowie Bearbeitung und Löschung von Nachrichten werden von der öffentlichen API ebenfalls nicht unterstützt.