Subrecurso Invites (Convites)
Este produto Twilio está atualmente disponível como uma versão Beta. 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 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 Interaction Channel Invite (Convite do canal de interação) permite adicionar um agente como um novo participante a um canal de interação existente.
/Interactions/<interaction_sid>/Channels/<channel_sid>/Invites
Use este endpoint para:
- adicionar um agente a uma interação em andamento,
- localizar um agente que deve ser adicionado avaliando um fluxo de trabalho do TaskRouter ou
- enviar uma interação para uma fila.
O convite cria uma nova tarefa para a interação existente, o que resulta em reservas oferecidas ao(s) agente(s).
Remember to handle certain terminal TaskRouter events according to you application's needs, as conversations may stay orphaned with an open
state.
See Conversations Best Practices for details.
Propriedades do Convite do canal de interação
Parâmetro | Subcampo | Descrição | |
Routing [obrigatório] |
Um objeto JSON representando as regras de roteamento para o Interaction Channel (Canal de interação). Consulte o exemplo de SMS de saída para um objeto de Routing (Roteamento) de exemplo. O recurso Interactions (Interações) usa o TaskRouter para todas as funcionalidades de roteamento. |
||
properties [obrigatório] |
Campos necessários para criar uma tarefa: workspace_sid [obrigatório] O SID do fluxo de trabalho do TaskRouter que começa com WS. workflow_sid [opcional] O SID do fluxo de trabalho, iniciado com WW. Opcional se houver apenas um fluxo de trabalho definido; caso contrário, ele será obrigatório queue_sid [obrigatório para iniciado pelo agente], o SID da fila do TaskRouter, iniciado com WQ. worker_sid [obrigatório para iniciado pelo agente] task_channel_sid [opcional] task_channel_unique_name [opcional] attributes [opcional]: os atributos da tarefa. priority [opcional]: a prioridade da tarefa na fila. timeout [opcional]: o intervalo de tempo limite da tarefa/reserva em segundos.
|
Resource Properties in REST API format | |
---|---|
sid
|
A string exclusiva criada pela Twilio para identificar um recurso Invite (Convie) do Interaction Channel (Canal de interação). |
interaction_sid
|
O SID de interação para este canal. |
channel_sid
|
O SID do canal para este convite. |
routing
|
Um objeto JSON representando as regras de roteamento para o Interaction Channel (Canal de interação). Consulte Exemplo de SMS de saída para obter um exemplo de objeto de Routing (Roteamento). O recurso Interactions (Interações) usa o TaskRouter para todas as funcionalidades de roteamento. Todos os atributos no objeto de Routing (Roteamento) no corpo da solicitação de interação são adicionados "como são" à tarefa. Para obter uma lista de atributos conhecidos consumidos pelo Flex UI (IU do Flex) e/ou pelo Flex Insights, consulte Atributos de tarefa conhecidos. |
url
|
|
Criar um Convite do canal de interação
https://flex-api.twilio.com/v1/Interactions/{InteractionSid}/Channels/{ChannelSid}/Invites
Parameters
Parameters in REST API format | |
---|---|
interaction_sid
Path
|
O SID de interação para este canal. |
channel_sid
Path
|
O SID do canal para este convite. |
routing
Required
|
A lógica de roteamento da interação. |
Example 1
{
"url": "https://flex-api.twilio.com/v1/Interactions/KDXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/Channels/UOXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/Invites/KGXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
"interaction_sid": "KDXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
"channel_sid": "UOXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
"routing": {
"reservation": null,
"properties": {
"date_updated": 1636401979,
"age_in_queue": 0,
"task_channel_unique_name": "default",
"assignment_status": "pending",
"queue_name": "Sample Queue",
"assignmentCounter": 0,
"priority": 0,
"sid": "WTXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
"task_queue_entered_date": 1636401979,
"workflow_name": "Default Fifo Workflow",
"workflow_sid": "WWXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
"routing_target": "WKXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
"reason": null,
"attributes": "{\"flexChannelInviteSid\":\"KGXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX\",\"conversationSid\":\"UOXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX\",\"channelType\":\"email\",\"conversations\":{\"communication_channel\":\"Email\",\"conversation_id\":\"KDXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX\",\"media\":[{\"conversation_sid\":\"UOXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX\",\"media\":[{\"type\":\"ChatTranscript\",\"sid\":\"CHXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX\"}],\"customers\":{\"phone\":null,\"name\":null,\"email\":null}},\"flexInteractionChannelSid\":\"UOXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX\",\"flexInteractionSid\":\"KDXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX\"}",
"task_channel_sid": "TCXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
"age": 0,
"workspace_sid": "WSXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
"account_sid": "ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
"timeout": 86400,
"date_created": 1636401979,
"addons": "{}",
"queue_sid": "WQXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
}
},
"sid": "KGXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
}
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.