You are viewing the Spanish (Mexico) site, but your language preference is set to English. Switch to English site →

Menu

Expand
Calificar esta página:

TwiML™ Voice: <Enqueue>

El verbo <Enqueue> pone en cola la llamada actual en una cola de llamadas. Las llamadas en cola esperan con música de fondo hasta que otro agente de llamada las saque de la cola mediante el verbo <Dial> o se haya transferido fuera de la cola mediante la API REST o el verbo <Leave>.

El verbo <Enqueue> creará una cola bajo demanda, si es que la cola no existe. La longitud máxima predeterminada de la cola es de 100. Esto se puede modificar usando la API REST.

Atributos del verbo

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

Nombre de atributo Valores permitidos Valor predeterminado
action URL relativa o absoluta ninguno
method GET, POST POST
waitUrl URL relativa o absoluta default classical playlist
waitUrlMethod GET, POST POST
workflowSid TaskRouter Workflow Sid ninguno

action

El atributo 'action' toma una URL absoluta o relativa como valor. Se realiza una solicitud a esta URL cuando la llamada sale de la cola, describiendo el motivo de la retirada de la cola y los detalles sobre el tiempo pasado en la cola, que se describen a continuación. En el caso de que una llamada se salga de la cola debido a una solicitud de API REST o el verbo <Leave>, la URL de acción se solicita de inmediato. En el caso en que una llamada se saque de la cola mediante el verbo <Dial>, la URL de acción se activa una vez cuando las partes unidas se desconectan. Si no se proporciona una 'action' (acción), Twilio pasará al siguiente verbo en el documento, si lo hay.

Parámetros de solicitud

Twilio transferirá los siguientes parámetros además de los parámetros estándar de solicitud de TwiML Voice con tu solicitud a la URL de 'action':

Parámetro Descripción
QueueResult El resultado final de la llamada en cola. Consulta los valores de resultado de cola a continuación para obtener más información.
QueueSid El SID de la cola. Solo está disponible si de verdad la llamada se ha puesto en cola.
QueueTime El tiempo que la llamada ha permanecido en la cola. Solo está disponible si de verdad la llamada se ha puesto en cola.
Valores de QueueResult

Los siguientes valores representan el resultado de un intento de poner en cola a un agente de llamada.

Valor Descripción
bridged La llamada se ha quitado de la cola y se ha conectado con el agente que la retiró de la cola.
bridging-in-process Twilio ha sido instruido para unir a la parte en cola.
error El TwiML contenía un error, ya sea en el verbo <Enqueue> o en el TwiML recuperado de un waitUrl. Comprueba el monitor de apps.
hangup El agente de llamada en cola colgó antes de conectarse a una llamada que salió de la cola.
leave El agente de llamda en cola salió de la cola mediante el verbo <Leave>.
redirected Mientras estaba en cola, la llamada se redirigió fuera de la cola, por lo usual, por una solicitud API REST.
redirected-from-bridged La sesión que estuvo en cola y, luego, se unió con éxito se ha transferido.
queue-full La cola de destino estaba llena, por lo tanto, se ha rechazado el intento de cola.
system-error El sistema de Twilio no funcionó de forma correcta durante el proceso de colocación en cola. Esto puede suceder si un agente de llamada cuelga antes de ponerse en cola por completo.

method

El atributo 'method' toma el valor 'GET' o 'POST'. Esto le dice a Twilio si debe solicitar la URL de 'action' mediante la HTTP GET o POST. Este atributo se modela a partir del atributo “method” del formulario HTML. “POST” es el valor predeterminado.

waitUrl

El atributo 'waitUrl' especifica una URL que apunta a un documento TwiML que contiene verbos TwiML que se ejecutarán mientras el agente de llamada está esperando en la cola.

Una vez que el flujo de waitUrl de TwiML se quede sin verbos para ejecutar, Twilio volverá a solicitar el waitUrl y comenzará de nuevo, en esencia manteniendo la música de espera de forma indefinida. El verbo <Redirect> puede usarse para múltiples flujos de documentos, pero el flujo siempre regresará a waitUrl una vez que no quede TwiML para ejecutar.

