Subrecurso de canais
Este produto Twilio está atualmente disponível como uma versão Beta Pública. Alguns recursos ainda não foram implementados e outros podem ser alterados antes que o produto seja declarado como disponível para o público em geral. O uso desta versão Beta Pública está sujeito aos termos relevantes do contrato de licença vigente. Os produtos Beta não são abrangidos por um SLA da Twilio. Saiba mais sobre o suporte a produtos Beta.
Flex Conversations requer Flex UI (IU do Flex) 2.0. Se você estiver no Flex UI (IU do Flex) 1.x, consulte as páginas Mensagens no Flex.
O subrecurso de Canais de interação representa o canal de comunicação associado à interação. Um canal de interação pode ter várias tarefas associadas a ele, mas só pode ter um Twilio Conversation associado.
Este subrecurso permite atualizar o status de um canal, mas não suporta a criação de um canal diretamente. Use o recurso Interações para criar um canal.
Quando um canal é criado através do recurso Interações, uma tarefa é criada e imediatamente encaminhada para o Flex usando a área de trabalho do TaskRouter fornecida.
Propriedades InteractionChannel
Resource Properties in REST API format | |
---|---|
sid
|
A string exclusiva criada pela Twilio para identificar um recurso Interaction Channel (Canal de interação), prefixado com UO. |
interaction_sid
|
A string exclusiva criada pela Twilio para identificar um recurso de interação, prefixado com KD. |
type
|
The Interaction Channel's type. Can be: |
status
|
O status deste canal. |
error_code
|
O código de erro da Twilio para um canal com falha. |
error_message
|
A mensagem de erro de um canal com falha. |
url
|
|
links
|
|
Parâmetro | Subcampos | Descrição |
Status [obrigatório] |
Indica o status do canal de interação. Quando um canal é definido como fechado, todas as tarefas são colocadas no estado "finalizando" por padrão, a menos que o status de Roteamento seja definido como "encerrado", caso em que as tarefas serão do tipo "concluída". Valor: encerrado |
|
Roteamento [opcional] | O estado das tarefas associadas. Se não for especificado, todas as tarefas serão definidas como "finalizando". | |
status |
Valor: encerrado Se encerrado for especificado, todas as tarefas associadas serão definidas como "concluída". |
Buscar um canal
https://flex-api.twilio.com/v1/Interactions/{InteractionSid}/Channels/{Sid}
Isso permite que você recupere uma única instância de Canal.
Parameters
Parameters in REST API format | |
---|---|
interaction_sid
Path
|
A string exclusiva criada pela Twilio para identificar um recurso de interação, prefixado com KD. |
sid
Path
|
A string exclusiva criada pela Twilio para identificar um recurso Interaction Channel (Canal de interação), prefixado com UO. |
Example 1
Listar Canais
OBTER /Interações/<interaction_sid>/Canais
Como apenas um Canal é suportado na versão beta privada, somente um Canal será exibido.
Objeto de resposta
Parâmetro | Descrição |
sid |
Identificador exclusivo para o canal de interação |
interaction_sid |
Identificador exclusivo para a interação |
O tipo de canal especificado quando a interação foi criada. Consulte a tabela Propriedades de interações para obter os valores possíveis. | |
links | Um objeto JSON vinculado aos participantes e convites associados do canal de interação |
Example 2
Um canal é excluído após 180 dias de inatividade, independentemente do estado. Recuperar o canal após 180 dias da exclusão retorna um 404 Not Found
. Observe que o período inicial de vida útil (TTL) é redefinido sempre que há uma atualização no canal (por exemplo, adicionar e remover um participante ou atualizar o status do canal).
Fechar um canal de interação
https://flex-api.twilio.com/v1/Interactions/{InteractionSid}/Channels/{Sid}
Esse subrecurso permite que um desenvolvedor feche um canal em uma interação. Ao fechar um canal, todas as tarefas e reservas de todos os agentes no canal serão definidas para o estado de finalização. Se desejar concluir as tarefas, você poderá fornecer o parâmetro de status de roteamento opcional com o valor fechado.
Além disso, quando você definir o status do canal como fechado, o canal de mídia subjacente também será fechado. Isso altera o canal para "somente leitura", independentemente do status do roteamento.
A tabela a seguir ilustra o canal de mídia e os estados de tarefa para um determinado status de Canal e Roteamento.
Status do canal | Status do roteamento | Estado da tarefa resultante | Estado de conversa resultante |
encerrado | Não especificado | finalização | encerrado |
encerrado | encerrado | concluída | encerrado |
Em alguns casos, é desejável manter o canal aberto, mas fazer com que os agentes concluam as próprias tarefas. Para isso, use o subrecurso Participante do canal para modificar o status dos participantes em vez do canal. Observe, no entanto, que você precisará adicionar mais lógica para garantir que você convide o mesmo agente ou um novo agente na próxima mensagem recebida.
Parameters
Parameters in REST API format | |
---|---|
interaction_sid
Path
|
A string exclusiva criada pela Twilio para identificar um recurso de interação, prefixado com KD. |
sid
Path
|
A string exclusiva criada pela Twilio para identificar um recurso Interaction Channel (Canal de interação), prefixado com UO. |
status
Required
|
Required. Indicates the Interaction channel's status. When a channel is set to |
routing
Optional
|
It changes the state of associated tasks. Routing status is required, When the channel status is set to |
Example 1
Example 2
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.