Embed

URL base da API
https://crm.vdgestaobranding.com/api/v1

A documentação fica em developers.vdgestaobranding.com, mas todas as chamadas vão para crm.vdgestaobranding.com/api/v1.

POST/embed/sessions
embed:create
Idempotency-Key

Criar sessão de embed (SSO)

Chame do seu servidor. Devolve um token de troca de uso único (5 min) e a URL do embed. A sessão dura 30 min, é renovável até 12 h e só enxerga os números e módulos informados. Exige ao menos um domínio permitido em Configurações → Marca e embed.

curl -X POST "https://crm.vdgestaobranding.com/api/v1/embed/sessions" \
  -H "Authorization: Bearer $VDCRM_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
  "user": {
    "external_id": "u-123",
    "name": "Ana",
    "email": "ana@cliente.com"
  },
  "phone_number_refs": [
    "a0b1…"
  ],
  "modules": [
    "inbox",
    "metrics"
  ],
  "permissions": [
    "inbox:read",
    "inbox:reply",
    "metrics:read"
  ]
}'
Resposta 201
{
  "session_id": "es1…",
  "embed_user_id": "eu1…",
  "token": "vdex_…",
  "token_expires_at": "2026-11-03T15:05:00Z",
  "url": "https://crm.vdgestaobranding.com/embed?t=vdex_…",
  "modules": [
    "inbox",
    "metrics"
  ],
  "test": false
}