Números virtuales para empresas: búsqueda, pedido y gestión por API
Encuentre un número por país, tipo y capacidades, vea los documentos exigidos antes de pedirlo y asócielo a un proyecto. Tarifas bajo presupuesto.
Bajo presupuesto
Un número virtual es un número de teléfono que no está ligado a una línea física. Recibe llamadas, SMS o ambos, y los envía a su aplicación, a un punto SIP o a un flujo de llamadas.
En TELQIO, la búsqueda muestra el país, el tipo y las capacidades de voz y SMS de cada número, junto con los documentos que el país pueda exigir. Estas condiciones se ven antes de pedir, no después.
Cada número pedido se asocia a un proyecto. Los registros de llamadas, los SMS y el consumo se leen por proyecto, por número o por país.
Cómo circula
Usos concretos
Un número por sede o sucursal
Asigne un número local a cada sede y siga su actividad por separado.
Un número por campaña
Reserve números dedicados para medir qué fuente genera llamadas, con el seguimiento de llamadas.
Números de entrada para su producto
Dé a cada entorno o cliente de su SaaS un número de entrada conectado a sus webhooks.
Traslado de números existentes
Prepare una solicitud de portabilidad con la lista de documentos esperados en el país.
Funcionalidades
- Búsqueda por país, tipo de número, prefijo y capacidad de voz o SMS
- Estado del stock, documentos exigidos y plazo confirmado a la vista
- Pedido con validación de documentos antes de la activación
- Cada número asociado a un proyecto
- Evento number.activated enviado a su webhook firmado
- Consumo legible por número, proyecto y país
Límites que conviene conocer
- Los tipos de número disponibles dependen del país, del proveedor elegido y del contrato.
- Un número solo se ofrece si el país y la capacidad están aprobados, hay stock y se cumplen las obligaciones del país.
- Algunos países exigen un comprobante de identidad o de domicilio. El plazo de activación depende entonces de la validación de esos documentos.
- Un número que puede hacer llamadas no siempre puede recibir SMS. Cada capacidad se comprueba por separado.
- Una reserva puede caducar y el stock puede cambiar entre la búsqueda y el pedido. El pedido se lo indica de forma explícita.
# Búsqueda
curl "https://api.example.test/v1/numbers/search?country=FR&type=local" \
-H "Authorization: Bearer tq_test_EXEMPLE"
# => { "data": [{ "e164": "+33199001234", "country": "FR", "type": "local",
# "capabilities": ["voice","sms"], "documents_required": [] }] }
# Pedido
curl -X POST "https://api.example.test/v1/number-orders" \
-H "Authorization: Bearer tq_test_EXEMPLE" \
-H "Idempotency-Key: 7b1d2c4e-0000-4000-8000-000000000001" \
-H "Content-Type: application/json" \
-d '{ "e164": "+33199001234", "project_id": "proyecto_a" }'
# => { "id": "ord_ejemplo", "status": "pending_validation", "simulated": true }Aspectos técnicos
| Formato de números | E.164, sin espacios |
|---|---|
| Lectura | GET /numbers y GET /numbers/search, paginación por cursor |
| Pedido | POST /number-orders, con cabecera Idempotency-Key |
| Estado inicial | pending_validation, hasta que se validen los documentos |
| Notificación | Evento number.activated, webhook firmado |
Preguntas frecuentes
¿Puedo pedir un número en cualquier país?
No. La lista de países es un referencial, no una cobertura activa. Un número solo se ofrece si el país y la capacidad se han validado con el proveedor elegido.
¿Qué pasa si el stock cambia mientras hago el pedido?
La reserva puede caducar o el stock agotarse. La consola y la API lo indican con claridad, y puede repetir la búsqueda sin perder el resto de su solicitud.
¿Cómo sé cuánto cuesta un número?
Las condiciones se fijan bajo presupuesto, según el país, el tipo de número y el volumen previsto. Se le muestran antes del pedido.
Usos relacionados
Documentación
Servicios relacionados
Díganos qué números necesita
Indique los países, los tipos de número y las capacidades que busca. Preparamos un presupuesto con las condiciones y los documentos esperados.