API de llamadas - Historial de revisiones

Dbautista: /* Forma de uso Servicio web de llamadas */

2021-07-02T11:50:14Z

‎Forma de uso Servicio web de llamadas

Lmoreno en 11:55 31 mar 2021

2021-03-31T11:55:51Z

Dbautista en 14:07 19 oct 2018

2018-10-19T14:07:10Z

Cbedoya en 12:38 23 jul 2018

2018-07-23T12:38:37Z

Dbautista en 11:16 21 dic 2016

2016-12-21T11:16:59Z

Dbautista en 09:48 21 dic 2016

2016-12-21T09:48:07Z

Dbautista en 08:19 8 abr 2016

2016-04-08T08:19:37Z

Dbautista: /* Ejemplo */

2016-02-23T09:37:53Z

‎Ejemplo

Dbautista en 13:18 11 feb 2016

2016-02-11T13:18:14Z

Dbautista: /* Valor retornado */

2016-02-10T15:00:40Z

‎Valor retornado

@@ Línea 19: / Línea 19: @@
 La URL debe ser:
-<pre>https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/{{PRE_CGI}}_webcallservice?principal=xxxxxxxxx&llamante=xxxxxxxxx&llamado=xxxxxxxxx&pass=xxxxxxxx&mascara=xxxxxxxxx</pre>
+https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/{{PRE_CGI}}_webcallservice?principal=xxxxxxxxx&llamante=xxxxxxxxx&llamado=xxxxxxxxx&pass=xxxxxxxx&mascara=xxxxxxxxx
 donde:

@@ Línea 19: / Línea 19: @@
 La URL debe ser:
-https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/{{PRE_CGI}}_webcallservice?principal=xxxxxxxxx&llamante=xxxxxxxxx&llamado=xxxxxxxxx&pass=xxxxxxxx&mascara=xxxxxxxxx
+<pre>https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/{{PRE_CGI}}_webcallservice?principal=xxxxxxxxx&llamante=xxxxxxxxx&llamado=xxxxxxxxx&pass=xxxxxxxx&mascara=xxxxxxxxx</pre>
 donde:
@@ Línea 65: / Línea 65: @@
 He aquí un ejemplo en PHP usando cURL, cortesía de tuayudainformatica.com:
+<pre>
   <?php
     $usuario = '666111666';
@@ Línea 84: / Línea 84: @@
     // en /tmp/respuesta.txt está la respuesta y la referencia
   ?>
+</pre>
 ----

@@ Línea 39: / Línea 39: @@
 ====Uso con nuestra aplicación de VoIP====
-También se puede mandar a hacer la llamada a un PC, ''smartphone'' o ''tablet'' que esté ejecutando nuestra aplicación. Para ello, tendremos que pasar a la URL los parámetros ya consabidos: 'principal', 'pass', 'llamado', 'llamante' (debe ser el usuario VOIP que esté registrado en la aplicación, de la forma usuario@{{DOMINIO}}); y además 'mac', que será la dirección MAC del equipo (PC, smartphone o tablet) donde se ejecute la aplicación.
+Use la [[API de Voip]] para mandar a hacer la llamada a un PC, ''smartphone'' o ''tablet'' que esté ejecutando nuestra aplicación Voip Duocom.
 ===Valor retornado===

← Revisión anterior		Revisión del 12:38 23 jul 2018
Línea 8:		Línea 8:

	Con la API de llamadas (servicio web) 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]]).		Con la API de llamadas (servicio web) 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]]).
		+
		+	Si no sabe lo que es una API lea [[que es una api\|¿Qué son las APIs de {{PRODUCTO}}?]]

	==Activación API de llamadas==		==Activación API de llamadas==

@@ Línea 13: / Línea 13: @@
 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 Servicio web de llamadas===
+==Forma de uso Servicio web de llamadas==
 La URL debe ser:

@@ Línea 3: / Línea 3: @@
 |titlemode=append
 |keywords=llamar por internet, llamadas por internet, VOIP, internet llamadas, atencion al cliente, CRM, BBDD, llamar desde la pagina web, servicio web, telefonia web
-|description= Podrá llama sin necesidad de la página Web, solo accediendo a la base de dato, CRM, web... con las mejores tarifas.
+|description= Podrá llamar sin necesidad de la página Web, solo accediendo a la base de datos, CRM, web... con las mejores tarifas.
 }}

@@ Línea 17: / Línea 17: @@
 La URL debe ser:
