API de desvíos - Historial de revisiones

Dbautista en 12:10 2 jul 2021

2021-07-02T12:10:31Z

Mostrar los cambios

Lmoreno: /* Configuración de la URL de aviso de llamadas */

2020-05-28T09:32:29Z

‎Configuración de la URL de aviso de llamadas

Lmoreno: /* Configuración del email del buzón */

2020-05-28T09:32:06Z

‎Configuración del email del buzón

Lmoreno: /* Configuración del post-desvío (buzón de voz, salto a extensión) */

2020-05-28T09:31:44Z

‎Configuración del post-desvío (buzón de voz, salto a extensión)

Lmoreno: /* Creación y borrado de alias de extensiones */

2020-05-28T09:31:18Z

‎Creación y borrado de alias de extensiones

Lmoreno: /* Creación y borrado de extensiones */

2020-05-28T09:30:24Z

‎Creación y borrado de extensiones

Lmoreno: /* Cambiar el desvío especial (solo extensiones telefónicas) */

2020-05-28T09:26:57Z

‎Cambiar el desvío especial (solo extensiones telefónicas)

Lmoreno en 09:25 28 may 2020

2020-05-28T09:25:31Z

Dbautista: /* Añadir o quitar teléfonos de los desvíos fácilmente */

2020-03-13T09:11:25Z

‎Añadir o quitar teléfonos de los desvíos fácilmente

Dbautista: /* Añadir o quitar teléfonos de los desvíos fácilmente */

2020-03-13T09:10:54Z

‎Añadir o quitar teléfonos de los desvíos fácilmente

@@ Línea 264: / Línea 264: @@
 Se puede configurar también la URL que se invocará cuando una llamada llegue, se realice un desvío o se cuelgue. Para más información acerca de esta opción ver: [[Opciones avanzadas de aviso de llamada]].
- https://scgi.duocom.es/cgi-bin/telefacil2/api_desvios?principal=911922933&pass=XXXXXXXX&nv={{TFNO_CONTACTO_MINI}}&accion=url_avisos&url=http%3A%2F%2Fdominio.com%2Fa.php%3Fllamante%3D%24llamante%26receptor%3D%24llamado%26extension%3D%24extension&desvio_comienza=1&desvio_descuelga=1&desvio_cuelga=1
+<pre>https://scgi.duocom.es/cgi-bin/telefacil2/api_desvios?principal=911922933&pass=XXXXXXXX&nv={{TFNO_CONTACTO_MINI}}&accion=url_avisos&url=http%3A%2F%2Fdominio.com%2Fa.php%3Fllamante%3D%24llamante%26receptor%3D%24llamado%26extension%3D%24extension&desvio_comienza=1&desvio_descuelga=1&desvio_cuelga=1</pre>
 * 'nv' o 'ext': Número virtual o de extensión cuya URL de avisos se va a configurar.

@@ Línea 254: / Línea 254: @@
 Se puede configurar el e-mail asociado al buzón de voz:
- https://scgi.duocom.es/cgi-bin/telefacil2/api_desvios?principal=911922933&pass=XXXXXXXX&nv={{TFNO_CONTACTO_MINI}}&accion=email_avisos&email=mi.email@midominio.com
+<pre>https://scgi.duocom.es/cgi-bin/telefacil2/api_desvios?principal=911922933&pass=XXXXXXXX&nv={{TFNO_CONTACTO_MINI}}&accion=email_avisos&email=mi.email@midominio.com</pre>
 * 'nv' o 'ext': Número virtual o de extensión cuya URL de avisos se va a configurar.

@@ Línea 237: / Línea 237: @@
 También se puede configurar el comportamiento de lo que viene después del desvío (buzón de voz normalmente) mediante la URL:
- https://scgi.duocom.es/cgi-bin/telefacil2/api_desvios?principal=911922933&pass=miclavesecreta&nv={{TFNO_CONTACTO_MINI}}&accion=post&valor=26
+<pre>https://scgi.duocom.es/cgi-bin/telefacil2/api_desvios?principal=911922933&pass=miclavesecreta&nv={{TFNO_CONTACTO_MINI}}&accion=post&valor=26</pre>
 donde:

@@ Línea 223: / Línea 223: @@
 Para hacer una extensión 'ext_dest' que sea igual (o que apunte) a una extensión ya existente 'ext_ori', se llama a la URL:
- https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_desvios?principal=911922933&pass=miclavesecreta&accion=crear_alias_ext&ext_ori=1&ext_dest=2221
+<pre>https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_desvios?principal=911922933&pass=miclavesecreta&accion=crear_alias_ext&ext_ori=1&ext_dest=2221</pre>
 donde:
@@ Línea 232: / Línea 231: @@
 Para borrar una extensión alias, se llama a la URL:
