Diferencia entre revisiones de «API de mensajes de voz»

Revisión del 13:44 23 dic 2014

ATENCIÓN: En desarrollo.

Sumario

1 Descripción
2 URL
3 Parámetros obligatorios
4 Parámetros opcionales
5 Resultado
6 Notas

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.

@@ Línea 9: / Línea 9: @@
 La API de mensajes de voz '''se ofrece como un servicio web''', accesible mediante la URL:
-   https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/api_subir_voz?principal=xxxxxxxxx&pin=1234
+   https://scgi.duocom.es/cgi-bin/{{DIR_CGI}}/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/{{DIR_CGI}}/api_subir_voz?principal=xxxxxxxxx&pin=1234
+   https://cgi.duocom.es/cgi-bin/{{DIR_CGI}}/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===
@@ Línea 19: / Línea 19: @@
 * '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}}.
+* '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===