Portail développeur / API v1

Reliez vos outils de support.

Connectez Sajama One à vos outils avec une API limitée à l’espace, des webhooks signés et un aperçu du SDK Node.js. Choisissez l’interface adaptée à votre besoin.

API Conversations

Utilisez des clés révocables liées à l’espace et des droits de lecture et d’écriture distincts. Parcourez les conversations par curseur opaque ou envoyez des réponses texte dans une file durable asynchrone. Gardez les clés sur votre serveur, jamais dans le navigateur.

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

API Conversations

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

Webhooks sortants

Abonnez-vous à conversation.created et message.created. Vérifiez HMAC-SHA256 sur le corps brut exact et dédupliquez les nouvelles tentatives avec l’identifiant de livraison stable. La livraison est au moins une fois.

Aperçu du SDK Node.js

Le code source permet de lire les conversations, d’envoyer des réponses idempotentes et de vérifier les signatures de webhook horodatées. Il n’est pas encore publié sur npm.

Limites actuelles

Il n’existe pas encore d’API publique de contrôle du widget dans le navigateur ni de connecteur Zapier natif. L’API publique ne prend pas non plus en charge les pièces jointes, la modification ou la suppression des messages.