Kehittäjäportaali / API v1

Yhdistä asiakastuen työkalusi.

Yhdistä Sajama One omiin työkaluihisi työtilaan rajatulla API:lla, allekirjoitetuilla webhookeilla ja Node.js SDK:n esiversiolla.

Conversations API

Käytä peruutettavia, työtilaan sidottuja avaimia, joilla on erilliset luku- ja kirjoitusoikeudet. Selaa keskusteluja läpinäkymättömällä sivutusosoittimella tai lähetä tekstivastauksia pysyvän asynkronisen jonon kautta. Säilytä avaimet palvelimella, älä selaimessa.

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

Lähtevät webhookit

Tilaa tapahtumat conversation.created ja message.created. Tarkista HMAC-SHA256 muuttamattomasta raakasisällöstä ja poista uusintatoimitusten kaksoiskappaleet pysyvän toimitustunnuksen avulla. Toimitus on vähintään kerran.

Node.js SDK:n esiversio

Lähdekoodiversio tukee keskustelujen lukemista, idempotentteja tekstivastauksia ja aikaleimallisten webhook-allekirjoitusten tarkistamista. Sitä ei ole vielä julkaistu npm:ssä.

Nykyiset rajoitukset

Julkista selaimen widgetin ajonaikaista API:a tai natiivia Zapier-liitintä ei tällä hetkellä ole. Julkinen API ei myöskään tue liitteitä eikä viestien muokkaamista tai poistamista.