API Interactions
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.
URL base
https://flex-api.twilio.com/v1
Autenticação
A API do Flex usa a mesma autenticação básica HTTP que outras APIs da Twilio. Use o Account SID (SID da conta) da Twilio como o nome de usuário e seu Auth Token (Token de autenticação) como a senha.
Recursos
- Recurso Interactions (Interações)
- Participantes do canal de interação
- Subrecurso de canais
- Subrecurso Invites (Convites)
Atributos da tarefa
A tabela a seguir lista um conjunto de atributos 'bem conhecidos' que são consumidos pelo Flex UI (IU do Flex) e/ou pelo Flex Insights.
Atributo |
Descrição |
Exemplo |
|
Para o Insights, ele é usado para preencher conversations.customers.name. No Flex UI (IU do Flex), ele é renderizado como o nome do cliente principal para uma tarefa de e‐mail. |
Al Fresco |
|
Para o Insights, ele é usado para preencher conversations.customers.email ou conversations.customers.phone. No Flex UI (IU do Flex), ele é renderizado como o endereço de e‐mail do cliente principal para uma tarefa de e‐mail. |
+192522212345 ou alfresco@aol.com |
|
Este é o atributo preferencial do Flex UI (IU do Flex) para identificar o cliente em tarefas que não sejam de e‐mail. Para tarefas de e‐mail, ele usa customerName. |
Al Fresco, +19251235555 |
|
No Flex UI (IU do Flex), ele é renderizado como o assunto inicial de uma tarefa de thread de e‐mail. |
Problemas com sapatos |
|
Usado no Flex UI (IU do Flex) para identificar se uma tarefa é baseada em interação ou não e, portanto, se há necessidade de orquestração do Flex UI (IU do Flex). |
UOXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX |
|
O SID da interação |
KDXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX |
|
O SID do convite |
KGXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX |
|
Usado para transferências assistidas externas |
|
|
Usado para transferências assistidas externas |
|
|
Este objeto é adicionado automaticamente se customerAddress e customerName forem fornecidos. Este objeto contém o nome, telefone e e‐mail de um único cliente. name [obrigatório]: o nome de exibição do cliente. Se o nome não estiver disponível, ele deve ser definido como nulo phone [obrigatório]: o número de telefone ou WhatsApp do cliente. Se o número não estiver disponível, ele deve ser definido como nulo email [obrigatório]: o endereço de e‐mail do cliente. Se nenhum endereço de e‐mail estiver disponível, ele deverá ser definido como nulo |
"customers": { "name": "Al Fresco", "Phone": "+19252148887", "email": nulo } |
Os seguintes atributos são adicionados quando o canal é criado (de forma assíncrona):
Atributo |
Descrição |
Exemplo |
(Este é o Endereço projetado da conversa) |
Para o Insights, este é o endereço de contato usado pelo cliente para falar com você ou o endereço de contato usado por você para contatá‐lo. Pode ser um número de telefone de suporte de entrada, seu e‐mail de suporte ou um número que aparece no telefone do cliente quando você liga para ele. As informações de contato (e‐mail, telefone) que o cliente usa ou vê ao se comunicar com o contact center podem ser usadas para a segmentação de tráfego. |
help@twilio.com |
Atributos da tarefa mapeados a partir de Atributos do canal
Alguns atributos de canal de solicitação de interação também são usados para criar outros atributos de tarefa. A tabela a seguir lista os atributos de tarefa que são criados a partir dos atributos de canal fornecidos:
Atributo do canal de interação |
Atributo(s) da tarefa |
Valores |
|
conversations.media.type (Insights) Para todos os tipos de mídia de conversa |
ChatTranscript |
|
conversations.communication_channel (Insights) |
E‐mail, SMS, WhatsApp, Web, Chat |
|
channelType (Flex UI,IU do Flex) O Flex UI (IU do Flex) usa isso para identificar tarefas que têm o mesmo 'uniqueTaskChannelName' que o chat, mas precisam ser tratadas de forma diferente, por exemplo, WhatsApp e SMS. |
E‐mail, SMS, WhatsApp, Web, Chat |
|
direction (Flex UI, IU do Flex) Quando initiated_by estiver definido como 'agent' (agente), esse valor será de saída; caso contrário, será de entrada. |
cliente | api | agente |
|
conversations.conversation_id (Insights) |
KDXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX |
|
conversations.media.sid (Insights) |
|
conversationSid (Flex UI,IU do Flex) |
A tabela a seguir exibe o motivo para precisar desses atributos:
Atributos do Flex Insights |
Como/por que ele é usado |
|
Um exemplo do objeto de mídia inteiro com transcrição de chat anexada |
|
Flex Insights: usado para identificar como a conversa foi iniciada. Isso ajuda a identificar funis que levam a uma conversa. |
|
Flex Insights: o endereço de contato usado pelo cliente para falar com você ou o endereço de contato usado por você para contatá‐lo. Pode ser um número de telefone de suporte de entrada, seu e‐mail de suporte ou um número que aparece no telefone do cliente quando você liga para ele. Útil para segmentar o tráfego por informações de contato (e‐mail, telefone) |
|
O ID da conversa usado para insights históricos. O SID de mídia é usado para obter acesso às transcrições. |
Erros
Alguns erros comuns que você pode encontrar incluem o Erro 20003 e o Erro 11200. Consulte o Dicionário de erros e avisos da Twilio para obter uma lista de possíveis erros.
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.