Skip to main content

​
En resumen

  • Comprar un número está en el panel; la API enumera, consulta disponible y configura voz entrante.
  • Alcances: phone_numbers:read (consultar) y phone_numbers:update (configurar). Detalles en Alcances de clave API.
  • Utilice id o phoneE164 como origen en las llamadas, consulte Inicio rápido de Voice API.
Para quienes integran la gestión de números (CRM, telefonía). La compra y el pago permanecen en el tablero.

​
Antes de empezar

  • Número activo comprado en Configuración → Números de teléfono.
  • Clave API con alcances requeridos. Consulte Alcances.
  • Autenticación: Authorization: Bearer sk_live_... o x-api-key.
  • URL base (por ejemplo, https://api.notifique.dev).

​
El camino en tres pasos

  1. Compra en el tablero (búsqueda, reserva, pago).
  2. Enumere los números y copie id o phoneE164.
  3. Configurar lo que sucede cuando alguien llama (reenvío, TTS, webhook…).

​
1. Compra un número (panel de control)

Configuración → Números de teléfono:
  1. Busque por país, código de área o patrón.
  2. Selecciona y paga (tarifa mensual recurrente).
  3. Activación → webhook phone_number.activated (si está configurado).
La API busca números disponibles; la compra se realiza a través del panel de control.

​
2. Buscar números disponibles

Enumera las opciones antes de enviar al usuario al proceso de pago del panel. Pedido Optional parameters: Response (200), example

​
3. Enumere los números del espacio de trabajo

Pedido Returns non-released numbers (RELEASED does not appear). Response (200), example

​
4. Consigue un número

Pedido

​
5. Configure inbound voice

Defines what happens when someone calls, like choosing whether the call goes to reception, voicemail, or your system. Request

​
inboundVoiceAction values

TTS: inboundTtsText + optional inboundTtsVoice (female-natural, male-natural, etc.).

​
6. Lifecycle webhooks

Events: phone_number.activated, phone_number.past_due, phone_number.suspended, phone_number.released. Details: Webhook events.

​
Quick summary

​
Próximos pasos