-https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/{{PRE_CGI}}_webcallservice?principal=xxxxxxxxx&llamante=xxxxxxxxx&llamado=xxxxxxxxx&pin=xxxx&mascara=xxxxxxxxx
+https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/{{PRE_CGI}}_webcallservice?principal=xxxxxxxxx&llamante=xxxxxxxxx&llamado=xxxxxxxxx&pass=xxxxxxxx&mascara=xxxxxxxxx
 donde:
@@ Línea 24: / Línea 24: @@
 * 'llamante' es el número de teléfono desde el que quiere realizar la llamada (también puede ser un voip xxxxxxxx@{{DOMINIO}}, 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.
+* 'pass' es la contraseña 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.
@@ Línea 37: / Línea 37: @@
 ====Uso con nuestra aplicación de VoIP====
-También se puede mandar a hacer la llamada a un PC, ''smartphone'' o ''tablet'' que esté ejecutando nuestra aplicación. Para ello, tendremos que pasar a la URL los parámetros ya consabidos: 'principal', 'pin', 'llamado', 'llamante' (debe ser el usuario VOIP que esté registrado en la aplicación, de la forma usuario@{{DOMINIO}}); y además 'mac', que será la dirección MAC del equipo (PC, smartphone o tablet) donde se ejecute la aplicación.
+También se puede mandar a hacer la llamada a un PC, ''smartphone'' o ''tablet'' que esté ejecutando nuestra aplicación. Para ello, tendremos que pasar a la URL los parámetros ya consabidos: 'principal', 'pass', 'llamado', 'llamante' (debe ser el usuario VOIP que esté registrado en la aplicación, de la forma usuario@{{DOMINIO}}); y además 'mac', que será la dirección MAC del equipo (PC, smartphone o tablet) donde se ejecute la aplicación.
 Por ejemplo:
-  https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/{{PRE_CGI}}_webcallservice?principal=912345678&llamante=902955955.567@{{DOMINIO}}&llamado=0012127773456&pin=1876&mac=00:EF:99:2A:B3:88
+  https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/{{PRE_CGI}}_webcallservice?principal=912345678&llamante=902955955.567@{{DOMINIO}}&llamado=0012127773456&pass=MiClaveSecreta&mac=00:EF:99:2A:B3:88
 ===Valor retornado===
@@ Línea 62: / Línea 62: @@
 ===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.
+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.
@@ Línea 70: / Línea 70: @@
   <?php
     $usuario = '666111666';
-    $pin = '0000';
+    $pass = 'MiClaveSecreta';
     $llamante = '911000222';
     $llamado = '930000000';
@@ Línea 76: / Línea 76: @@
     $fd = fopen("/tmp/respuesta.txt", "w");
     $curl = curl_init("https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/{{PRE_CGI}}_webcallservice?
-                       principal=${usuario}&llamante=${llamante}&llamado=${llamado}&pin=${pin}"); // LLAMADA DE LA URL
+                       principal=${usuario}&llamante=${llamante}&llamado=${llamado}&pass=${pass}"); // LLAMADA DE LA URL
     curl_setopt($curl, CURLOPT_FILE, $fd);
     curl_setopt($curl, CURLOPT_HEADER, false);  // PARA EVITAR DEVOLUCION DE CABEZERAS HTTP

@@ Línea 74: / Línea 74: @@
     $llamado = '930000000';
     $curl = curl_init("https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/{{PRE_CGI}}_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
   ?>

← Revisión anterior		Revisión del 13:18 11 feb 2016
Línea 51:		Línea 51:
	1		1
	53010203		53010203
		+
		+	Con la referencia interna de la llamada usted podrá relacionar el inicio de la llamada con el final de la misma en la [[API de consumos]] y en las [[Opciones avanzadas de aviso de llamada cobrada]].

	Ejemplo de respuesta incorrecta:		Ejemplo de respuesta incorrecta:

← Revisión anterior		Revisión del 15:00 10 feb 2016
Línea 45:		Línea 45:
	===Valor retornado===		===Valor retornado===

−	Si todo funciona correctamente, la API devolverá un 1 seguido de un salto de línea y la referencia interna de la llamada (única en el día, se puede repetir en días diferentes). Si no, se devolverá un 0 seguido de un salto de línea y el mensaje de error correspondiente. Ejemplo de respuesta correcta:	+	Si todo funciona correctamente, la API devolverá un 1 seguido de un salto de línea y la referencia interna de la llamada (única en el día, se puede repetir en días diferentes). Si no, se devolverá un 0 seguido de un salto de línea y el mensaje de error correspondiente.
		+
		+	Ejemplo de respuesta correcta:

	1		1