API de buzones - Historial de revisiones

Dbautista en 12:13 2 jul 2021

2021-07-02T12:13:34Z

Lmoreno: /* URL */

2021-03-31T11:49:41Z

‎URL

Lmoreno en 11:49 31 mar 2021

2021-03-31T11:49:12Z

Cbedoya en 12:37 23 jul 2018

2018-07-23T12:37:38Z

Dbautista en 08:16 8 abr 2016

2016-04-08T08:16:01Z

Lmoreno en 11:29 22 feb 2016

2016-02-22T11:29:19Z

Dbautista en 11:58 3 feb 2016

2016-02-03T11:58:02Z

Cbedoya en 10:21 24 dic 2015

2015-12-24T10:21:37Z

Cbedoya en 11:17 13 nov 2015

2015-11-13T11:17:16Z

Cbedoya en 11:14 13 nov 2015

2015-11-13T11:14:02Z

@@ Línea 12: / Línea 12: @@
 La API de desvíos se ofrece como un servicio web, accesible mediante la URL:
-<pre>https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_buzon?principal=xxxxxxxxx&pass=xxxxxxxx&origen=xxxxxxxxx</pre>
+ https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_buzon?principal=xxxxxxxxx&pass=xxxxxxxx&origen=xxxxxxxxx
 Para los clientes de Canarias, la URL es:
-<pre>https://cgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_buzon?principal=xxxxxxxxx&pass=xxxxxxxx&origen=xxxxxxxxx</pre>
+ https://cgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_buzon?principal=xxxxxxxxx&pass=xxxxxxxx&origen=xxxxxxxxx
 Para acceder a esta API hay que tener dado de alta un número de Oficina Virtual (Número Virtual, Centralita Virtual, Fax Virtual y Botón Web). En la pestaña de "Buzón" de cualquiera de estos números, sección "Opciones Avanzadas" (o en Desarrolladores > Permisos de las APIs), se puede activar esta API (por defecto se encuentra desactivada) y restringir su uso según la IP de acceso a la misma (esto es aconsejable para aumentar la seguridad si se tiene una dirección IP fija).
@@ Línea 38: / Línea 38: @@
 En este último caso, obviamente sólo es posible consultar los buzones de voz de Números Virtuales y extensiones de Centralita que tengan activado el servicio VoIP. La URL sería así:
-<pre>https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_buzon?usuario_voip=xxxxxxxxx&password_voip=XXXXXXXXX</pre>
+ https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_buzon?usuario_voip=xxxxxxxxx&password_voip=XXXXXXXXX
 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.
@@ Línea 49: / Línea 49: @@
 Para listar los mensajes de un buzón, hemos de pasar los parámetros obligatorios (ver capítulo anterior) y el parámetro accion=listar. Por ejemplo, para listar los mensajes del número virtual 902009955:
-<pre>https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_buzon?principal=xxxxxxxxx&pass=miclavesecreta&origen=902009955&accion=listar</pre>
+ https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_buzon?principal=xxxxxxxxx&pass=miclavesecreta&origen=902009955&accion=listar
 O para listar los mensajes de la extensión 34:
-<pre>https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_buzon?principal=xxxxxxxxx&pass=miclavesecreta&origen=34&accion=listar</pre>
+ https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_buzon?principal=xxxxxxxxx&pass=miclavesecreta&origen=34&accion=listar
 Si queremos, por otro lado, los faxes recibidos en el número 902009956:
-<pre>https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_buzon?principal=xxxxxxxxx&pass=miclavesecreta&origen=902009956&accion=listar</pre>
+ https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_buzon?principal=xxxxxxxxx&pass=miclavesecreta&origen=902009956&accion=listar
 O, por ejemplo, las grabaciones de la cuenta:
-<pre>https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_buzon?principal=xxxxxxxxx&pass=miclavesecreta&origen=grabaciones&accion=listar</pre>
+ https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_buzon?principal=xxxxxxxxx&pass=miclavesecreta&origen=grabaciones&accion=listar
 Opcionalmente, puede especificar rangos de la siguiente manera:
@@ Línea 108: / Línea 108: @@
 Para descargar un fichero con un mensaje de buzón, deberemos conocer el nombre del fichero. Eso se puede saber mirando el campo <fichero> de cada <entrada> de la respuesta <buzon> que da el listado de mensajes (ver capítulo anterior). Además del nombre del fichero y los parámetros obligatorios, hay que pasar el parámetro accion=descargar, de la siguiente manera:
