Skip to main content
Cada alcance es una puerta en su clave: marque, consulte o controle la sesión. Abra solo lo que necesite.
Cada alcance desbloquea un tipo de operación de voz. Use solo lo que su integración necesita.

​
Cómo enviar la clave

Recomendado
Alternativo
Cada clave API pertenece a un espacio de trabajo. No puede acceder a otro espacio de trabajo con la misma clave.

​
Combinaciones comunes

Solo marcador simple

voice:call, voice:read

IVR en tiempo real

voice:call, voice:read, voice:control

Solo consultar historial

voice:read

Grabaciones

voice:read (descarga de grabación)
Lista de alcances vacía al crear = acceso ADMIN (todo). En producción, restrinja siempre.

​
Alcances disponibles

Originar llamadas salientes. Requiere número ACTIVO y saldo o créditos. Respuesta típica: 202 con id de la llamada.
Listar llamadas del espacio de trabajo, consultar detalles y eventos (includeEvents) y descargar archivos de grabación.
Acciones en sesión activa: speak, play, gather, transfer, record-start, record-stop, dtmf, hangup.

​
Errores comunes

Verifique Authorization: Bearer sk_... y que la clave no se haya eliminado en el panel.
Espacio de trabajo bloqueado o sin saldo para marcar. Resuelva en el panel.
Verifique el alcance de la operación (Missing scope: voice:call, etc.).
from debe ser un número del espacio de trabajo ACTIVO (id o E.164).

​
Próximos pasos