Criacao de sessao e envio de mensagens para a IA.
Criar sessao
Cria uma sessao de chat para a empresa do token. Retorna o sessionToken usado nas chamadas seguintes. A sessao guarda o historico no servidor - voce nao reenvia a conversa a cada mensagem.
Atencao: este POST nao tem corpo, mas alguns servidores retornam 411 Length Required se o cliente nao enviar Content-Length. Envie Content-Length: 0 (ou um corpo vazio {}).
Criar sessao › Responses
Sessao criada.
sessionTokenIdentificador da conversa. Use nas chamadas seguintes.
Historico da conversa
Retorna o historico da sessao (blocos de mensagens, paginado).
path Parameters
tokenO sessionToken retornado por POST /sessions.
query Parameters
beforeSessionIdPaginacao: passe o oldestSessionId do payload anterior para carregar um bloco mais antigo.
Historico da conversa › Responses
Historico.
Enviar mensagem
Envia uma mensagem para a sessao. O cabecalho Accept decide o formato da resposta:
Accept: application/json(ou ausente): resposta unica e consolidada (schemaTurnResponse).Accept: text/event-stream: streaming Server-Sent Events, igual ao chat do painel.
Eventos do streaming (SSE)
| Evento | Payload |
|---|---|
text | { delta } |
tool_call_start | { callId, name } |
tool_call_delta | { callId, delta } |
tool_call_end | { callId, args } |
tool_result | { callId, ok, summary } |
artifact | { messageId, kind, fileName, url } |
usage | { quotaUsedPct, quotaSource } |
done | { reason } |
error | { code, message, retryAfterSeconds } |
session_changed | { sessionToken, reason } |
path Parameters
tokenO sessionToken retornado por POST /sessions.
Enviar mensagem › Request Body
messageMensagem do usuario em linguagem natural.
tipoAmbiente1 = producao (emissao real), 2 = homologacao (teste).
Enviar mensagem › Responses
Turno processado. Em modo JSON, o corpo e o TurnResponse. Em modo SSE, e um fluxo text/event-stream.
sessionTokenToken efetivo da sessao (pode mudar se a conversa reiniciar por inatividade).
replyTexto consolidado da resposta da IA.
stopReasonMotivo do fim do turno (ex: end_turn).