- https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_desvios?principal=911922933&pass=miclavesecreta&accion=borrar_alias&ext=2221
+<pre>https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_desvios?principal=911922933&pass=miclavesecreta&accion=borrar_alias&ext=2221</pre>
 ===Configuración del post-desvío (buzón de voz, salto a extensión)===

@@ Línea 199: / Línea 199: @@
 NOTA: puede listar las extensiones existentes haciendo uso de apiextensiones:
- https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/apiextensiones?principal=911922933&pass=miclavesecreta
+<pre>https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/apiextensiones?principal=911922933&pass=miclavesecreta</pre>
 Para crear una extensión (que no existe previamente y que no solape con alguna ya creada), se llama a la URL:
- https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_desvios?principal=911922933&pass=miclavesecreta&accion=crear_ext&ext=1&pin_ext=1111&nombre=Pepe%20Suarez
+<pre>https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_desvios?principal=911922933&pass=miclavesecreta&accion=crear_ext&ext=1&pin_ext=1111&nombre=Pepe%20Suarez</pre>
 donde:
@@ Línea 217: / Línea 217: @@
 Para borrarla, se llama a la URL:
- https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_desvios?principal=911922933&pass=miclavesecreta&accion=borrar_ext&ext=1
+<pre>https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_desvios?principal=911922933&pass=miclavesecreta&accion=borrar_ext&ext=1</pre>
 ===Creación y borrado de alias de extensiones===

@@ Línea 175: / Línea 175: @@
 Para crear (o cambiar) un desvío especial en una extensión (para llamadas salientes), hay que hacerlo de la siguiente manera:
- https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_desvios?principal=911922933&pass=miclavesecreta&ext=1&accion=cambiar_desvio_especial&desvio=933922911&mascara=902009955
+<pre>https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_desvios?principal=911922933&pass=miclavesecreta&ext=1&accion=cambiar_desvio_especial&desvio=933922911&mascara=902009955</pre>
 donde 'desvio' es el número de teléfono real que va a atender la llamada y 'mascara' debe ser un número virtual o de centralita contratado. Si se quiere borrar este desvío especial, basta con enviar el parámetro 'desvio' vacío:
- https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_desvios?principal=911922933&pass=miclavesecreta&ext=1&accion=cambiar_desvio_especial&desvio=
+<pre>https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_desvios?principal=911922933&pass=miclavesecreta&ext=1&accion=cambiar_desvio_especial&desvio=</pre>
 Los desvíos especiales se listan junto a los demás desvíos de la forma:

@@ Línea 13: / Línea 13: @@
 La API de desvíos se ofrece como un servicio web, accesible mediante la URL:
- https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_desvios?principal=xxxxxxxxx&pass=xxxxxxxx&nv=xxxxxxxxx
+<pre>https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_desvios?principal=xxxxxxxxx&pass=xxxxxxxx&nv=xxxxxxxxx</pre>
 Para los clientes de Canarias, la URL es:
-  https://cgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_desvios?principal=xxxxxxxxx&pass=xxxxxxxx&nv=xxxxxxxxx
+  <pre>https://cgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_desvios?principal=xxxxxxxxx&pass=xxxxxxxx&nv=xxxxxxxxx</pre>
 Para acceder a esta API hay que tener dado de alta un número virtual o un número de centralita virtual. En la pestaña de "Desvíos", 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 41: / Línea 41: @@
 Ante cualquier petición, ya sea de lectura o de modificación de desvíos, el sistema ofrecerá los desvíos actuales del número virtual o extensión telefónica especificada. Por ejemplo, si queremos leer los desvíos del número virtual {{TFNO_CONTACTO_MINI}} de la cuenta 911922933, la petición sería:
-  https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_desvios?principal=911922933&pass=miclavesecreta&nv={{TFNO_CONTACTO_MINI}}
+  <pre>https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_desvios?principal=911922933&pass=miclavesecreta&nv={{TFNO_CONTACTO_MINI}}</pre>
 En el caso de querer los desvíos de la extensión 2345, tendríamos que crear la siguiente petición:
-  https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_desvios?principal=911922933&pass=miclavesecreta&ext=2345
+  <pre>https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_desvios?principal=911922933&pass=miclavesecreta&ext=2345</pre>
 El sistema ofrecerá una respuesta en texto plano de la siguiente forma:
@@ Línea 137: / Línea 137: @@
 Por ejemplo, si queremos modificar los desvíos del desvío por defecto del número virtual {{TFNO_CONTACTO_MINI}}, haríamos:
