API de envío de mensajes hablados
Sumario
Descripción API de envío de mensajes hablados
Con esta API usted podrá enviar un texto que será sintetizado en un mensaje de voz que se enviará mediante una llamada telefónica al número de teléfono que usted indique.
Tenga en cuenta que el número de síntesis de texto a voz está limitada por día.
Si no sabe lo que es una API lea ¿Qué son las APIs de Mi Oficina Web?
Activación API de mensajes de voz
Este servicio debe activarse explícitamente dentro de la web, en Desarrolladores > Permisos de las APIs. En esa sección también se pueden restringir (opcionalmente) las direcciones IP desde las que se puede llamar a través de esta aplicación web. Si usted tiene una dirección IP fija por favor introdúzcala aquí, aumenta la seguridad.
URL
La API de mensajes de voz se ofrece como un servicio web, accesible mediante la URL:
https://scgi.duocom.es/cgi-bin/oficinaweb/apimensajevoz?principal=xxxxxxxxx&pass=xxxxxxxx&llamante=xxxxxxxxx&destino1=xxxxxxxxxx&mensaje=Hola+que+tal
Para los clientes de Canarias, la URL es:
https://cgi.duocom.es/cgi-bin/oficinaweb/apimensajevoz?principal=xxxxxxxxx&pass=xxxxxxxx&llamante=xxxxxxxxx&destino1=xxxxxxxxxx&mensaje=Hola+que+tal
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 Mi Oficina Web".
- 'pass' es la contraseña de la cuenta Mi Oficina Web.
- 'llamante' es el número de Oficina Virtual que desea que haga la llamada.
- 'destino1' es el número de teléfono que recibirá el mensaje.
- 'mensaje' es el texto que será sintetizado a voz y que se le reproducirá al receptor de la llamada.
Parámetros opcionales
- 'vw_voz'. Contiene un número que representa la voz que se va a usar para sintetizar el texto enviado. Por ejemplo, si queremos usar a Jorge (la voz por defecto si no se pasa ningún valor de vw_voz), haríamos vw_voz=2. Las voces son:
- Español: 1 - Carmen, 2 - Jorge, 3 - Juan, 4 - Leonor, 5 - Francisca (Chile), 6 - Diego (Argentina), 7 - Esperanza (México), 8 - Carlos (América Latina), 9 - Soledad (América Latina), 10 - Ximena (América Latina)
- Catalán: 11 - Jordi, 12 - Montserrat, 13 - Empar (Valencia)
- Gallego: 14 - Carmela
- Vasco: 15 - Arantxa
- Inglés: 16 - Allison (USA), 17 - Dave (USA), 18 - Steven (USA), 19 - Susan (USA), 20 - Catherine (UK), 21 - Elizabeth (UK), 22 - Simon (UK), 23 - Alan (Australia), 24 - Grace (Australia), 25 - Veena (India)
- Alemán: 26 - Katrin, 27 - Stefan
- Francés: 28 - Bernard, 29 - Florence, 30 - Jolie, 31 - Charlotte (Canadá), 32 - Olivier (Canadá)
- Portugués: 33 - Amalia, 34 - Eusebio, 35 - Fernanda (Brasil), 36 - Gabriela (Brasil), 37 - Felipe (Brasil)
- Italiano: 38 - Federica, 39 - Giulia, 40 - Luca, 41 - Marcello, 42 - Matteo, 43 - Paola, 44 - Roberto, 45 - Silvana, 46 - Valentina
- Griego: 47 - Afroditi, 48 - Nikos
- Sueco: 49 - Annika, 50 - Sven
- Chino: 51 - Linlin, 52 - Lisheng
- Holandés: 53 - Saskia, 54 - Willem
- Polaco: 55 - Krzysztof, 56 - Zosia
- Turco: 57 - Kerem, 58 - Selin, 59 - Zeynep
- Danés: 60 - Frida, 61 - Magnus
- Noruego: 62 - Henrik, 63 - Vilde
- Ruso: 64 - Dmitri, 65 - Olga
- Finlandés: 66 - Marko, 67 - Milla
- Árabe: 68 - Laila, 69 - Tarik
- Rumano: 69 - Ioana
- Esperanto: 70 - Ludoviko
- Japonés: 71 - Misaki, 72 - Show
- Koreano: 73 - Junwoo, 74 - Yumi
- 'vw_velocidad', que puede ser un número entre -3 (muy lento) y 3 (muy rápido). Por defecto es 0 (normal).
Notas API de envío de mensajes hablados
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.
Indice
Página principal >> Desarrolladores >> API de envíos de mensajes hablados.