-<pre>https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_buzon?principal=xxxxxxxxx&pass=miclavesecreta&origen=902009956&accion=descargar&fichero=2012-04-09_15-45-04_Lunes_987654321_822200956.pdf
+ https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_buzon?principal=xxxxxxxxx&pass=miclavesecreta&origen=902009956&accion=descargar&fichero=2012-04-09_15-45-04_Lunes_987654321_822200956.pdf
-</pre>
 Los ficheros pueden ser de diferentes tipos:
@@ Línea 123: / Línea 123: @@
 Para eliminar un solo mensaje de buzón, deberemos conocer el nombre del fichero de ese mensaje. Eso se puede saber mirando el campo <fichero> de cada <entrada> de la respuesta <buzon> que da el listado de mensajes (ver capítulo de Listar mensajes). Además del nombre del fichero y los parámetros obligatorios, hay que pasar el parámetro accion=borrar, de la siguiente manera:
-<pre>https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_buzon?principal=xxxxxxxxx&pass=miclavesecreta&origen=902009956&accion=borrar&fichero=2012-04-09_15-45-04_Lunes_987654321_822200956.pdf</pre>
+ https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_buzon?principal=xxxxxxxxx&pass=miclavesecreta&origen=902009956&accion=borrar&fichero=2012-04-09_15-45-04_Lunes_987654321_822200956.pdf
 Para borrar varios mensajes de buzón, ponemos accion=borrar_varios, especificamos el número de ficheros con el parámetro "n" y enviamos los ficheros como fichero0, fichero1, fichero2... fichero(n-1). Por ejemplo:
-<pre>https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_buzon?principal=xxxxxxxxx&pass=miclavesecreta&origen=902009956&accion=borrar_varios&n=2&fichero0=2012-04-09_15-45-04_Lunes_987654321_822200956.pdf&fichero1=2013-02-11_16-43-12_Lunes_912345678_822200956.pdf</pre>
+ https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_buzon?principal=xxxxxxxxx&pass=miclavesecreta&origen=902009956&accion=borrar_varios&n=2&fichero0=2012-04-09_15-45-04_Lunes_987654321_822200956.pdf&fichero1=2013-02-11_16-43-12_Lunes_912345678_822200956.pdf
 Por último, también se pueden borrar todos los mensajes de un buzón con accion=borrar_todo:
-<pre>https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_buzon?principal=xxxxxxxxx&pass=miclavesecreta&origen=902009956&accion=borrar_todo</pre>
+ https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_buzon?principal=xxxxxxxxx&pass=miclavesecreta&origen=902009956&accion=borrar_todo
@@ Línea 138: / Línea 138: @@
 Para marcar/desmarcar como escuchado (o leído en el caso de los faxes) un mensaje de buzón, deberemos conocer el nombre del fichero de ese mensaje. Eso se puede saber mirando el campo <fichero> de cada <entrada> de la respuesta <buzon> que da el listado de mensajes (ver capítulo de Listar mensajes). Además del nombre del fichero y los parámetros obligatorios, hay que pasar el parámetro accion=marcar (o accion=desmarcar), de la siguiente manera:
-<pre>https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_buzon?principal=xxxxxxxxx&pass=miclavesecreta&origen=902009956&accion=marcar&fichero=2012-04-09_15-45-04_Lunes_987654321_822200956.pdf</pre>
+ https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_buzon?principal=xxxxxxxxx&pass=miclavesecreta&origen=902009956&accion=marcar&fichero=2012-04-09_15-45-04_Lunes_987654321_822200956.pdf

@@ Línea 12: / Línea 12: @@
 La API de desvíos se ofrece como un servicio web, accesible mediante la URL:
- https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_buzon?principal=xxxxxxxxx&pass=xxxxxxxx&origen=xxxxxxxxx
+<pre>https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_buzon?principal=xxxxxxxxx&pass=xxxxxxxx&origen=xxxxxxxxx</pre>
 Para los clientes de Canarias, la URL es:
@@ Línea 19: / Línea 19: @@
 Para acceder a esta API hay que tener dado de alta un número de Oficina Virtual (Número Virtual, Centralita Virtual, Fax Virtual y Botón Web). En la pestaña de "Buzón" de cualquiera de estos números, sección "Opciones Avanzadas" (o en Desarrolladores > Permisos de las APIs), se puede activar esta API (por defecto se encuentra desactivada) y restringir su uso según la IP de acceso a la misma (esto es aconsejable para aumentar la seguridad si se tiene una dirección IP fija).
 ===Parámetros obligatorios===

@@ Línea 16: / Línea 16: @@
 Para los clientes de Canarias, la URL es:
- https://cgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_buzon?principal=xxxxxxxxx&pass=xxxxxxxx&origen=xxxxxxxxx
+<pre>https://cgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_buzon?principal=xxxxxxxxx&pass=xxxxxxxx&origen=xxxxxxxxx</pre>
 Para acceder a esta API hay que tener dado de alta un número de Oficina Virtual (Número Virtual, Centralita Virtual, Fax Virtual y Botón Web). En la pestaña de "Buzón" de cualquiera de estos números, sección "Opciones Avanzadas" (o en Desarrolladores > Permisos de las APIs), se puede activar esta API (por defecto se encuentra desactivada) y restringir su uso según la IP de acceso a la misma (esto es aconsejable para aumentar la seguridad si se tiene una dirección IP fija).
@@ Línea 39: / Línea 39: @@
 En este último caso, obviamente sólo es posible consultar los buzones de voz de Números Virtuales y extensiones de Centralita que tengan activado el servicio VoIP. La URL sería así:
- https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_buzon?usuario_voip=xxxxxxxxx&password_voip=XXXXXXXXX
+<pre>https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_buzon?usuario_voip=xxxxxxxxx&password_voip=XXXXXXXXX</pre>
 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.
@@ Línea 50: / Línea 50: @@
 Para listar los mensajes de un buzón, hemos de pasar los parámetros obligatorios (ver capítulo anterior) y el parámetro accion=listar. Por ejemplo, para listar los mensajes del número virtual 902009955:
- https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_buzon?principal=xxxxxxxxx&pass=miclavesecreta&origen=902009955&accion=listar
+<pre>https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_buzon?principal=xxxxxxxxx&pass=miclavesecreta&origen=902009955&accion=listar</pre>
 O para listar los mensajes de la extensión 34:
- https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_buzon?principal=xxxxxxxxx&pass=miclavesecreta&origen=34&accion=listar
+<pre>https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_buzon?principal=xxxxxxxxx&pass=miclavesecreta&origen=34&accion=listar</pre>
 Si queremos, por otro lado, los faxes recibidos en el número 902009956:
- https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_buzon?principal=xxxxxxxxx&pass=miclavesecreta&origen=902009956&accion=listar
+<pre>https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_buzon?principal=xxxxxxxxx&pass=miclavesecreta&origen=902009956&accion=listar</pre>
 O, por ejemplo, las grabaciones de la cuenta:
- https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_buzon?principal=xxxxxxxxx&pass=miclavesecreta&origen=grabaciones&accion=listar
+<pre>https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_buzon?principal=xxxxxxxxx&pass=miclavesecreta&origen=grabaciones&accion=listar</pre>
 Opcionalmente, puede especificar rangos de la siguiente manera:
@@ Línea 71: / Línea 71: @@
 La respuesta a esta petición se suministra en XML:
- <?xml version="1.0" encoding="UTF-8" ?>
+<pre><?xml version="1.0" encoding="UTF-8" ?>
   <buzon>
@@ Línea 101: / Línea 101: @@
     <leidos>2</leidos>
     <no_leidos>1</no_leidos>
-  </buzon>
+  </buzon></pre>
 A partir del 6 de mayo de 2015, en el buzón de grabaciones puede aparecer un campo llamado 'ref_id'. Este campo numérico referencia unívocamente a la llamada dentro del día correspondiente (las referencias se pueden repetir entre días distintos). Se puede usar este campo para enlazar la grabación con la llamada en la [[API de consumos]].
@@ Línea 109: / Línea 109: @@
 Para descargar un fichero con un mensaje de buzón, deberemos conocer el nombre del fichero. Eso se puede saber mirando el campo <fichero> de cada <entrada> de la respuesta <buzon> que da el listado de mensajes (ver capítulo anterior). Además del nombre del fichero y los parámetros obligatorios, hay que pasar el parámetro accion=descargar, de la siguiente manera:
