El Call Control API es una interfaz de programación de aplicaciones (API) disponible para la Central Telefónica versión 11 y posteriores, que permite controlar las llamadas. Esta es una API avanzada que requiere experiencia en .NET, C# y telecomunicaciones. Solo debería ser utilizada en proyectos grandes. Para integración con sistemas CRM utilice el API de plug-in CRM de 3CXPhone.

Nota: 3CX NO PROVEE SOPORTE A DESARROLLADORES para esta API!

Con el Call Control API es posible:

  • Ver todas las llamadas activas en la PBX
  • Tomar control de las llamadas
  • Transferir llamadas
  • Desconectar llamadas
  • Programáticamente configurar ciertos parámetros de la Central Telefónica 3CX
  1. El API es una biblioteca .NET (DLL). Para poder utilizarla debe agregar una referencia en su proyecto a la biblioteca 3cxpscomcpp2.dll, que se encuentra en la Global Assembly cache (C:\Windows\Microsoft.NET\assembly\GAC_64) , y especificar el nombre de la aplicación, que debe ser único, en el archivo de configuración 3CXphonesystem.ini (ubicado en el directorio de instalación de la Central Telefónica 3CX).
  2. Vaya a la carpeta C:\Program Files\3CX Phone System\Instance1\Bin y copie el archivo 3CXPhoneSystem.ini a la carpeta Outputs de su proyecto de Visual Studio.
  3. Edite el archivo 3CXPhoneSystem.ini y agregue el nombre de la aplicación a la sección [ConfService], por ejemplo PhoneSystem.ApplicationName = “UniqueName”
  4. La comunicación sobre TCP es manejada internamente por la librería, y se realiza a través del puerto 5485.

Importante:

  • El API solo se encuentra disponible en el servidor donde está instalada la Central Telefónica 3CX. Es decir, la aplicación que necesite utilizar el API deberá estar instalada en el mismo servidor. Esto es así porque el servicio no aceptará conexiones remotas. Las conexiones solo son aceptadas cuando provienen del mismo equipo.
  • El Call Control API solo se encuentra disponible en las ediciones comerciales de la Central Telefónica 3CX.

La documentación del 3CX API, incluyendo aplicaciones de ejemplo que hacen que el uso de la misma se explique por si solo, puede ser encontrada aquí:

Paquete de documentación del 3CX API para la Central Telefónica 3CX versión 12

Paquete de documentación del 3CX API para la Central Telefónica 3CX versión 14

Los ejemplos del modelo de objetos incluidos en estos paquetes muestran como:

  • Agregar una extensión con un conjunto de propiedades
  • Remover extensiones
  • Actualizar extensiones
  • Agregar / eliminar una Recepcionista Digital
  • Agregar un teléfono por modelo
  • Cómo cambiar códigos de marcación de Parqueo
  • Cómo cambiar Información del Buzón de Voz
  • Agregar Extensiones de Fax
  • Crear reglas de desvío y perfiles
  • Crear un nuevo conjunto de avisos de sistema
  • Cómo utilizar la Call Control API para meterse en una llamada (Barge in)
  • Cómo utilizar la Call Control API para Transferir llamadas
  • Cómo utilizar la Call Control API para Desconectar llamadas
  • Cómo utilizar la Call Control API para utilizar las funciones de Escucha y Susurro
  • Cómo utilizar la Call Control API para Hacer llamadas
  • Cómo grabar llamadas
  • Transferencia de llamadas por DN
  • Transferencia de llamadas por ActiveConnection
  • Programar una conferencia

y muchos otros ejemplos…