El sistema VOS3000 API control llamadas permite a los operadores y sistemas externos controlar activamente las llamadas en la plataforma VOS3000. A diferencia de las APIs de monitoreo que solo proporcionan informacion, estas APIs permiten iniciar callbacks, reproducir audio en llamadas activas, terminar llamadas forzosamente, calcular tiempo disponible y crear registros CDR externos. Para soporte con la implementacion, contactenos por WhatsApp al +8801911119966.
El sistema VOS3000 API control llamadas Segun el manual oficial VOS3000 V2.1.9.07, las APIs de control de llamadas cubren seis funciones principales: CallBack para activar un callback IVR, PlayAudio para reproducir audio en una llamada activa, GetAvailableTime para calcular el tiempo disponible de un usuario, InterruptCall para terminar una llamada forzosamente, CreateCdr para crear registros CDR en sistemas externos, y el control de datos IVR externo. Cada una de estas funciones permite construir integraciones avanzadas que van mas alla del simple monitoreo.
================================================================
📞 SISTEMA VOS3000 API CONTROL LLAMADAS — MAPA DE FUNCIONES
================================================================
[1] 🔄 API CallBack
|-> Activar callback IVR
|-> Parametros: caller, callee, IVR flow
|-> Callback inmediato o programado
|-> Integracion con calling card
v
[2] 🔊 API PlayAudio
|-> Reproducir audio en llamada activa
|-> Archivo WAV especificado
|-> Reproduccion unidireccional
|-> Uso: anuncios, advertencias, musica
v
[3] ⏱️ API GetAvailableTime
|-> Calcular tiempo disponible
|-> Basado en balance y tarifa
|-> Prevencion de sobregiro
|-> Limite de duracion de llamada
v
[4] 🛑 API InterruptCall
|-> Terminar llamada forzosamente
|-> Por call_id especifico
|-> Razon de terminacion configurable
|-> Uso: fraude, balance agotado
v
[5] 📋 API CreateCdr
|-> Crear registro CDR externo
|-> Datos completos de llamada
|-> Integracion con sistemas billing
|-> Sincronizacion en tiempo real
v
[6] 🎛️ Control Datos IVR Externo
|-> Enviar datos a flujo IVR activo
|-> Modificar variables de sesion
|-> Dinamica desde sistema externo
|-> Personalizacion en tiempo real
================================================================
El sistema VOS3000 API control llamadas Las APIs de control de llamadas permiten a los sistemas externos no solo observar sino modificar activamente el estado de las llamadas en la plataforma. Mientras que las APIs de monitoreo son de solo lectura, las APIs de control son de escritura: pueden iniciar, modificar y terminar llamadas, convirtiendo a los sistemas externos en participantes activos de la operacion. (Sistema VOS3000 API Control Llamadas)
El sistema VOS3000 API control llamadas La importancia de estas APIs radica en que permiten automatizar operaciones que de otro modo requeririan intervencion manual del operador. Por ejemplo, un sistema antifraude puede terminar automaticamente una llamada sospechosa via InterruptCall, un sistema de prepago puede reproducir advertencias de balance bajo via PlayAudio, y un sistema CRM puede iniciar un callback al cliente via CallBack cuando un agente esta disponible.
El sistema VOS3000 API control llamadas La seguridad de estas APIs es critica porque pueden modificar el estado de las llamadas. Un acceso no autorizado podria terminar llamadas legítimas, iniciar llamadas fraudulentas, o reproducir audio no autorizado. Por eso, todas las APIs de control requieren autenticacion robusta y se recomienda restringir el acceso por direccion IP y usar HTTPS para todas las comunicaciones.
El sistema VOS3000 API control llamadas La API CallBack permite iniciar un callback IVR desde un sistema externo. Cuando se invoca esta API, VOS3000 origina una llamada al numero especificado y conecta al usuario con el flujo IVR configurado. El callback es fundamental para servicios de calling card, donde el usuario llama al sistema, introduce el numero destino, y el sistema devuelve la llamada para completar la conexion.
El sistema VOS3000 API control llamadas El proceso de callback funciona en dos fases. En la primera fase, VOS3000 llama al usuario (callback leg). Cuando el usuario contesta, se reproduce el flujo IVR configurado. En la segunda fase, el usuario ingresa el numero destino a traves del IVR, y VOS3000 establece la llamada al destino (destination leg). Ambas fases se ejecutan bajo el control del flujo IVR, permitiendo personalizar completamente la experiencia del usuario.
El sistema VOS3000 API control llamadas La API CallBack acepta parametros como: el numero de telefono al que se devolvera la llamada, el flujo IVR que se ejecutara, la pasarela por la que se originara la llamada, y datos adicionales que se pasaran al flujo IVR como variables. Esta flexibilidad permite implementar una amplia variedad de escenarios de callback.
El sistema VOS3000 API control llamadas Un caso de uso avanzado del callback es en servicios de call center outbound. Cuando un agente esta disponible, el sistema CRM invoca la API CallBack para llamar automaticamente al siguiente cliente en la cola de llamadas pendientes. Si el cliente contesta, se conecta con el agente; si no contesta, el sistema marca al siguiente cliente. Esto maximiza la productividad de los agentes al eliminar el tiempo de marcado manual.
| 🔧 Parametro | 📖 Descripcion | 📝 Ejemplo | ⚙️ Requerido |
|---|---|---|---|
| phone_number | Numero a llamar | +34612345678 | Si |
| ivr_flow | Flujo IVR a ejecutar | callback_main | Si |
| gateway | Pasarela de salida | GW-PSTN-01 | Si |
| caller_id | Caller ID mostrado | +34910000000 | No |
| variables | Datos para el IVR | account=12345 | No |
| schedule | Hora programada | 2024-01-15 14:00 | No |
El sistema VOS3000 API control llamadas La API PlayAudio permite reproducir un archivo de audio en una llamada activa. El audio se reproduce en el canal del llamante o del destinatario, permitiendo implementar funciones como anuncios en vivo, advertencias de balance bajo, musica en espera personalizada, o mensajes de cortesia antes de terminar la llamada.
El sistema VOS3000 API control llamadas La reproduccion de audio via PlayAudio es unidireccional: solo el participante especificado escucha el audio, mientras que el otro participante no escucha nada durante la reproduccion. Esto es importante para no interrumpir la conversacion del otro participante con el audio reproducido. Despues de que el audio termina, la comunicacion bidireccional se reanuda automaticamente.
El sistema VOS3000 API control llamadas Los archivos de audio para PlayAudio deben estar en formato WAV PCM a 8000 Hz, 16 bits, mono, que es el formato estandar para prompts IVR en VOS3000. Los archivos deben estar almacenados en el servidor VOS3000 en el directorio configurado para prompts. La API recibe la ruta del archivo como parametro y lo reproduce inmediatamente en la llamada especificada.
El sistema VOS3000 API control llamadas Un caso de uso comun de PlayAudio es reproducir advertencias de balance bajo durante una llamada de prepago. Cuando el sistema detecta que el balance del usuario esta por debajo de un umbral, invoca PlayAudio para reproducir un mensaje como “Su balance es bajo, le quedan 2 minutos de llamada”. Esto mejora la experiencia del usuario al mantenerlo informado sobre su balance sin interrumpir la llamada. Para asistencia con esta integracion, contactenos por WhatsApp al +8801911119966.
| 🔧 Parametro | 📖 Descripcion | 📝 Ejemplo | ⚙️ Requerido |
|---|---|---|---|
| call_id | Identificador de llamada | abc123def456 | Si |
| audio_file | Ruta del archivo WAV | /prompts/balance_low.wav | Si |
| target | Participante que escucha | caller / callee | Si |
| repeat | Numero de repeticiones | 1 | No |
El sistema VOS3000 API control llamadas La API GetAvailableTime permite calcular cuanto tiempo de llamada le queda disponible a un usuario basandose en su balance actual y la tarifa del destino que desea llamar. Esta funcion es esencial para servicios de prepago donde el tiempo de llamada esta limitado por el balance del usuario.
El sistema VOS3000 API control llamadas El calculo del tiempo disponible tiene en cuenta el balance del usuario, la tarifa del destino (que incluye el costo de conexion y el costo por minuto), y cualquier cargo adicional como impuestos o recargos. El resultado es el numero maximo de segundos que la llamada puede durar antes de que el balance del usuario se agote.
El sistema VOS3000 API control llamadas GetAvailableTime es fundamental para la prevencion de sobregiro. Sin esta API, el sistema tendria que depender de mecanismos internos de VOS3000 para limitar la duracion de la llamada, que pueden no ser lo suficientemente flexibles para las necesidades de cada operador. Con GetAvailableTime, los sistemas externos pueden calcular el tiempo disponible y usar InterruptCall para terminar la llamada cuando el tiempo se agota. (Sistema VOS3000 API Control Llamadas)
La API GetAvailableTime tambien puede usarse para informar al usuario cuanto tiempo tiene disponible antes de iniciar la llamada. En servicios de calling card, despues de que el usuario ingresa el numero destino, el sistema puede reproducir un mensaje como “Tiene 15 minutos disponibles para esta llamada” antes de conectar la llamada, dando al usuario la informacion necesaria para gestionar su tiempo.
| 🔧 Parametro | 📖 Descripcion | 📝 Ejemplo |
|---|---|---|
| account | Cuenta del usuario | 1001 |
| destination | Numero destino | +34612345678 |
| gateway | Pasarela a utilizar | GW-PSTN-01 |
La API InterruptCall permite terminar una llamada activa de manera forzosa desde un sistema externo. Esta API envia un BYE SIP a ambos participantes de la llamada, terminandola inmediatamente. Es la herramienta mas potente del sistema VOS3000 API control llamadas y debe usarse con cuidado.
Los casos de uso de InterruptCall incluyen: terminar llamadas fraudulentas detectadas por el sistema antifraude, terminar llamadas cuando el balance del usuario se agota, terminar llamadas cuando el sistema entra en modo de mantenimiento, y como parte de flujos de trabajo automatizados donde es necesario finalizar una llamada para iniciar otra. (Sistema VOS3000 API Control Llamadas)
Cuando InterruptCall termina una llamada, genera un evento de terminacion que se registra en los CDRs y se notifica a traves de los webhooks de estado de llamada. La razon de terminacion se puede configurar para que los sistemas externos puedan distinguir entre llamadas terminadas por el usuario y llamadas terminadas por el sistema via InterruptCall. (Sistema VOS3000 API Control Llamadas)
Es importante implementar controles de seguridad rigurosos para el uso de InterruptCall. Un uso incorrecto o no autorizado de esta API puede resultar en llamadas legítimas siendo terminadas, lo que causa mala experiencia para los usuarios y posible perdida de ingresos para el operador. Se recomienda registrar todas las invocaciones de InterruptCall con la razon de terminacion, el usuario que la autorizo, y la marca de tiempo. (Sistema VOS3000 API Control Llamadas)
| 🔧 Parametro | 📖 Descripcion | 📝 Ejemplo |
|---|---|---|
| call_id | Identificador de llamada | abc123def456 |
| reason | Razon de terminacion | balance_exhausted |
| notify | Notificar participantes | true / false |
La API CreateCdr permite crear registros CDR (Call Detail Record) en sistemas externos con los datos completos de una llamada. A diferencia de los CDRs internos de VOS3000 que se generan automaticamente, CreateCdr permite a los sistemas externos crear registros personalizados con campos adicionales o en formatos especificos requeridos por sistemas de facturacion de terceros.
Los datos incluidos en CreateCdr abarcan toda la informacion de la llamada: numero del llamante, numero del destinatario, hora de inicio, hora de contestacion, hora de fin, duracion total, duracion de conversacion, codec utilizado, pasarela de origen y destino, costo de la llamada, y balance restante del usuario. Esta informacion completa permite a los sistemas de facturacion procesar la llamada sin necesidad de consultar fuentes adicionales. (Sistema VOS3000 API Control Llamadas)
El control de datos IVR externo permite a los sistemas externos enviar datos a un flujo IVR activo, modificando las variables de sesion en tiempo real. Esto es util cuando el flujo IVR necesita informacion que no esta disponible en el momento de la llamada pero que un sistema externo puede proporcionar. Por ejemplo, un flujo IVR puede consultar el saldo de puntos de fidelidad del usuario desde un sistema CRM externo, y el CRM devuelve los datos a traves de esta API.
La combinacion de CreateCdr y control de datos IVR externo permite construir integraciones bidireccionales donde VOS3000 no solo envia datos a los sistemas externos sino que tambien recibe datos de ellos. Esta bidireccionalidad es esencial para implementaciones avanzadas donde VOS3000 funciona como un componente dentro de un ecosistema mas amplio de sistemas de telefonia y negocio.
| 📊 Campo | 📖 Descripcion | 📝 Ejemplo |
|---|---|---|
| call_id | Identificador unico | abc123def456 |
| caller | Numero llamante | 1001 |
| callee | Numero destinatario | +34612345678 |
| start_time | Hora inicio | 2024-01-15 10:30:00 |
| answer_time | Hora contestacion | 2024-01-15 10:30:05 |
| end_time | Hora fin | 2024-01-15 10:35:22 |
| duration | Duracion total | 322 segundos |
| talk_time | Tiempo conversacion | 317 segundos |
| cost | Costo llamada | 0.53 USD |
| 🏢 Escenario | 🔄 CallBack | 🔊 PlayAudio | 🛑 InterruptCall | 📋 CreateCdr |
|---|---|---|---|---|
| Calling Card | Si | Balance bajo | Balance agotado | Si |
| Call Center | Outbound | Anuncio | Timeout agente | Si |
| Antifraude | No | Advertencia | Llamada fraudulenta | Si |
| Prepago Movil | Si | Tiempo limite | Balance cero | Si |
================================================================
✅ CHECKLIST DE INTEGRACION — SISTEMA VOS3000 API CONTROL LLAMADAS
================================================================
✅ API CallBack
|-> [ ] Configurar autenticacion API
|-> [ ] Probar callback con flujo IVR
|-> [ ] Verificar caller ID mostrado
|-> [ ] Implementar manejo de errores
v
✅ API PlayAudio
|-> [ ] Preparar archivos de audio WAV
|-> [ ] Probar reproduccion en llamada activa
|-> [ ] Verificar audio unidireccional
|-> [ ] Configurar repeticiones
v
✅ API GetAvailableTime
|-> [ ] Probar calculo con diferentes tarifas
|-> [ ] Verificar precision del calculo
|-> [ ] Integrar con flujo de prepago
|-> [ ] Configurar advertencias de tiempo
v
✅ API InterruptCall
|-> [ ] Configurar permisos de acceso
|-> [ ] Probar terminacion de llamada
|-> [ ] Registrar razones de terminacion
|-> [ ] Implementar logs de auditoria
v
✅ CreateCdr y Datos IVR
|-> [ ] Definir formato de CDR externo
|-> [ ] Probar envio de datos IVR
|-> [ ] Verificar sincronizacion
|-> [ ] Configurar manejo de errores
================================================================
La integracion con el sistema VOS3000 API control llamadas debe seguir mejores practicas de desarrollo de software para garantizar la fiabilidad, seguridad y mantenibilidad de la solucion. La primera mejor practica es implementar un mecanismo de reintentos con backoff exponencial para todas las llamadas API. Si una llamada API falla por un problema temporal como un timeout de red, el sistema debe reintentar automaticamente con un retraso creciente entre intentos, sin superar un numero maximo de reintentos. Esto garantiza que problemas temporales no causen fallos permanentes en la integracion.
La segunda mejor practica es implementar logging exhaustivo de todas las llamadas API del sistema VOS3000 API control llamadas, incluyendo la solicitud enviada, la respuesta recibida, el tiempo de respuesta y cualquier error encontrado. Los logs son esenciales para diagnosticar problemas en produccion y para auditar el uso de las APIs. Se recomienda almacenar los logs en un sistema centralizado que permita busqueda y analisis, y configurar alertas automaticas cuando se detectan patrones anormales como un incremento en la tasa de errores.
La tercera mejor practica es implementar rate limiting en el lado del cliente para evitar sobrecargar el servidor VOS3000 con solicitudes API excesivas. Incluso si el servidor puede manejar un alto volumen de solicitudes, es buena practica espaciar las llamadas API de manera razonable y agrupar multiples operaciones en una sola solicitud cuando sea posible. Por ejemplo, en lugar de consultar GetPhoneOnline para cada telefono individualmente, se puede implementar un mecanismo de cache que almacene los resultados y solo consulte la API cuando el cache expire.
Para iniciar un callback, debe enviar una peticion HTTP POST a la API CallBack con los parametros requeridos: el numero de telefono al que llamar, el flujo IVR que se ejecutara, y la pasarela por la que se originara la llamada. VOS3000 validara los parametros, originara la llamada al numero especificado, y cuando el usuario conteste, ejecutara el flujo IVR configurado. Puede incluir variables adicionales que el flujo IVR podra utilizar para personalizar la experiencia. (Sistema VOS3000 API Control Llamadas)
PlayAudio soporta archivos WAV en formato PCM a 8000 Hz, 16 bits, mono. Este es el formato estandar para audio telefónico y es compatible con todos los codecs soportados por VOS3000. Si el archivo de audio esta en un formato diferente, debe convertirse antes de usarlo con PlayAudio. Los archivos deben estar almacenados en el servidor VOS3000 en el directorio configurado para prompts IVR.
Si, GetAvailableTime calcula el tiempo disponible en tiempo real basandose en el balance actual del usuario y la tarifa vigente para el destino especificado. Si el usuario esta en una llamada activa, el calculo tiene en cuenta el balance ya consumido durante la llamada actual. Esto garantiza que el tiempo devuelto sea preciso en el momento de la consulta, permitiendo a los sistemas externos tomar decisiones basadas en datos actualizados. (Sistema VOS3000 API Control Llamadas)
InterruptCall es seguro siempre que se implementen los controles adecuados. La API requiere autenticacion robusta y se recomienda restringir el acceso por direccion IP. Ademas, todas las invocaciones de InterruptCall deben registrarse con la razon de terminacion y el usuario que la autorizo, creando un trail de auditoria completo. Se recomienda implementar logicas de validacion en el sistema externo que verifiquen que la terminacion es legitima antes de invocar la API.
Si, la API CreateCdr permite crear registros CDR en sistemas externos con todos los datos de la llamada. Esto es util cuando se necesita integrar VOS3000 con un sistema de facturacion que requiere los datos en un formato especifico o con campos adicionales que no estan disponibles en los CDRs internos de VOS3000. Los CDRs externos se pueden crear en tiempo real usando los webhooks de estado de llamada como disparadores. (Sistema VOS3000 API Control Llamadas)
Para enviar datos a un flujo IVR activo, utilice la API de control de datos IVR externo. Esta API permite modificar las variables de sesion del flujo IVR en tiempo real, lo que permite que el flujo IVR responda a informacion proporcionada por sistemas externos. Por ejemplo, puede enviar el saldo de puntos de fidelidad del usuario desde un CRM para que el IVR lo anuncie durante la llamada. Las variables se envian como pares clave-valor y estan disponibles inmediatamente en el flujo IVR.
Cuando un callback falla (por ejemplo, el usuario no contesta o el numero esta ocupado), VOS3000 registra el fallo en los logs y puede notificar al sistema externo a traves de los webhooks de estado de llamada. El sistema externo puede entonces decidir si reintentar el callback, intentar un numero alternativo, o marcar la operacion como fallida. Se recomienda implementar una logica de reintentos con backoff exponencial para maximizar la probabilidad de contacto exitoso.
El sistema VOS3000 API control llamadas proporciona las herramientas necesarias para que los sistemas externos controlen activamente las llamadas en la plataforma. Desde iniciar callbacks hasta terminar llamadas, cada API esta disenada para automatizar operaciones que mejoran la eficiencia y la seguridad. Para asistencia profesional con la implementacion, contactenos por WhatsApp al +8801911119966 o visite vos3000.com.
Relacionado: API web integraciones | modulo IVR | registros CDR avanzado
Implementar el sistema VOS3000 API control llamadas puede transformar la operacion de su plataforma VoIP al permitir la automatizacion completa del ciclo de vida de las llamadas. Nuestro equipo esta listo para ayudarle. Escribanos por WhatsApp al +8801911119966 para recibir soporte personalizado.
For professional VOS3000 installations and deployment, VOS3000 Server Rental Solution:
📱 WhatsApp: +8801911119966
🌐 Website: www.vos3000.com
🌐 Blog: multahost.com/blog
Sistema VOS3000 API monitoreo: consulte telefono online, llamadas activas, webhooks de estado, alarmas y balance para integracion en tiempo real. Read More
Sistema VOS3000 IVR DTMF: configure deteccion inband, modo parse auto/manual, buzon de voz y navegacion para sistemas IVR. Read More
Sistema VOS3000 IVR callback: configure temporizacion KEEP_LINE, reporte estado UDP, alarma vocal, tono ringback personalizado CRBT y prioridad de codec… Read More
This website uses cookies.