- https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_buzon?principal=xxxxxxxxx&pass=miclavesecreta&origen=902009956&accion=descargar&fichero=2012-04-09_15-45-04_Lunes_987654321_822200956.pdf
+<pre>https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_buzon?principal=xxxxxxxxx&pass=miclavesecreta&origen=902009956&accion=descargar&fichero=2012-04-09_15-45-04_Lunes_987654321_822200956.pdf
+</pre>
 Los ficheros pueden ser de diferentes tipos:
@@ Línea 124: / Línea 124: @@
 Para eliminar un solo mensaje de buzón, deberemos conocer el nombre del fichero de ese mensaje. Eso se puede saber mirando el campo <fichero> de cada <entrada> de la respuesta <buzon> que da el listado de mensajes (ver capítulo de Listar mensajes). Además del nombre del fichero y los parámetros obligatorios, hay que pasar el parámetro accion=borrar, de la siguiente manera:
- https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_buzon?principal=xxxxxxxxx&pass=miclavesecreta&origen=902009956&accion=borrar&fichero=2012-04-09_15-45-04_Lunes_987654321_822200956.pdf
+<pre>https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_buzon?principal=xxxxxxxxx&pass=miclavesecreta&origen=902009956&accion=borrar&fichero=2012-04-09_15-45-04_Lunes_987654321_822200956.pdf</pre>
 Para borrar varios mensajes de buzón, ponemos accion=borrar_varios, especificamos el número de ficheros con el parámetro "n" y enviamos los ficheros como fichero0, fichero1, fichero2... fichero(n-1). Por ejemplo:
- https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_buzon?principal=xxxxxxxxx&pass=miclavesecreta&origen=902009956&accion=borrar_varios&n=2&fichero0=2012-04-09_15-45-04_Lunes_987654321_822200956.pdf&fichero1=2013-02-11_16-43-12_Lunes_912345678_822200956.pdf
+<pre>https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_buzon?principal=xxxxxxxxx&pass=miclavesecreta&origen=902009956&accion=borrar_varios&n=2&fichero0=2012-04-09_15-45-04_Lunes_987654321_822200956.pdf&fichero1=2013-02-11_16-43-12_Lunes_912345678_822200956.pdf</pre>
 Por último, también se pueden borrar todos los mensajes de un buzón con accion=borrar_todo:
- https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_buzon?principal=xxxxxxxxx&pass=miclavesecreta&origen=902009956&accion=borrar_todo
+<pre>https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_buzon?principal=xxxxxxxxx&pass=miclavesecreta&origen=902009956&accion=borrar_todo</pre>
@@ Línea 139: / Línea 139: @@
 Para marcar/desmarcar como escuchado (o leído en el caso de los faxes) un mensaje de buzón, deberemos conocer el nombre del fichero de ese mensaje. Eso se puede saber mirando el campo <fichero> de cada <entrada> de la respuesta <buzon> que da el listado de mensajes (ver capítulo de Listar mensajes). Además del nombre del fichero y los parámetros obligatorios, hay que pasar el parámetro accion=marcar (o accion=desmarcar), de la siguiente manera:
- https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_buzon?principal=xxxxxxxxx&pass=miclavesecreta&origen=902009956&accion=marcar&fichero=2012-04-09_15-45-04_Lunes_987654321_822200956.pdf
+<pre>https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_buzon?principal=xxxxxxxxx&pass=miclavesecreta&origen=902009956&accion=marcar&fichero=2012-04-09_15-45-04_Lunes_987654321_822200956.pdf</pre>

← Revisión anterior		Revisión del 12:37 23 jul 2018
Línea 7:		Línea 7:

	===URL===		===URL===
		+
		+	Si no sabe lo que es una API lea [[que es una api\|¿Qué son las APIs de {{PRODUCTO}}?]]

	La API de desvíos se ofrece como un servicio web, accesible mediante la URL:		La API de desvíos se ofrece como un servicio web, accesible mediante la URL:

@@ Línea 10: / Línea 10: @@
 La API de desvíos se ofrece como un servicio web, accesible mediante la URL:
-  https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_buzon?principal=xxxxxxxxx&pin=1234&origen=xxxxxxxxx
+  https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_buzon?principal=xxxxxxxxx&pass=xxxxxxxx&origen=xxxxxxxxx
 Para los clientes de Canarias, la URL es:
-  https://cgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_buzon?principal=xxxxxxxxx&pin=1234&origen=xxxxxxxxx
+  https://cgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_buzon?principal=xxxxxxxxx&pass=xxxxxxxx&origen=xxxxxxxxx
 Para acceder a esta API hay que tener dado de alta un número de Oficina Virtual (Número Virtual, Centralita Virtual, Fax Virtual y Botón Web). En la pestaña de "Buzón" de cualquiera de estos números, sección "Opciones Avanzadas" (o en Desarrolladores > Permisos de las APIs), se puede activar esta API (por defecto se encuentra desactivada) y restringir su uso según la IP de acceso a la misma (esto es aconsejable para aumentar la seguridad si se tiene una dirección IP fija).
@@ Línea 22: / Línea 22: @@
 * 'principal' es el número de teléfono del cliente (con el que se dio de alta), también llamado "usuario de la cuenta {{PRODUCTO}}".
-* 'pin' es el PIN de la cuenta {{PRODUCTO}}.
+* 'pass' es la contraseña de la cuenta {{PRODUCTO}}.
 * 'origen':
 ** Si quiere consultar el buzón de voz de un Número Virtual, 'origen' es el Número Virtual.
@@ Línea 39: / Línea 39: @@
   https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_buzon?usuario_voip=xxxxxxxxx&password_voip=XXXXXXXXX
-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 48: / Línea 48: @@
 Para listar los mensajes de un buzón, hemos de pasar los parámetros obligatorios (ver capítulo anterior) y el parámetro accion=listar. Por ejemplo, para listar los mensajes del número virtual 902009955:
-  https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_buzon?principal=xxxxxxxxx&pin=1234&origen=902009955&accion=listar
+  https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_buzon?principal=xxxxxxxxx&pass=miclavesecreta&origen=902009955&accion=listar
 O para listar los mensajes de la extensión 34:
-  https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_buzon?principal=xxxxxxxxx&pin=1234&origen=34&accion=listar
+  https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_buzon?principal=xxxxxxxxx&pass=miclavesecreta&origen=34&accion=listar
 Si queremos, por otro lado, los faxes recibidos en el número 902009956:
-  https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_buzon?principal=xxxxxxxxx&pin=1234&origen=902009956&accion=listar
+  https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_buzon?principal=xxxxxxxxx&pass=miclavesecreta&origen=902009956&accion=listar
 O, por ejemplo, las grabaciones de la cuenta:
-  https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_buzon?principal=xxxxxxxxx&pin=1234&origen=grabaciones&accion=listar
+  https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_buzon?principal=xxxxxxxxx&pass=miclavesecreta&origen=grabaciones&accion=listar
 Opcionalmente, puede especificar rangos de la siguiente manera:
@@ Línea 107: / Línea 107: @@
 Para descargar un fichero con un mensaje de buzón, deberemos conocer el nombre del fichero. Eso se puede saber mirando el campo <fichero> de cada <entrada> de la respuesta <buzon> que da el listado de mensajes (ver capítulo anterior). Además del nombre del fichero y los parámetros obligatorios, hay que pasar el parámetro accion=descargar, de la siguiente manera:
-  https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_buzon?principal=xxxxxxxxx&pin=1234&origen=902009956&accion=descargar&fichero=2012-04-09_15-45-04_Lunes_987654321_822200956.pdf
+  https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_buzon?principal=xxxxxxxxx&pass=miclavesecreta&origen=902009956&accion=descargar&fichero=2012-04-09_15-45-04_Lunes_987654321_822200956.pdf
 Los ficheros pueden ser de diferentes tipos:
@@ Línea 122: / Línea 122: @@
 Para eliminar un solo mensaje de buzón, deberemos conocer el nombre del fichero de ese mensaje. Eso se puede saber mirando el campo <fichero> de cada <entrada> de la respuesta <buzon> que da el listado de mensajes (ver capítulo de Listar mensajes). Además del nombre del fichero y los parámetros obligatorios, hay que pasar el parámetro accion=borrar, de la siguiente manera:
