Portal do desenvolvedor / API v1
Conecte suas ferramentas de suporte.
Conecte o Sajama One às suas ferramentas com uma API vinculada ao espaço, webhooks assinados e uma prévia do SDK Node.js.
API de conversas
Use chaves revogáveis vinculadas ao espaço com permissões separadas de leitura e escrita. Leia conversas com paginação por cursor opaco ou envie respostas de texto por uma fila assíncrona durável. Mantenha as chaves no servidor, nunca no navegador.
curl "https://sajamaone.com/api/v1/conversations?limit=50" \
-H "X-API-Key: YOUR_READ_KEY"API de conversas
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 de saída
Assine conversation.created e message.created. Verifique HMAC-SHA256 usando o corpo bruto exato e deduplique novas tentativas pelo ID estável de entrega. A entrega ocorre pelo menos uma vez.
Prévia do SDK Node.js
O código-fonte oferece leitura de conversas, respostas de texto idempotentes e verificação de assinatura de webhook com timestamp. Ainda não foi publicado no npm.
Limites atuais
Ainda não existe uma API pública de execução do widget no navegador nem um conector nativo do Zapier. A API pública também não oferece anexos, edição ou exclusão de mensagens.