-  https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_desvios?principal=911922933&pass=miclavesecreta&nv={{TFNO_CONTACTO_MINI}}&accion=cambiar&desvio1=911922933@{{DOMINIO}}&espera1=0&desvio2=612345678&espera2=10
+  <pre>https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_desvios?principal=911922933&pass=miclavesecreta&nv={{TFNO_CONTACTO_MINI}}&accion=cambiar&desvio1=911922933@{{DOMINIO}}&espera1=0&desvio2=612345678&espera2=10</pre>
 Otro ejemplo: modificamos un desvío por horario (días laborables de 12:00 a 13:00) de la extensión 1:
-  https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_desvios?principal=911922933&pass=miclavesecreta&ext=1&accion=cambiar&horario=12001300&dias=lmxjv&desvio1=911922933@{{DOMINIO}}&espera1=0&desvio2=612345678&espera2=10&desvio3=911922933&espera3=15
+  <pre>https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_desvios?principal=911922933&pass=miclavesecreta&ext=1&accion=cambiar&horario=12001300&dias=lmxjv&desvio1=911922933@{{DOMINIO}}&espera1=0&desvio2=612345678&espera2=10&desvio3=911922933&espera3=15
+</pre>
 NOTA: para modificar los días o el horario de un desvío por horario tiene que primero borrar el horario anterior (ver siguiente sección) y después crear el horario nuevo (con los mismos desvíos que tenía el anterior).
@@ Línea 153: / Línea 153: @@
 La acción "poner" añade uno o varios números de teléfono al desvío especificado si estos números no estaban ya previamente (y no se han usado ya los 5 desvíos):
-  https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_desvios?principal=911922933&pass=miclavesecreta&nv={{TFNO_CONTACTO_MINI}}&accion=poner&desvio1=911922933@{{DOMINIO}}&espera1=0&desvio2=612345678&espera2=10
+  <pre>https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_desvios?principal=911922933&pass=miclavesecreta&nv={{TFNO_CONTACTO_MINI}}&accion=poner&desvio1=911922933@{{DOMINIO}}&espera1=0&desvio2=612345678&espera2=10</pre>
 Tras esta llamada, el número virtual {{TFNO_CONTACTO}} tendrá como desvíos: 911922933@{{DOMINIO}}, 987654321 y 612345678.
@@ Línea 159: / Línea 159: @@
 La acción "quitar" elimina uno o varios números de teléfono del desvío especificado si estos números estaban en el desvío:
-  https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_desvios?principal=911922933&pass=miclavesecreta&nv={{TFNO_CONTACTO_MINI}}&accion=quitar&desvio1=911922933@{{DOMINIO}}&desvio2=999888777
+  <pre>https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_desvios?principal=911922933&pass=miclavesecreta&nv={{TFNO_CONTACTO_MINI}}&accion=quitar&desvio1=911922933@{{DOMINIO}}&desvio2=999888777</pre>
 Tras esta llamada, el número virtual {{TFNO_CONTACTO}} tendrá como desvíos: 987654321 y 612345678.
@@ Línea 167: / Línea 167: @@
 Para borrar un desvío (por horario), debe especificar el campo acción como 'borrar'. Por ejemplo:
- https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_desvios?principal=911922933&pass=miclavesecreta&ext=1&accion=borrar&horario=12001300&dias=lmxjv
+<pre>https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_desvios?principal=911922933&pass=miclavesecreta&ext=1&accion=borrar&horario=12001300&dias=lmxjv</pre>
 ===Cambiar el desvío especial (solo extensiones telefónicas)===

@@ Línea 149: / Línea 149: @@
 Si lo único que desea es añadir o quitar uno o varios números de teléfono sin modificar todo el desvío, puede usar las acciones "poner" y "quitar", en vez de "cambiar".
-Para explicar mejor estas opciones, consideremos el desvío del número virtual {{TFNO_CONTACTO}}. Supongamos que tiene como desvíos el 987654321 y el 612345678.
+Para explicar mejor estas opciones, consideremos el desvío del número virtual {{TFNO_CONTACTO}}. Supongamos que tiene como desvíos los números de teléfono 987654321 y 612345678.
 La acción "poner" añade uno o varios números de teléfono al desvío especificado si estos números no estaban ya previamente (y no se han usado ya los 5 desvíos):

@@ Línea 147: / Línea 147: @@
 ====Añadir o quitar teléfonos de los desvíos fácilmente====
-Si lo único que desea es quitar un número de teléfono sin modificar todo el desvío, puede usar las acciones "poner" y "quitar".
+Si lo único que desea es añadir o quitar uno o varios números de teléfono sin modificar todo el desvío, puede usar las acciones "poner" y "quitar", en vez de "cambiar".
 Para explicar mejor estas opciones, consideremos el desvío del número virtual {{TFNO_CONTACTO}}. Supongamos que tiene como desvíos el 987654321 y el 612345678.