-  https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_buzon?principal=xxxxxxxxx&pin=1234&origen=902009956&accion=borrar&fichero=2012-04-09_15-45-04_Lunes_987654321_822200956.pdf
+  https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_buzon?principal=xxxxxxxxx&pass=miclavesecreta&origen=902009956&accion=borrar&fichero=2012-04-09_15-45-04_Lunes_987654321_822200956.pdf
 Para borrar varios mensajes de buzón, ponemos accion=borrar_varios, especificamos el número de ficheros con el parámetro "n" y enviamos los ficheros como fichero0, fichero1, fichero2... fichero(n-1). Por ejemplo:
-  https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_buzon?principal=xxxxxxxxx&pin=1234&origen=902009956&accion=borrar_varios&n=2&fichero0=2012-04-09_15-45-04_Lunes_987654321_822200956.pdf&fichero1=2013-02-11_16-43-12_Lunes_912345678_822200956.pdf
+  https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_buzon?principal=xxxxxxxxx&pass=miclavesecreta&origen=902009956&accion=borrar_varios&n=2&fichero0=2012-04-09_15-45-04_Lunes_987654321_822200956.pdf&fichero1=2013-02-11_16-43-12_Lunes_912345678_822200956.pdf
 Por último, también se pueden borrar todos los mensajes de un buzón con accion=borrar_todo:
-  https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_buzon?principal=xxxxxxxxx&pin=1234&origen=902009956&accion=borrar_todo
+  https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_buzon?principal=xxxxxxxxx&pass=miclavesecreta&origen=902009956&accion=borrar_todo
@@ Línea 137: / Línea 137: @@
 Para marcar/desmarcar como escuchado (o leído en el caso de los faxes) un mensaje de buzón, deberemos conocer el nombre del fichero de ese mensaje. Eso se puede saber mirando el campo <fichero> de cada <entrada> de la respuesta <buzon> que da el listado de mensajes (ver capítulo de Listar mensajes). Además del nombre del fichero y los parámetros obligatorios, hay que pasar el parámetro accion=marcar (o accion=desmarcar), de la siguiente manera:
-  https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_buzon?principal=xxxxxxxxx&pin=1234&origen=902009956&accion=marcar&fichero=2012-04-09_15-45-04_Lunes_987654321_822200956.pdf
+  https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_buzon?principal=xxxxxxxxx&pass=miclavesecreta&origen=902009956&accion=marcar&fichero=2012-04-09_15-45-04_Lunes_987654321_822200956.pdf

@@ Línea 1: / Línea 1: @@
 {{#seo:
-|title= Api Buzón de voz{{PROD_TILDE}}.
+|title= Api Buzón de voz {{PROD_TILDE}}.
 |titlemode=append
-|keywords=APIdesvio, API buzon, API buzones, mensajes de buzon, buzon de voz, escuchar mensaje, borrar mensaje, desarrollo web, servicio web, oficina virtual
+|keywords=API desvio, API buzon, API buzones, mensajes de buzon, buzon de voz, escuchar mensaje, borrar mensaje, desarrollo web, servicio web, oficina virtual
 |description= Acceda a los mensajes de buzón de su Número Virtual o extensiones de su Centralita Virtual: descargue y borre sus mensajes gracias a la API de buzones.
 }}

← Revisión anterior		Revisión del 11:58 3 feb 2016
Línea 16:		Línea 16:
	https://cgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_buzon?principal=xxxxxxxxx&pin=1234&origen=xxxxxxxxx		https://cgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_buzon?principal=xxxxxxxxx&pin=1234&origen=xxxxxxxxx

−	Para acceder a esta API hay que tener dado de alta un número de Oficina Virtual (Número Virtual, Centralita Virtual, Fax Virtual y Botón Web). En la pestaña de "Buzón" de cualquiera de estos números, sección "Opciones Avanzadas" (o en ~~Opciones~~ > Permisos de las APIs ~~y los servicios web~~), se puede activar esta API (por defecto se encuentra desactivada) y restringir su uso según la IP de acceso a la misma (esto es aconsejable para aumentar la seguridad si se tiene una dirección IP fija).	+	Para acceder a esta API hay que tener dado de alta un número de Oficina Virtual (Número Virtual, Centralita Virtual, Fax Virtual y Botón Web). En la pestaña de "Buzón" de cualquiera de estos números, sección "Opciones Avanzadas" (o en Desarrolladores > Permisos de las APIs), se puede activar esta API (por defecto se encuentra desactivada) y restringir su uso según la IP de acceso a la misma (esto es aconsejable para aumentar la seguridad si se tiene una dirección IP fija).

