API de control de llamadas
Con la API de control de llamadas (servicio web) podrá integrar en programas CRM, bases de datos, etc., un sistema para controlar las llamadas que han sido realizadas desde la API de llamadas.
Activación API de control de llamadas
Este servicio debe activarse explícitamente dentro de la web, en Desarrolladores > Servicio web de llamadas (o en Desarrolladores > Permisos de las APIs y los servicios web). En esa sección también se pueden restringir (opcionalmente) las direcciones IP desde las que se puede llamar a través de esta aplicación web. Si usted tiene una dirección IP fija por favor introdúzcala aquí, aumenta la seguridad.
Forma de uso
La URL debe ser:
donde:
- 'principal' es su número de usuario de Telefácil.
- 'pass' es la contraseña de la cuenta.
- 'ref' es la referencia de la llamada, devuelta por la API de llamadas.
- 'orden' es el tipo de acción que quiere realizar sobre la llamada.
Cada orden puede tener más parámetros obligatorios.
Ejemplo
Tenga presente que, aunque la aplicación web es accesible mediante una URL, no debe poner nunca enlaces a esta aplicación directamente en el código fuente de sus páginas web, ya que sus visitantes podrían descubrir datos sensibles como su número de usuario y su contraseña simplemente mirando el código HTML.
La aplicación web debe ser llamada siempre desde el servidor, usando para ello alguna de las librerías que permite llamadas a servicios HTTPS.
He aquí un ejemplo en PHP usando cURL, cortesía de tuayudainformatica.com:
<?php
$usuario = '666111666';
$pass = 'MiClaveSecreta';
$ref = '5312345';
$orden = 'agregar_tiempo_maximo';
$minutos = '10';
$fd = fopen("/tmp/respuesta.txt", "w");
$curl = curl_init("https://scgi.duocom.es/cgi-bin/telefacil2/api_control_llamadas?
principal=${usuario}&pass=${pass}&ref=${ref}&orden=${orden}&minutos=${minutos}"); // LLAMADA DE LA URL
curl_setopt($curl, CURLOPT_FILE, $fd);
curl_setopt($curl, CURLOPT_HEADER, false); // PARA EVITAR DEVOLUCION DE CABEZERAS HTTP
curl_setopt($curl, CURLOPT_TIMEOUT, 5); // TIEMPO DE ESPERA
$output = curl_exec($curl); // EJECUTAMOS LA LLAMADA
curl_close($curl);
fclose($fd);
$output = substr($output, 0, 1); // SI OBTENEMOS 0 = ERROR / 1 = COMUNICACION OK
// en /tmp/respuesta.txt está la respuesta
?>
Indice
Página principal >> Desarrolladores >> API de control de llamadas.