Interfases API
Introducción
En términos generales, las interfases (API, AMI, etc.) permiten la interconexión de la Plataforma VoIP con otros sistemas, de otros fabricantes, que proveen funciones o servicios adicionales.
Los proveedores de estos sistemas o servicios que dan apoyo a la Plataforma VoIP ofrecen Sistemas de Soporte a las Operaciones (OSS) y Sistemas de Soporte al Negocio (BSS), con funciones que son parte de la gestión administrativa de la empresa, el negocio, la institución o la organización.
Estos sistemas de soporte, a la gestión del negocio (BSS), están representados, entre otros, por los siguientes:
- CRM (Customer Relationship Management) para administrar el proceso de interacción con los clientes, mediante el análisis de datos.
- ERP (Enterprise Resource Planning) para la planificación de recursos empresariales, manejar los negocios asociados con las operaciones de producción y distribución de bienes o servicios.
- Billing/Charge System (Sistema de cargos o facturación) para la administración de los cargos, tráfico y tarifas telefónicas.
De acuerdo a la actividad y las operaciones de la empresa, a su sistema de gestión pre-existente y otros factores, relativos al control operativo, surgen diferentes opciones para la integración con la Plataforma VoIP.
Interfases
API (Application Programming Interface)
Los sistemas externos (3rd-part System, en el esquema siguiente) pueden comunicarse con la Plataforma VoIP a través de Interfases API (Application Programming Interface), en forma simple y segura, para el intercambio de datos.
En la siguiente imagen, el bloque indicado como API Interface incluye algunos ejemplos de sistemas de terceras partes, que pueden ser interconectados a la Plataforma VoIP.
Una de esas interfases API permite obtener la información correspondiente a los registros de llamadas en la Plataforma VoIP. Esa interfase se conoce como CDR API.
Para información más detallada, consultar Interfase CDR API.
AMI (Asterisk Manager Interface)
La Plataforma VoIP, cuenta además, con la Interfase AMI (Asterik Manager Interface), para monitoreo y administración de operaciones en la IP PBX, sobre una conexión TCP/IP.
La Interfase AMI es bidireccional, permitiendo el envío de información (tal como el registro detallado de llamadas) a un Sistema externo (basado en el concepto de integración del sistema telefónico con los sistemas de gestión o administración de la empresa: CTI), como así también recibir comandos (en el formato standard especificado por la interfase) para realizar operaciones, programáticamente, en la IP PBX y enviar la respuesta que se obtiene al realizar la operación. De igual manera, puede enviar eventos y notificaciones, originadas por cambios en el estado interno de la IP PBX.
Para información técnica más detallada sobre esta interfase, consultar API Guide.
Sistemas externos
CTI (Computer Telephony Integration)
La tecnología que permite que las interacciones en un sistema telefónico y en un sistema informático puedan ser integradas o coordinadas se conoce como CTI (Computer Telephony Integration). A medida que los canales de contacto se fueron expandiendo desde la voz, para incluir e-mail, web, chat, etc., la definición de CTI se ha expandido para incluir la integración de todos los canales de contacto del cliente, con los sistemas de cómputo. Esta tecnología incorpora todas las plataformas de telefonía: analógica, digital y VoIP.
El grado de compatibilidad, con los sistemas de gestión externos BSS (Business Support Systems), que brindan apoyo a las operaciones del negocio, varía según la información requerida por cada uno de éstos y los datos disponibles en la Plataforma VoIP. Los sistemas BSS incluyen: CRM (Customer Relationship Management), ERP (Enterprise Resource Planning) y Marcador predictivo (Predictive Dialer), entre otros.
A modo de ejemplo, (VoIP System --> BSS) toda la información que se presenta en el Reporte CDR de la Plataforma VoIP, está disponible a través de la Interfase CDR API, que a su vez permite la transferencia de datos al sistema de atención y gestión con el cliente (CRM) de la empresa, donde puede registrarse parte de esta información. En sentido contrario (BSS --> VoIP System), un sistema BSS para administración de clientes (tal como el CRM), a través de un marcador predictivo (Predictive Dialer), puede realizar llamadas desde el VoIP System, de acuerdo a ciertos criterios o una agenda predeterminada.
Los siguientes links son referencias* a sistemas externos:
IMPORTANTE:
*Los contenidos en los links a sitios externos, que se mencionan en esta sección, son responsabilidad de sus editores y publicadores.
Toda consulta al respecto debe ser dirigida a los administradores de los respectivos sitios.
- Sistemas de tarifación de código abierto: Open Source Billing Systems
- Software de tarifación de código abierto: Best Open Source VoIP Billing Software
- Sistema tarifador de llamadas: A2Billing
- Sistema tarifador de llamadas: ASTPP
- Sistema tarifador de llamadas: Freeside
- Sistema tarifador de llamadas: Hydra
- Sistema tarifador de llamadas: TimelyBill
Transferencia de datos
CDR API (Call Detail Record Application Programming Interface)
En los sistemas telefónicos, CDR es el registro que contiene la información detallada de las llamadas. También es conocido como Call Logs (registros de llamadas).
Este registro incluye detalles tales como: la fecha y hora de la llamada, su duración, información sobre el origen y el destino, el enrutamiento utilizado, etc. Toda esta información puede ser utilizada por los sistemas de gestión de la empresa para marketing, con fines estadísticos, para facturación, para mediciones de rendimiento, etc.
De acuerdo al tipo de información y a la frecuencia con que se requieren estos datos, en el sistema de gestión externo, a partir de los registros de llamadas, puede realizarse la transferencia a través de
- un proceso en batch (lotes de datos en archivos), o
- un proceso contínuo (interfase de datos).
Como ejemplo de proceso en batch (que puede ser automatizado por medio de scripts), realizando una consulta en la IPPBX, por medio de su interfase web (modo interactivo), se obtiene una tabla de datos con el siguiente resultado, desde la opción: Reportes > Reporte CDR:
Desde esta pantalla, que además dispone de filtros para modificar la consulta (lo cual permite modificar el contenido en el lote de datos), puede verse la opción Descargar los registros. Esta opción permite obtener un archivo con el resultado de la consulta realizada.
Dependiendo del tráfico de llamadas y cuando la frecuencia con que se requieren los datos (lo cual es dependiente de la utilización y el procesamiento de la información por parte del sistema de gestión) no es demasiado alta, tal como diaria, semanal, quincenal o mensual, puede utilizarse este proceso en batch, como una opción para transferir la información desde la Plataforma VoIP al sistema de gestión externo.
En caso contrario, cuando la frecuencia de actualización de los datos es más elevada o se requiere por demanda, para consolidar un período de tiempo determinado, tal como puede ocurrir en los sistemas de gestión hotelera (PMS), puede resultar más conveniente utilizar un proceso de transferencia contínuo, como el que se obtiene a través de la Interfase CDR API.
Revisión: 06/05/2025 - 19/12/2022