Portal deweloperski / API v1
Połącz narzędzia obsługi klienta.
Połącz Sajama One z własnymi narzędziami przez API ograniczone do przestrzeni, podpisane webhooki i wersję testową SDK Node.js.
API rozmów
Używaj odwoływalnych kluczy przypisanych do przestrzeni z osobnymi uprawnieniami odczytu i zapisu. Stronicuj rozmowy niejawny kursorem albo wysyłaj odpowiedzi tekstowe przez trwałą kolejkę asynchroniczną. Klucze przechowuj na serwerze, nigdy w kodzie przeglądarki.
curl "https://sajamaone.com/api/v1/conversations?limit=50" \
-H "X-API-Key: YOUR_READ_KEY"API rozmów
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."}'Webhooki wychodzące
Subskrybuj conversation.created i message.created. Weryfikuj HMAC-SHA256 na dokładnym surowym body i usuwaj duplikaty ponowień przy użyciu stabilnego identyfikatora dostawy. Dostawa jest co najmniej jednokrotna.
Wersja testowa SDK Node.js
Kod źródłowy obsługuje odczyt rozmów, idempotentne odpowiedzi tekstowe i weryfikację podpisów webhooków z timestampem. Pakiet nie jest jeszcze opublikowany w npm.
Obecne ograniczenia
Obecnie nie ma publicznego API do sterowania widgetem w przeglądarce ani natywnego konektora Zapier. Publiczne API nie obsługuje też załączników, edycji ani usuwania wiadomości.