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

Menu

Expand
Classifique esta página:

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:

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.


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.



Resource Properties in REST API format
sid
sid<KG> Not PII

A string exclusiva criada pela Twilio para identificar um recurso Invite (Convie) do Interaction Channel (Canal de interação).

interaction_sid
sid<KD> Not PII

O SID de interação para este canal.

channel_sid
sid<UO> Not PII

O SID do canal para este convite.

routing
object Not PII

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
url Not PII

Criar um Convite do canal de interação

post
https://flex-api.twilio.com/v1/Interactions/{InteractionSid}/Channels/{ChannelSid}/Invites
Parameters
Parameters in REST API format
interaction_sid
Path
post sid<KD> Not PII

O SID de interação para este canal.

channel_sid
Path
post sid<UO> Not PII

O SID do canal para este convite.

routing
Required
post object Not PII

A lógica de roteamento da interação.

Example 1
        
        
        
        Este exemplo de solicitação convida um agente para um canal em uma interação.

        Convidar um agente

        Este exemplo de solicitação convida um agente para um canal em uma interação.
        {
           "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"
        }
        Classifique esta página:

        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.

              
              
              

              Obrigado pelo seu feedback!

              Selecione o(s) motivo(s) para seu feedback. As informações adicionais que você fornece nos ajudam a melhorar nossa documentação:

              Enviando seu feedback...
              🎉 Obrigado pelo seu feedback!
              Algo deu errado. Tente novamente.

              Obrigado pelo seu feedback!

              Indique‑nos e obtenha USD10 em 3 etapas simples!

              Etapa 1

              Obtenha o link

              Obtenha um link de indicação pessoal gratuito aqui

              Etapa 2

              Dê USD10

              Seu usuário se inscreve e faz a atualização usando o link

              Etapa 3

              Obtenha USD10

              1.250 mensagens SMS grátis
              OU 1.000 min de voz grátis
              OU 12.000 chats
              OU mais