El documento waitUrl de TwiML admite los siguientes verbos:

Verbo Descripción
<Play> Reproduce un archivo para el agente de llamada.
<Say> Dice algo al agente de llamada usando la conversión de texto a voz de Twilio.
<Pause> Pausa durante una duración especificada.
<Hangup> Cuelga la llamada y sale de la cola y finaliza la llamada.
<Redirect> Redirige a otro documento de TwiML.
<Leave> Hace que la llamada actual salga de la cola, pero no cuelga la llamada. La ejecución continúa con el siguiente verbo después del verbo '<Enqueue>'.
<Gather> Recopila los dígitos que el agente de llamada introduce en el teclado del teléfono. NOTA: Solo el tipo de entrada DTMF es compatible con '<Gather>' devuelto en un waitUrl '<Enqueue>'; el tipo de entrada de voz no funcionará.
Parámetros de solicitud

Twilio transferirá los siguientes parámetros además de los parámetros estándar de solicitud de TwiML Voice con su solicitud a la URL de 'waitUrl':

Parámetro Descripción
QueuePosition La posición actual en cola de la llamada en cola.
QueueSid El SID de la cola en la que se encuentra el agente de llamada.
QueueTime Tiempo en segundos que el agente de llamada ha estado en la cola.
AvgQueueTime Promedio de cuánto tiempo han estado en la cola los agentes de llamadas actuales en cola en segundos.
CurrentQueueSize El número actual de llamadas en cola de esta cola.

waitUrlMethod

El atributo 'waitUrlMethod' toma el valor 'GET' o 'POST'. Esto le dice a Twilio si debe solicitar la 'waitUrl' mediante la HTTP GET o POST. Este atributo se modela a partir del atributo 'method' del formulario HTML. “POST” es el valor predeterminado.

workflowSid

El atributo 'workflowSid' indica a Twilio que cree una nueva tarea de TaskRouter para representar esta llamada y especifica el ID del flujo de trabajo deseado a fin de manejarla.

Si se especifica 'workflowSid', no es necesario especificar un nombre para que la cola realice la llamada. Cuando se identifica a un trabajador a fin de manejar la llamada, se puede sacar de la cola y conectarse mediante la instrucción de asignación de salir de cola.

Sustantivos

El "sustantivo" de un verbo TwiML es aquello que está anidado dentro del verbo que no es un verbo en sí; es aquello sobre lo que actúa el verbo. Estos son los sustantivos para <Enqueue>:

Sustantivo Descripción
Texto sin formato El nombre de una cola determinada.
Tarea Los atributos que se van a establecer para la tarea recién creada, con formato JSON

Si la cola con nombre no se ha creado ya, se creará bajo demanda. El nombre de la cola no puede tener más de 64 caracteres.

Puedes encontrar más información y ejemplos sobre cómo utilizar la tarea en la página Integración de TwiML de TaskRouter.

Ejemplos

Ejemplo 1: cola simple

Este documento de TwiML le dice a Twilio que recupere el documento wait-music.xml de TwiML y lo ejecute mientras el agente de llamada está en la cola:

        
        
        

        Simple Enqueue

        El documento wait-music.xml de TwiML reproduce una buena música de espera:

              
              
              

              Wait Music

              Consejos y usos avanzados

              • Puedes utilizar los parámetros de la solicitud "waitUrl" para usar <Say> y volver a decirle al agente de llamada cuál es su posición en la cola y cuánto tiempo puede esperar.
              Calificar esta página:

              ¿Necesitas ayuda?

              Todos la necesitamos a veces; la programación es difícil. Obtén ayuda ahora de nuestro equipo de soporte, o recurre a la sabiduría de la multitud visitando Stack Overflow Collective de Twilio o navegando por la etiqueta de Twilio en Stack Overflow.

                    
                    
                    

                    Gracias por tus comentarios.

                    Selecciona los motivos de tus comentarios. La información adicional que nos brindas nos ayuda a mejorar nuestra documentación:

                    Enviando tus comentarios…
                    🎉 Gracias por tus comentarios.
                    Se produjo un error. Inténtalo de nuevo.

                    Gracias por tus comentarios.

                    thanks-feedback-gif