Escopos da API Key

Cada escopo é uma porta na sua chave: discar, consultar ou controlar a sessão, abra só o necessário.

Cada escopo libera um tipo de operação em Voz. Use só o que sua integração precisa.

Como enviar a chave

Recomendado

Authorization: Bearer sk_live_sua_chave_aqui

Alternativo

x-api-key: sk_live_sua_chave_aqui

A API Key pertence a um workspace. Você não acessa outro workspace com a mesma chave.

voice:call, voice:read

voice:call, voice:read, voice:control

voice:read

voice:read (download de gravação)

Lista de escopos vazia na criação = acesso ADMIN. Em produção, restrinja sempre.

voice:call

Originar chamadas de saída. Exige número ACTIVE e saldo ou créditos. Retorno típico: 202 com id da chamada.

voice:read

Listar chamadas do workspace, consultar detalhe e eventos (includeEvents) e baixar arquivo de gravação.

voice:control

Ações em sessão ativa: speak, play, gather, transfer, record-start, record-stop, dtmf, hangup.

401: chave ausente, inválida ou revogada

Confira Authorization: Bearer sk_... e se a chave não foi apagada no painel.

402: saldo ou créditos insuficientes

Workspace bloqueado ou sem saldo para discagem. Regularize no painel.

403: sem escopo

Verifique escopo da operação (Missing scope: voice:call, etc.).

400: origem inválida ou não ACTIVE

O from precisa ser um número ACTIVE do workspace (id ou E.164).