Gestión de números
Un número sigue un ciclo: búsqueda, reserva, pedido, activación, asignación y baja. En cada paso una condición puede bloquearlo. Esta página las describe.
Actualizado el
¿Cuándo está disponible un número?
Un número está disponible cuando se cumplen cuatro condiciones a la vez.
- El país y la capacidad están aprobados (voz, SMS o ambos).
- Hay existencias en el proveedor.
- Su cuenta está autorizada a pedir ese tipo de número.
- Se cumplen las obligaciones del país, en particular los documentos justificativos.
Tipos de número
Los tipos disponibles dependen del país y del proveedor. Los más habituales son los siguientes.
| Tipo | Uso habitual |
|---|---|
| Local | Presencia geográfica, atención de una sede. |
| Nacional | Un único número para un país. |
| Móvil | SMS o llamadas a móviles, según el país. |
| Número especial | Números de servicio, según país y proveedor. |
Documentos justificativos
Algunos países piden prueba de identidad, justificante de domicilio local o una descripción del uso. Los requisitos se muestran antes del pedido, junto a la búsqueda de números. Un pedido con documentos incompletos queda pendiente de validación.
Reserva, caducidad y conflicto de existencias
- Busca y reserva un número. La reserva es temporal.
- Si no confirma a tiempo, la reserva caduca y el número vuelve a las existencias.
- Si otro cliente obtiene el número antes que usted, el pedido falla por conflicto de existencias. Haga una nueva búsqueda.
- Un pedido confirmado pasa a pendiente de validación; después el número se activa y se emite el evento number.activated.
curl -X POST https://api.example.test/v1/number-orders \
-H "Authorization: Bearer tq_test_EXEMPLE" \
-H "Idempotency-Key: 5b0e6f0e-2f55-4c1e-9a43-0d6a2f1c7a10" \
-H "Content-Type: application/json" \
-d '{"e164":"+33199001234","project_id":"prj_A"}'Asignación a un proyecto
Un número pertenece a un proyecto. Sus llamadas, mensajes y consumo quedan vinculados a ese proyecto. Pasar un número a otro proyecto es una operación registrada en el historial de auditoría.
Baja de un número
Dar de baja un número exige una confirmación que indica el destino exacto. Según el país, un número dado de baja puede no recuperarse después. Si quiere conservarlo en otro operador, valore más bien una portabilidad.