Skip to main content
Cada alcance desbloquea un tipo de operación de número virtual. Conceda 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 consultar

phone_numbers:read

Consultar y configurar

phone_numbers:read, phone_numbers:update

Solo configurar entrante

phone_numbers:update

Flujo completo

phone_numbers:read, phone_numbers:update
Lista de alcances vacía al crear = acceso ADMIN (todo). En producción, restrija siempre.
La compra de un número se realiza en el panel. La API consulta números disponibles, lista números del espacio de trabajo y configura voz entrante.

​
Alcances disponibles

  • Listar números contratados del espacio de trabajo (GET /v1/phone-numbers)
  • Obtener un número por id (GET /v1/phone-numbers/:id)
  • Buscar números disponibles antes de pagar en el panel (GET /v1/phone-numbers/available)
Actualizar configuración de un número (PATCH /v1/phone-numbers/:id): etiqueta, acción de voz entrante (inboundVoiceAction), desvío, TTS, grabación, etc.

​
Relación con la API de Voz

Para iniciar llamadas con el número, use alcances de voz (voice:call, voice:read, …). Los alcances de esta página aplican solo a /v1/phone-numbers.

​
Errores de autenticación

Verifique Authorization: Bearer sk_... y que la clave no se haya eliminado en el panel.
Confirme que la clave tiene phone_numbers:read o phone_numbers:update para la ruta.

​
Próximos pasos