VOS3000 softswitch VoIP, VOS3000 seguridad, VOS3000 Call Center Soluciones, VOS3000 API Integración, VOS3000 Infraestructura
VOS3000 API integración desarrollo es la clave para automatizar operaciones, crear portales de clientes personalizados e integrar sistemas externos con su plataforma VoIP. La Web API V2.1.9.07 de VOS3000 proporciona una interfaz completa basada en JSON que permite gestionar cuentas, teléfonos, gateways, tarifas y CDR de forma programática. Esta guía técnica completa le enseñará a utilizar todos los endpoints disponibles.
📞 ¿Necesita desarrollar integraciones con VOS3000? WhatsApp: +8801911119966
La interfaz Web API de VOS3000 permite a desarrolladores e integradores interactuar con el softswitch de forma programática, eliminando la necesidad de operaciones manuales en la interfaz gráfica. Esto es esencial para portales de autoservicio, sincronización con CRM, automatización de procesos y desarrollo de aplicaciones móviles.
| 🔧 Aspecto | 📋 Especificación |
|---|---|
| Formato de Datos | JSON con codificación UTF-8 |
| Método HTTP | POST para todas las peticiones |
| Content-Type | text/html; charset=UTF-8 |
| Puerto por Defecto | Configurable (varía según instalación) |
| Protocolos | HTTP y HTTPS soportados |
| Versión Actual | V2.1.9.07 (Documento 05, 2022-10-19) |
# Formato HTTP http://[IP-Servidor]:[Puerto-HTTP]/external/server/[Endpoint] # Formato HTTPS https://[IP-Servidor]:[Puerto-HTTPS]/external/server/[Endpoint] # Ejemplo práctico http://192.168.1.100:8080/external/server/CreateCustomer # Nota: El puerto puede variar según configuración del servidor
Antes de utilizar la API, debe configurar los permisos de acceso desde la interfaz de gestión de VOS3000. Esta configuración controla qué direcciones IP pueden acceder a la API y qué endpoints están disponibles para cada cliente.
| 📋 Parámetro | 🔧 Descripción |
|---|---|
| Web Server Device | Nombre del dispositivo para identificación |
| Directory Name | Rango de directorios API permitidos |
| /external/server | Interfaz oficial de producción |
| /external/test/server | Interfaz de prueba para depuración visual |
| Allowed Access IP | Direcciones IP autorizadas para acceder |
📖 Descargar Manual Web API V2.1.9.07 completo: vos3000.com/downloads.php
La API V2.1.9.07 incluye más de 80 endpoints para gestión completa del softswitch. A continuación se detallan los más utilizados para operaciones comunes de integración.
| 🔗 Endpoint | 📋 Función | 📝 Parámetros Clave |
|---|---|---|
| /CreateCustomer | Crear nueva cuenta | account, name, money, limitMoney, feeRateGroup, type, lockType |
| /ModifyCustomer | Modificar cuenta existente | account, name, limitMoney, feeRateGroup, lockType, validTime |
| /DeleteCustomer | Eliminar cuenta | account (requerido) |
| /GetCustomer | Consultar información de cuenta | accounts[], e164s[], filterAgentAccount |
| /GetAllCustomers | Obtener todas las cuentas | key (entero) |
| 🔗 Endpoint | 📋 Función | 📝 Parámetros Clave |
|---|---|---|
| /CreatePhone | Crear teléfono/SIP account | e164, account, password, displayNumber, callLevel, registerType |
| /ModifyPhone | Modificar configuración de teléfono | e164, password, displayNumber, lockType, callLevel, feerateGroup |
| /DeletePhone | Eliminar teléfono | e164 (requerido) |
| /GetPhone | Consultar información de teléfono | e164s[] o accounts[] |
| /GetPhoneOnline | Ver teléfonos online | e164s[] (lista de teléfonos) |
| 🔗 Endpoint | 📋 Función | 📝 Parámetros Clave |
|---|---|---|
| /CreateGatewayMapping | Crear gateway de mapeo (origination) | name, password, registerType, remoteIps, capacity, priority |
| /CreateGatewayRouting | Crear gateway de enrutamiento (termination) | name, prefix, registerType, remoteIp, protocol, signalPort |
| /GetGatewayMapping | Consultar gateways de mapeo | names[] (opcional) |
| /GetGatewayMappingOnline | Ver gateways online con estadísticas | names[], softswitchName |
El siguiente ejemplo muestra cómo crear una nueva cuenta en VOS3000 mediante la API, incluyendo todos los parámetros principales y la estructura de respuesta esperada.
POST /external/server/CreateCustomer HTTP/1.1
Host: 192.168.1.100:8080
Content-Type: text/html; charset=UTF-8
{
"account": "cliente001",
"name": "Cliente Empresarial ABC",
"money": 100.00,
"limitMoney": 500.00,
"feeRateGroup": "tarifa_mayorista",
"type": 0,
"lockType": 0,
"agentAccount": "",
"phoneBookLimit": 0,
"validTime": 0,
"memo": "Cuenta creada vía API"
}
{
"retCode": 0,
"exception": null
}
{
"retCode": -10007,
"exception": "Not found, operation failed."
}
La API VOS3000 utiliza tipos de datos específicos que deben respetarse para evitar errores de validación. Conocer estos tipos es esencial para implementaciones correctas.
| 📋 Tipo | 📏 Descripción | 📝 Ejemplo |
|---|---|---|
| String | Cadena de hasta 255 caracteres | “cliente001” |
| LongString | Cadena de hasta 65,535 caracteres | Reglas de marcado extensas |
| Integer | Número entero | 0, 1, 2, 100 |
| Double | Número decimal | 100.50, 0.015 |
| Boolean | Valor lógico | true, false |
| Long | Timestamp Unix en milisegundos | 1666195200000 |
| String[] | Array de strings | [“cuenta1”, “cuenta2”] |
Implementar la API VOS3000 de forma segura es crítico para proteger los datos de su operación y evitar accesos no autorizados que podrían resultar en fraude o pérdida de datos.
| 🔒 Práctica | 📋 Implementación |
|---|---|
| Whitelist de IP | Solo permitir IPs autorizadas en configuración de acceso |
| HTTPS obligatorio | Usar HTTPS para encriptación de datos en tránsito |
| Autenticación robusta | Implementar tokens de acceso con expiración |
| Rate limiting | Limitar número de peticiones por minuto |
| Logs de acceso | Registrar todas las llamadas API para auditoría |
| Validación de entrada | Validar todos los parámetros antes de enviar |
La API VOS3000 permite integración con múltiples sistemas externos para automatizar flujos de trabajo y sincronizar datos entre plataformas.
| 🔗 Sistema | 📋 Funcionalidad | 💡 Beneficio |
|---|---|---|
| CRM (Salesforce, etc.) | Sincronizar clientes, consultar saldo | Visión 360° del cliente |
| Pasarela de Pago | Recargas automáticas de saldo | Autoservicio 24/7 |
| Portal Web | Autogestión de clientes finales | Reducción de soporte |
| Sistema de Facturación | Exportar CDR para facturación | Conciliación automática |
| Monitoreo | Alertas de balance, tráfico inusual | Detección temprana de problemas |
No, el puerto HTTP/HTTPS para la API puede variar según la configuración de cada instalación. Verifique en su servidor qué puerto está configurado para el servicio web de VOS3000. El puerto por defecto suele ser 8080 pero puede modificarse.
El acceso a la API debe configurarse desde Gestión de Operación > Gestión de Interfaz Web en el cliente VOS3000. Allí debe agregar su IP a la lista de IPs permitidas y especificar qué endpoints puede utilizar.
Un retCode negativo indica error. Consulte el campo “exception” para ver la causa específica. Los errores comunes incluyen parámetros faltantes, tipos de datos incorrectos, cuentas inexistentes o permisos insuficientes.
Sí,这正是 la API está diseñada para esto. Puede crear un portal web donde los clientes consulten su saldo, vean CDR, recarguen saldo y gestionen sus configuraciones, todo mediante llamadas API al VOS3000.
¿Necesita desarrollar integraciones personalizadas con VOS3000 API? Ofrecemos servicios de desarrollo de portales de clientes, integración con CRM, sistemas de facturación y automatización de procesos. Nuestro equipo conoce la API en profundidad y puede implementar soluciones robustas y seguras.
📱 WhatsApp: +8801911119966
¡Automatice su operación VOS3000 con integraciones API profesionales!
For professional VOS3000 installations and deployment, VOS3000 Server Rental Solution:
📱 WhatsApp: +8801911119966
🌐 Website: www.vos3000.com
🌐 Blog: multahost.com/blog
📥 Downloads: VOS3000 Downloads
VOS3000 SIP authentication 401 Unauthorized vs 407 Proxy Authentication Required. Configure digest authentication challenge mode SS_AUTHCHALLENGEMODE in system parameters. Read More
VOS3000 RTP encryption setup guide covering XOR, RC4, and AES128 methods. Learn how to configure secure media streams using system… Read More
VOS3000 Caller Number Pool: Powerful CLI Rotation for Outbound Traffic The VOS3000 caller number pool feature solves a critical problem… Read More
This website uses cookies.