API de buzones

Atención: trabajo en desarrollo.

URL

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

https://scgi.duocom.es/cgi-bin/telefacil2/api_buzon?principal=xxxxxxxxx&pin=1234&origen=xxxxxxxxx

Para los clientes de Canarias, la URL es:

https://cgi.duocom.es/cgi-bin/telefacil2/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). Temporal: En la pestaña de "Desvíos", sección "Opciones Avanzadas", 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

'principal' es el número de teléfono del cliente (con el que se dio de alta), también llamado "usuario de la cuenta Telefácil".
'pin' es el PIN de la cuenta Telefácil.
'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 una extensión de centralita, '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 voz de un botón web, 'origen' es el botón web.
- Si quiere consultar el buzón de grabaciones, 'origen' debe tener el valor 'grabaciones' (origen=grabaciones).

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.

Indice

Portada >> Desarrolladores >> API de buzones.