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

Menu

Personalizar o comportamento de anexo no chat

No momento, você está lendo a documentação do Flex Legacy Messaging. Se você estiver começando com uma nova implementação do Flex, considere usar o Flex Conversations.

Depois que os anexos do WebChat estiverem ativados, você poderá configurar detalhes adicionais para os agentes e clientes que têm permissão para enviar, incluindo:

  • O tamanho máximo permitido do arquivo
  • Restringir anexos a um conjunto limitado de tipos de arquivo.
  • Configurar as restrições do agente e do cliente independentemente.

Configurar o tamanho máximo do arquivo para anexos

Você pode ajustar o tamanho máximo do arquivo que pode ser carregado pelo agente ou pelo cliente. Insira um valor em bytes no valor maxFileSize para definir o tamanho máximo de arquivo permitido. Se nenhum valor for fornecido, será usado o valor padrão de 10.485.760 (10 MB).

// Max file size = 10 mb = 10 x 1024 x 1024 = 10,485,760

interface Config {
  fileAttachment?: {
    enabled?: boolean;
    maxFileSize?: number;
  };
}

Configurar quais tipos de arquivos podem ser anexados

Você também pode especificar um conjunto personalizado de extensões de arquivo que podem ser carregadas. Insira todas as extensões de arquivo aceitas como uma matriz no valor acceptedExtensions.

A validação do lado do cliente verifica apenas o tamanho e o tipo mime do arquivo anexado. Você pode inserir uma lógica de negócios para fazer validação adicional das mensagens de mídia enviadas por meio de Webhooks do Programmable Chat.

Todas as extensões são compatíveis com o Programmable Chat, portanto, você deve incluir todos os tipos de arquivo que deseja usar em sua matriz personalizada. Um valor personalizado inserido na matriz acceptedExtensions substituirá o conjunto de extensões padrão.

// Accepted extensions = .png, .txt, .pdf = ["png", "txt", "pdf"]

interface Config {
  fileAttachment?: {
    enabled?: boolean;
    acceptedExtensions?: Array<string>;
  };
}

Exemplo de configuração de anexos no WebChat

Um exemplo dessas configurações é mostrado abaixo.

fileAttachment: {
  enabled: true,
  maxFileSize: 26214400,
  acceptedExtensions: ["png", "txt", "pdf"]
}

Ações

Há quatro ações que podem ser chamadas de forma programática. Você pode usá‐las para ajudar os agentes com ações rápidas ou automatizar partes de uma interação no WebChat.

Enviar mensagem de mídia

Selecione e envie um arquivo como anexo em uma única ação.

Actions.invokeAction("SendMediaMessage", { file: file, channelSid: "unique_channel_identifier" });

Anexar um arquivo

Adicione um arquivo como anexo no campo de entrada de mensagem.

⚠️ Observação: Anexar um arquivo substituirá o texto que já foi inserido.

Actions.invokeAction("AttachFile", { file: File, channelSid: "unique_channel_identifier" });

Desanexar um arquivo já anexado

Remova um anexo não enviado do campo de entrada de mensagem.

⚠️ Observação: Desanexar um arquivo não restaurará o texto anterior que foi substituído usando a ação de anexar.

Actions.invokeAction("DetachFile", { file: File, channelSid: "unique_channel_identifier" });

Visualizar/baixar mídia

Baixe o arquivo anexado a uma mensagem. Isso retornará um link temporário que pode ser usado pelos membros do canal para baixar o arquivo. Esse link só é válido por 5 minutos após o qual um novo link temporário precisará ser solicitado.

Actions.invokeAction("DownloadMedia", { message: message, channelSid: "unique_channel_identifier" });

Enviar vários arquivos

Somente um arquivo pode ser enviado por vez. Você pode repetir o processo de anexação para enviar múltiplos ou compactar os arquivos que deseja enviar em um único arquivo. Observe que, se você fizer isso, deverá permitir que a extensão escolhida seja enviada (por exemplo, Zip) no arquivo de configuração.

Além disso, você deve enviar mensagens e arquivos separadamente. Se você inserir texto no elemento de entrada da mensagem, a interface do WebChat desativará o botão de anexo. Se você selecionar um arquivo, não poderá inserir nenhum texto.

Enviar/receber anexos por meio do SDK ou API REST do Programmable Chat

O recurso de anexos é baseado nos recursos de suporte de mídia do Programmable Chat. Se você tiver criado um cliente de chat personalizado no Twilio Programmable Chat, ainda poderá usar o suporte a anexos para agentes no Flex UI (IU do Flex). Todas as mensagens de mídia publicadas no canal serão renderizadas no Flex UI (IU do Flex) para o agente como anexos.

Segurança e conformidade

O suporte de mídia do Flex está em conformidade com a GDPR LGPD. Isso significa que:

  • Os registros de metadados que contêm IPI são excluídos em até 7 dias após a criação.
  • Você pode usar a API de Programmable Chat para excluir o conteúdo da mensagem e a mídia associada.

Tanto o agente (Flex UI (IU do Flex)) quanto o cliente (Flex WebChat UI) devem ativar anexos para enviar e receber arquivos. Se apenas um lado estiver ativado, o outro não poderá visualizar os anexos recebidos.

Por fim, o Flex não faz verificação de vírus ou filtragem de conteúdo. Como esse recurso é baseado nos recursos de suporte de mídia do Programmable Chat, você pode usar sua implementação interna para fazer validação adicional das mensagens de mídia enviadas, por meio de webhooks do Programmable Chat.

Limitações/problemas conhecidos

  • O supervisor não pode baixar anexos ao monitorar um chat em tempo real.
  • O supervisor não pode baixar anexos da transcrição do Insights de um chat antigo.
  • Os clientes não receberão uma mensagem de erro se o arquivo selecionado não atender às restrições de tamanho ou tipo.
  • Não é possível copiar e colar ou arrastar arquivos para o campo de entrada de mensagem.
  • O fluxo do Studio não reconhece mensagens de mídia, portanto respostas automatizadas ou o widget “Send to Flex” (Enviar ao Flex) não serão acionados
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!

thanks-feedback-gif