Pular para o conteúdo principal
POST
/
v1
/
embed
/
sessions
Criar sessão de embed
curl --request POST \
  --url https://pilotstatus.com.br/v1/embed/sessions \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "surface": "chat",
  "whatsappNumberIds": [
    "num_01HZX..."
  ],
  "allowedOrigins": [
    "https://app.tenant.com"
  ],
  "ttlSeconds": 900
}
'
{
  "token": "eyJhbGciOiJIUzI1NiJ9.<claims>.<sig>",
  "surface": "chat",
  "whatsappNumberIds": [
    "num_01HZX..."
  ],
  "allowedOrigins": [
    "https://app.tenant.com"
  ],
  "expiresAt": "2026-06-26T15:15:00.000Z"
}

Autorizações

​
x-api-key
string
header
obrigatório

Sua chave de API ps_

Corpo

application/json
​
surface
string
obrigatório

Microfrontend a embutir.

Exemplo:

"chat"

​
allowedOrigins
string
obrigatório

Origens exatas (scheme://host[:port]) onde o iframe pode rodar.

Exemplo:

"[\"https://app.tenant.com\"]"

​
whatsappNumberIds
string

Números a expor no chat (obrigatório para key de tenant em surface:chat).

Exemplo:

"[\"num_01HZX...\"]"

​
brandingOverride
object

Marca por-sessão (logo/cores/título) que sobrepõe a marca do tenant.

​
ttlSeconds
string

Validade do token em segundos (default 900 chat / 1800 connect).

Exemplo:

"900"

Resposta

Criar sessão de chat