Sibéria para programadores

Autenticação

Crie uma chave no painel e envie-a no header Authorization: Bearer. Nunca inclua chaves secretas no código público do navegador.

https://siberia.frantalcompany.com/api/v1

API de conversas

O identificador do visitante é obrigatório. Nas mensagens seguintes, envie o conversation_id devolvido para manter o contexto.

curl --request POST 'https://siberia.frantalcompany.com/api/v1/chat' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "message": "Hello",
    "end_user_id": "visitor_123",
    "channel": "api"
  }'

{
  "conversation_id": "01EXAMPLEULID00000000000000",
  "message": {
    "id": "01EXAMPLEULID00000000000001",
    "role": "assistant",
    "content": "Hello! How can I help?",
    "provider": "fireworks",
    "model": "your-allowed-model"
  }
}

Widget no seu site

O chat público pode ser incorporado por iframe, sem expor chaves. Substitua o slug pelo do seu assistente.

<iframe
  src="https://siberia.frantalcompany.com/chat/YOUR_ASSISTANT_SLUG"
  title="Business assistant"
  style="width:100%;height:650px;border:0"
  allow="microphone" loading="lazy">
</iframe>

Eventos e webhooks

Configure os eventos no painel. Valide o header X-Siberia-Signature com HMAC-SHA256 sobre o corpo original do pedido antes de processar um evento.

Voz, imagens e ações

As funcionalidades variam por plano. A voz em direto e os envios de imagens estão disponíveis nos chats públicos quando ativados pelo responsável.

Erros e limites

Trate 401/403 como falhas de autorização, 422 como validação, 429 como limite de pedidos e 5xx como falhas temporárias. Nunca repita automaticamente um pagamento ou uma ação sem garantir idempotência.