Renovar sessão de chat embutido
Troca os cabeçalhos de MCP quando enviados, estende a sessão quando `ttl_seconds` vem (nunca encurta) e devolve um código e um `embed_url` novos. Chame quando o token do seu MCP mudar ou antes de a sessão vencer. O corpo é opcional: vazio, só emite o código novo.
Authorization
credencialDaAplicacao Credencial da aplicação vinculada, criada em Configurações > Aplicações: Authorization: Basic base64(client_id:client_secret). Use só no seu backend.
In: header
Path Parameters
Id da sessão devolvido na criação.
uuidRequest Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/embed/sessions/497f6eca-6276-4993-bfeb-53cbbbba6f08/refresh" \ -H "Content-Type: application/json" \ -d '{}'{ "session_id": "1ffd059c-17ea-40a8-8aef-70fd0307db82", "code": "string", "embed_url": "string", "expires_at": "2019-08-24T14:15:22Z"}Criar sessão de chat embutido
Cria a sessão de um usuário da sua plataforma e devolve o `embed_url` para o `src` do iframe. O usuário não precisa de conta: ele é identificado pelo `user.id` que você manda. `restrictions` só restringe o que o agente já tem, `mcp` leva os cabeçalhos (só `authorization` e `x-*`) que o agente apresenta aos servidores MCP dos hosts que a aplicação declarou, e `context` entra no turno como dado da aplicação. O código no fragmento do `embed_url` vale 120 segundos e uma vez só.
Encerrar sessão de chat embutido
Revoga a sessão. O iframe recebe a sessão encerrada na próxima chamada.