TwiML™ Voice: <Queue>
O substantivo <Queue> do verbo <Dial> especifica uma fila para discar. Ao discar uma fila, o autor da chamada será conectado à primeira chamada enfileirada na fila especificada. Se a fila estiver vazia, Dial aguardará até que a próxima pessoa entre na fila ou até que a duração de <Dial> timeout seja atingida. Se a fila não existir, o Dial publicará um status de erro em seu URL de ação.
Atributos do substantivo
O substantivo <Queue> dá suporte aos seguintes atributos que modificam seu comportamento:
| Nome do atributo | Valores permitidos | Valor padrão |
|---|---|---|
| url | URL relativo ou absoluto | nenhum |
| método | GET, POST | POST |
| reservationSid | Sid de reserva | nenhum |
| postWorkActivitySid | Sid da atividade | nenhum |
url
O atributo url pega um URL relativo ou absoluto como um valor. O url aponta para um documento de Twiml que
será executado no final do autor da chamada na fila antes que as duas partes estejam conectadas. Geralmente, isso é usado
para notificar o autor da chamada na fila de espera que ele ou ela está prestes a ser conectado(a) a um agente ou que a chamada pode ser gravada.
Os verbos permitidos neste documento TwiML são Reproduzir, Dizer, Pausar e Redirecionar.
Parâmetros da solicitação
A Twilio passará os seguintes parâmetros além dos parâmetros da solicitação do TwiML padrão com sua solicitação para o valor do atributo 'url':
| Parâmetro | Descrição |
|---|---|
| QueueSid | O SID da fila. |
| CallSid | O CallSid da chamada desenfileirada. |
| QueueTime | O tempo que a chamada gastou na fila em segundos. |
| DequeingCallSid | O CallSid da chamada desenfileirando o autor da chamada. |
method
O atributo method usa o valor 'GET' ou 'POST'. Isso informa à Twilio
se deve solicitar o url acima via HTTP GET ou POST. Esse atributo
é modelado depois do atributo method do formulário HTML. “POST” é o valor padrão.
reservationSid
Se uma chamada foi colocada em fila com um SID do fluxo de trabalho do TaskRouter, você poderá especificar um SID de reserva para vincular essa chamada ao autor da chamada em fila. Depois que a chamada for encaminhada com sucesso, a Reserva pendente será marcada como 'accepted'.
postWorkActivitySid
Se uma chamada for encaminhada usando o atributo 'reservationSid', você poderá especificar um valor opcional de postWorkActivitySid para indicar para qual estado de atividade o funcionário deve ser movido após a conclusão da chamada.
Exemplos
Exemplo 1: Discando uma fila
Neste exemplo, o autor da chamada deseja desenfileirar uma chamada da fila de 'support'. Antes de conectar, o seguinte TwiML pode ser executado:
E o documento 'about_to_connect.xml" do TwiML que será reproduzido para o autor da chamada aguardando na fila antes da conexão pode ser semelhante a:
Precisa de ajuda?
Às vezes, todos nós precisamos; a programação é difícil. Receba ajuda agora da nossa equipe de suporte, ou confie na sabedoria da multidão navegando pelo Stack Overflow Collective da Twilio ou buscando a tag Twilio no Stack Overflow.