@@ Línea 147: / Línea 147: @@
 '''Indice'''
-[[Portada]]  >>  [[Desarrolladores]]  >>  API de buzones.
+[[Página principal]]  >>  [[Desarrolladores]]  >>  API de buzones.
-[[Portada]]  >>  [[Oficina Virtual]]  >>  [[Fax virtual]]  >>  [[Recepción de faxes]]  >> [[Opciones avanzadas de la recepcion de fax]]  >>  API de buzones.
+[[Página principal]]  >>  [[Oficina Virtual]]  >>  [[Fax virtual]]  >>  [[Recepción de faxes]]  >> [[Opciones avanzadas de la recepcion de fax]]  >>  API de buzones.

@@ Línea 1: / Línea 1: @@
 ===URL===
@@ Línea 9: / Línea 16: @@
   https://cgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_buzon?principal=xxxxxxxxx&pin=1234&origen=xxxxxxxxx
-Para acceder a esta API hay que tener dado de alta un número de Oficina Virtual (número virtual, centralita, fax, botón web). En la pestaña de "Buzón" de cualquiera de estos números, sección "Opciones Avanzadas" (o en Opciones > Permisos de las APIs y los servicios web), se puede activar esta API (por defecto se encuentra desactivada) y restringir su uso según la IP de acceso a la misma (esto es aconsejable para aumentar la seguridad si se tiene una dirección IP fija).
+Para acceder a esta API hay que tener dado de alta un número de Oficina Virtual (Número Virtual, Centralita Virtual, Fax Virtual y Botón Web). En la pestaña de "Buzón" de cualquiera de estos números, sección "Opciones Avanzadas" (o en Opciones > Permisos de las APIs y los servicios web), se puede activar esta API (por defecto se encuentra desactivada) y restringir su uso según la IP de acceso a la misma (esto es aconsejable para aumentar la seguridad si se tiene una dirección IP fija).
@@ Línea 17: / Línea 24: @@
 * 'pin' es el PIN de la cuenta {{PRODUCTO}}.
 * 'origen':
-** Si quiere consultar el buzón de voz de un número virtual, 'origen' es el número virtual.
+** Si quiere consultar el buzón de voz de un Número Virtual, 'origen' es el Número Virtual.
-** Si quiere consultar el buzón de voz de una extensión de centralita, 'origen' es la extensión.
+** Si quiere consultar el buzón de voz de una extensión de Centralita Virtual, 'origen' es la extensión.
-** Si quiere consultar el buzón de faxes de un fax, 'origen' es el número de fax.
+** Si quiere consultar el buzón de faxes de un fax, 'origen' es el número de Fax Virtual.
-** Si quiere consultar el buzón de voz de un botón web, 'origen' es 'bw' seguido del número de botón (por ejemplo, para el botón web 3 ponemos "origen=bw3".
+** Si quiere consultar el buzón de voz de un Botón Web, 'origen' es 'bw' seguido del número de botón (por ejemplo, para el Botón Web 3 ponemos "origen=bw3".
-** Si quiere consultar el buzón de grabaciones, 'origen' debe tener el valor 'grabaciones' (origen=grabaciones).
+** Si quiere consultar el buzón de Grabaciones de conversación, 'origen' debe tener el valor 'Grabaciones' (origen=Grabaciones).
 Adicionalmente, puede consultar los buzones de voz con un usuario y contraseña VoIP. En ese caso, los parámetros obligatorios serían:
-* 'usuario_voip': su número virtual o centralita.ext
+* 'usuario_voip': su Número Virtual o Centralita.ext
 * 'password_voip': la contraseña del VoIP
-En este último caso, obviamente sólo es posible consultar los buzones de voz de números virtuales y extensiones de centralita que tengan activado el servicio VoIP. La URL sería así:
+En este último caso, obviamente sólo es posible consultar los buzones de voz de Números Virtuales y extensiones de Centralita que tengan activado el servicio VoIP. La URL sería así:
   https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_buzon?usuario_voip=xxxxxxxxx&password_voip=XXXXXXXXX