Diferencia entre revisiones de «API de llamadas»

Revisión del 15:07 15 feb 2012

Con el servicio web de llamadas (web service) podrá integrar en programas CRM, bases de datos, etc., un sistema de realización de llamadas con el mismo funcionamiento que la aplicación Llamar vía web de su Oficina Virtual con cargo a su cuenta (ver artículo Llamadas desde la web).

Activación

Este servicio debe activarse explícitamente dentro de la web, en Opciones > Servicio web de llamadas. 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:

https://scgi.duocom.es/cgi-bin/telefacil2/telefacil_webcallservice?principal=xxxxxxxxx&llamante=xxxxxxxxx&llamado=xxxxxxxxx&pin=xxxx&mascara=xxxxxxxxx

donde:

'principal' es su número de usuario de Telefácil.
'llamante' es el número de teléfono desde el que quiere realizar la llamada (también puede ser un voip xxxxxxxx@telefacil.com, o una extensión extXXXX, como se explica más adelante).
'llamado' es el número de teléfono al que quiere llamar (nacional, móvil, internacional).
'pin' es el PIN de la cuenta.
'mascara' (opcional): si tiene algún número de Oficina Virtual, puede ponerlo aquí. Este será el número que le aparecerá al llamante y al llamado. Lea más sobre la máscara en la serie de artículos Máscara.
Opcionalmente, se puede pasar el parámetro 'grabar' (de esta manera: "&grabar=1") con el que se puede grabar la llamada (la grabación se enviará a su correo electrónico en formato MP3). Si tiene el servicio de grabaciones contratado, no hace falta que pase este parámetro.

Se realizarán dos llamadas, la primera al llamante y una vez contestado el sistema marcará el llamado.

Se cobrarán las dos llamadas: la llamada del sistema al 'llamante' + la llamada del sistema al 'llamado'. La tarifa que se aplica es la de "Acceso local". Consultar tarifas. Las llamadas a Voip son gratuitas.

El número llamante, además de un fijo, móvil, internacional o un voip, puede ser una extensión con el Desvío Especial activado (que sirve para poder transferir llamadas salientes a otras extensiones; lea Desvíos_de_extensión#Desv.C3.ADos_especiales). Para eso tendrá que poner el campo llamante de la forma extXXXX, donde XXXX es la extensión con el desvío especial activado. Por ejemplo, para la extensión 1234, sería: &llamante=ext1234.

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 pin 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';
  $pin = '0000';
  $llamante = '911000222';
  $llamado = '930000000';

  $curl = curl_init("https://scgi.duocom.es/cgi-bin/telefacil2/telefacil_webcallservice?
                     principal=${usuario}&llamante=${llamante}&llamado=${llamado}&pin=${pin}"); // LLAMADA DE LA URL
  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);
  $output = substr($output, 0, 1);            // SI OBTENEMOS 0 = ERROR /  1 = COMUNICACION OK
?>

Indice

Portada >> Desarrolladores >> Servicio web de llamadas.

@@ Línea 35: / Línea 35: @@
   <?php
-    function make_call($call_number) {
+    $usuario = '666111666';
-     //DATOS PARA EL SISTEMA WEB DE LLAMADAS
+   $pin = '0000';
-     $caller_system_id = '666111666';                            //SU NUMERO DE USUARIO - USTED
+   $llamante = '911000222';
-     $caller_system_pin = '0000';                                //SU CODIGO PIN - USTED
+   $llamado = '930000000';
-     $caller_system_number_source = $call_number;                //EMISOR DE LA LLAMADA - CLIENTE
-     $caller_system_number_destination = '930000000';            //RECEPTOR DE LA LLAMADA - USTED
+   $curl = curl_init("https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/{{PROD_LOWER}}_webcallservice?
+                      principal=${usuario}&llamante=${llamante}&llamado=${llamado}&pin=${pin}"); // LLAMADA DE LA URL
-     $curl = curl_init("https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/{{PROD_LOWER}}_webcallservice?
+   curl_setopt($curl, CURLOPT_HEADER, false);  // PARA EVITAR DEVOLUCION DE CABEZERAS HTTP
-                        principal=${caller_system_id}&llamante=${caller_system_number_source}&
+   curl_setopt($curl, CURLOPT_TIMEOUT, 5);     // TIEMPO DE ESPERA
-                        llamado=${caller_system_number_destination}&pin=${caller_system_pin}");        //LLAMADA DE LA URL
+   $output = curl_exec($curl);                 // EJECUTAMOS LA LLAMADA
-     curl_setopt($curl, CURLOPT_HEADER, false);                  //PARA EVITAR DEVOLUCION DE CABEZERAS HTTP
+   curl_close($curl);
-     curl_setopt($curl, CURLOPT_TIMEOUT, 5);                     //TIEMPO DE ESPERA
+   $output = substr($output, 0, 1);            // SI OBTENEMOS 0 = ERROR /  1 = COMUNICACION OK
-     $output = curl_exec($curl);
-     curl_close($curl);
-     //EXTRAER NUMERO DE OUTPUT
-     $output = substr($output, 0, 1);        //SI OBTENEMOS 0 = ERROR /  1 = COMUNICACION OK
-     return $output;
-   }
-   //LANZAMOS LA FUNCION PARA QUE EJECUTE LA LLAMADA
-   make_call($call_number);
   ?>