TwiML™ Voice: <Play>

El verbo <Play> reproduce un archivo de audio para el agente de llamada. Twilio recupera el archivo de una URL que proporciones.

Atributos del verbo

El verbo <Play> admite los siguientes atributos que modifican su comportamiento:

loop

El atributo 'loop' especifica cuántas veces se reproduce el archivo de audio. El comportamiento predeterminado es reproducir el audio una vez. Especificar '0' hará que el verbo<Play> se detenga hasta que la llamada se cuelgue o se realicen 1000 iteraciones.

Utilízalo así:

digits

El atributo ‘digits’ te permite reproducir tonos DTMF durante una llamada.

Por ejemplo, si necesitas probar un sistema IVR, puedes utilizar esta función para simular que se pulsan los dígitos a fin de desplazarte por las opciones del menú.

Incluye w para introducir una pausa 0,5 s entre tonos DTMF. Por ejemplo, 1w2 te dirá a Twilio que haga una pausa de 0,5 s antes de reproducir el tono DTMF 2. Para incluir 1 s de pausa, solo agrega ww.

Si estás marcando un número de teléfono y necesitas reproducir tonos DTMF para introducir la extensión, debes utilizar el atributo [sendDigits][senddigits] en el [número][<number>].

Sustantivos

El "sustantivo" de un verbo TwiML es cualquier texto adicional o atributo anidado dentro del verbo que no es un verbo en sí; es aquello sobre lo que actúa el verbo. Estos son los sustantivos disponibles para <Play>:

Tipos de archivos de audio compatibles

Twilio admite los siguientes tipos de MIME de audio para archivos de audio que el verbo <Play> recupera:

Reglas de anidamiento

No puedes anidar ningún verbo dentro de <Play>. Puedes anidar <Play> dentro de un verbo <Gather>, con una excepción importante: no puedes reproducir "dígitos" dentro de <Gather>.

Ejemplos

Ejemplo 1: reproducción simple

Este documento TwiML le dice a Twilio que descargue el archivo cowbell.mp3 y reproduzca el audio al agente de llamada.

Ejemplo 2: usar dígitos

Vamos a probar nuestro menú IVR para asegurarnos de que los usuarios pueden navegar de forma correcta. Conocemos la longitud del saludo inicial y el número de menú que necesitamos introducir. Podemos añadir algunos caracteres 'w' iniciales para añadir una pausa. Cada carácter 'w' le dice a Twilio que espere 0,5 segundos en lugar de reproducir un dígito. Esto te permite ajustar la sincronización de cuando los dígitos comienzan a reproducirse para adaptarse al sistema telefónico que estás marcando.

Consejos y usos avanzados

• Twilio intentará almacenar en caché el archivo de audio la primera vez que se reproduzca. Esto significa que la reproducción del primer intento puede ser lenta debido al tiempo empleado en descargar el archivo desde el servidor remoto. Twilio puede reproducir un sonido de procesamiento mientras se descarga el archivo.
• Twilio almacenará en caché los archivos cuando los encabezados HTTP lo permitan (mediante ETag y los encabezados modificados por última vez). Responder con Cache-Control: no-cache, garantizará que Twilio siempre compruebe si el archivo ha cambiado, lo que permite que tu servidor web responda con una nueva versión o con un error 304 No modificado para indicar a Twilio que utilice su versión en caché.
• El audio reproducido mediante la red telefónica se transcodifica a un formato que la red telefónica entiende. Independiente de la calidad del archivo que nos proporciones, lo transcodificaremos para que se reproduzca de forma correcta. Esto puede dar como resultado una calidad inferior porque el número de teléfono no admite audio de alta velocidad de bits.
• Los archivos codificados con pérdidas a alta velocidad de bits, como los archivos mp3 de 128 kbps, tardarán más en transcodificarse y es posible que suenen peor que los archivos que están en formatos 8 kbps sin pérdidas. Esto se debe a la inevitable degradación que se produce cuando se convierten los formatos comprimidos con pérdida y al procesamiento que implica convertir de velocidades de bits más altas en velocidades de bits bajas.
• Reproducir con <Play> un archivo que dura más de 40 minutos puede dar como resulto una llamada perdida. Si necesitas usar <Play> en un archivo de más de 40 minutos, considera dividirlo en fragmentos más pequeños.