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

Menu

Personalización del comportamiento de los archivos adjuntos de chat

Actualmente estás leyendo documentación de mensajería antigua de Flex. Si estás empezando con una nueva implementación de Flex, considera la posibilidad de utilizar Flex Conversations.

Una vez habilitados los archivos adjuntos del chat web, puedes configurar detalles adicionales sobre lo que los agentes y clientes pueden enviar, como estos:

  • Tamaño máximo de archivo permitido
  • Restricción de los archivos adjuntos a un conjunto limitado de tipos de archivo.
  • Configuración de las restricciones del agente y del cliente de forma independiente.

Configurar el tamaño máximo de archivo para los archivos adjuntos

Puedes ajustar el tamaño máximo de archivo que puede cargar el agente o el cliente. Ingresa un valor en bytes en el valor maxFileSize para establecer el tamaño máximo de archivo permitido. Si no se proporciona ningún valor, se utiliza el valor predeterminado 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 los tipos de archivos que se pueden adjuntar

También puedes especificar un conjunto personalizado de extensiones de archivo que se pueden cargar. Ingresa todas las extensiones de archivo aceptadas como una matriz en el valor acceptedExtensions.

La validación del cliente solo comprueba el tamaño del archivo adjunto y el tipo de mime. Puedes escribir lógica empresarial para realizar una validación adicional de los mensajes multimedia enviados mediante los webhook de Programmable Chat.

Todas las extensiones son compatibles con Programmable Chat, por lo que debes incluir todos los tipos de archivo que deseas utilizar en tu matriz personalizada. Un valor personalizado ingresado en la matriz acceptedExtensions anulará el conjunto de extensiones establecido.

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

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

Ejemplo de configuración de archivos adjuntos de chat web

A continuación, se muestra un ejemplo de estos dos ajustes.

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

Acciones

Hay cuatro acciones que se pueden invocar medinate programación. Puedes utilizarlas para ayudar a los agentes con acciones rápidas o automatizar partes de una interacción de chat web.

Enviar mensaje multimedia

Selecciona y envía un archivo como datos adjuntos en una sola acción.

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

Adjuntar un archivo

Agrega un archivo como datos adjuntos en el campo de entrada del mensaje.

⚠️ Nota: Al adjuntar un archivo se sustituirá el texto que ya se ingresó.

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

Quitar un archivo ya adjunto

Quita un archivo adjunto no enviado del campo de entrada del mensaje.

⚠️ Nota: Al quitar un archivo no se restaurará el texto anterior que se reemplazó mediante la acción de adjuntar.

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

Previsualizar/descargar medios

Descarga el archivo adjunto a un mensaje. Esto devolverá un enlace temporal que pueden utilizar los miembros del canal para descargar el archivo. Este enlace solo es válido durante cinco minutos, pasados los cuales será necesario solicitar un nuevo enlace temporal.

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

Enviar varios archivos

Solo se puede enviar un archivo a la vez. Puedes repetir el proceso de adjuntar archivos para enviar varios archivos o comprimir los archivos que deseas enviar en un solo archivo. Ten en cuenta que si lo haces, debes permitir el envío de la extensión seleccionada (por ejemplo, Zip) en tu archivo de configuración.

Además, debes enviar mensajes y archivos por separado. Si ingresas texto en el elemento de entrada del mensaje, la interfaz de WebChat desactivará el botón para adjuntar archivos. Si seleccionas un archivo, no podrás introducir ningún texto.

Envío y recepción de archivos adjuntos a través de la API REST o SDK de Programmable Chat

La función de archivos adjuntos se basa en capacidades de admisión multimedia de Programmable Chat. Si creaste un cliente de chat personalizado en Programmable Chat de Twilio, todavía puedes utilizar el soporte de archivos adjuntos para los agentes en Flex UI (la interfaz de usuario de Flex). Todos los mensajes multimedia publicados en el canal se mostrarán en Flex UI para el agente como archivos adjuntos.

Seguridad y cumplimiento de normas

La compatibilidad multimedia de Flex cumple con GDPR. Esto significa que:

  • Los registros de metadatos que contienen PII se eliminan en un plazo de 7 días desde su creación.
  • Puedes utilizar la API de Programmable Chat para eliminar el contenido del mensaje y los medios asociados.

Tanto el agente (Flex UI) como el cliente (interfaz de usuario de Flex WebChat) deben habilitar los archivos adjuntos para poder enviar y recibir archivos. Si solo se habilita un lado, el otro no podrá ver los archivos adjuntos recibidos.

Por último, Flex no gestiona ningún análisis de virus ni filtrado de contenido. Puesto que esta función se basa en las capacidades de admisión multimedia de Programmable Chat, puedes utilizar tu implementación interna para realizar una validación adicional de los mensajes multimedia enviados mediante webhooks de Programmable Chat.

Problemas/limitaciones conocidos

  • El supervisor no puede descargar archivos adjuntos mientras supervisa un chat en línea.
  • El supervisor no puede descargar archivos adjuntos de la transcripción de Insights de un chat anterior.
  • Los clientes no verán ningún error si el archivo que seleccionaron no cumple las restricciones de tamaño o tipo.
  • No es posible copiar y pegar o arrastrar archivos al campo de entrada del mensaje.
  • El flujo de Studio no reconoce los mensajes multimedia, por lo que ni las respuestas automatizadas ni el widget “Send to Flex” (Enviar a Flex) se activarán
Calificar esta página:

¿Necesitas ayuda?

Todos la necesitamos a veces; la programación es difícil. Obtén ayuda ahora de nuestro equipo de soporte, o recurre a la sabiduría de la multitud visitando Stack Overflow Collective de Twilio o navegando por la etiqueta de Twilio en Stack Overflow.

Gracias por tus comentarios.

Selecciona los motivos de tus comentarios. La información adicional que nos brindas nos ayuda a mejorar nuestra documentación:

Enviando tus comentarios…
🎉 Gracias por tus comentarios.
Se produjo un error. Inténtalo de nuevo.

Gracias por tus comentarios.

¡Recomiéndanos y gana USD 10 en 3 pasos sencillos!

Paso 1

Obtén un enlace

Obtén un enlace gratuito de referencia personal aquí

Paso 2

Regala USD 10

Tu usuario se registra y actualiza mediante el enlace

Paso 3

Obtén USD 10

1250 SMS gratuitos
O 1000 minutos gratuitos de voz
O 12 000 chats
O más