API de mensajes de voz

ATENCIÓN: En desarrollo.

Descripción

En desarrollo...

URL

La API de mensajes de voz se ofrece como un servicio web, accesible mediante la URL:

 https://scgi.duocom.es/cgi-bin/telefacil2/api_subir_voz?principal=xxxxxxxxx&pin=1234&tipo_ov=numero_virtual&tipo_mensaje=buzon&destino_mensaje=902009955&tipo_entrada=fichero&fichero=C:\mensaje.mp3&tipo_fichero=mp3

Para los clientes de Canarias, la URL es:

 https://cgi.duocom.es/cgi-bin/telefacil2/api_subir_voz?principal=xxxxxxxxx&pin=1234&tipo_ov=numero_virtual&tipo_mensaje=buzon&destino_mensaje=902009955&tipo_entrada=fichero&fichero=C:\mensaje.mp3&tipo_fichero=mp3

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.
• 'tipo_ov': debe ser uno de los valores 'numero_virtual', 'centralita' o 'boton_web'.
• 'tipo_mensaje': debe ser alguno los siguientes valores.
  • 'centralita'
  • 'buzon'
  • 'aviso'
  • 'predesvio'
  • 'durante'
  • 'secr_nombre'
  • 'secr_transf'
  • 'secr_op5'
  • 'filtro_normal'
  • 'filtro_privado'
  • 'pecera'
  • 'pecera_2'
  • 'cp_marque'
  • 'cp_mal'
  • 'cp_nohay'
  • 'botonweb'
• 'destino_mensaje': debe ser el número virtual o la extensión a la que se le sube el mensaje. Puede especificarse "todos" para que se suba a todos los números virtuales o extensiones.
• 'tipo_entrada': puede ser 'texto' si se manda un mensaje escrito para su posterior síntesis de voz; o 'fichero' si se manda un fichero (se admiten MP3 o WAV).
  • si tipo_entrada=fichero, deben enviarse además los campos:
    • 'fichero', con el fichero correspondiente (el envío debe ser POST+multipart)
    • 'tipo_fichero', con el tipo de fichero enviado ('mp3' o 'wav')
  • si tipo_entrada=texto, se pueden enviar 1 o varios textos numerados desde el 0 (vw_texto0, vw_texto1...), con los siguientes parámetros
    • 'vw_elementos=N', donde N es un número mayor o igual a 1. Indica el número de textos que se envían.
    • 'vw_textoX=hola+que+tal', donde X es un número entre 0 y N-1. Contiene el texto que deseamos sintetizar.
    • 'vw_vozX', donde X es un número entre 0 y N-1.
    • 'vw_velocidadX', donde X es un número entre 0 y N-1.

Parámetros opcionales

En desarrollo...

Resultado

En desarrollo...

Notas

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 mensajes de voz.