VolundOS
Referência da APIChat embutido

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ó.

Atualizado em 04 de novembro de 2026
POST
/v1/embed/sessions

Authorization

credencialDaAplicacao
AuthorizationBasic <token>

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

Request 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" \  -H "Content-Type: application/json" \  -d '{    "agent": "string",    "user": {      "id": "string"    }  }'
{  "session_id": "1ffd059c-17ea-40a8-8aef-70fd0307db82",  "embed_url": "string",  "expires_at": "2019-08-24T14:15:22Z",  "thread_id": "1de43264-67cb-48af-89f9-e865c375bb84"}