Envío de archivos a usuarios bot | Ranura para archivos adjuntos
Last updated
Last updated
Adjunto es un Slot diseñado para enviar archivos adjuntos del tipo especificado desde el Agente al Interlocutor. Por ejemplo, utilizando este Slot puede enviar un audio, vídeo o imagen a su Usuario Bot, que se mostrará correctamente en el mensajero con una vista previa. Un Slot de Adjuntos envía un archivo.
Atributos de Slots
Nombre - el nombre de la Ranura que se mostrará en el Árbol de Script. La longitud máxima de un valor de campo es de 40 caracteres.
Fuente: un enlace a un archivo o una variable de contexto que contenga un enlace al archivo que debe enviarse.
Recorte de espacios: al pulsar el botón CREAR (al crear una Ranura) o GUARDAR (al editar una Ranura), se recortan los espacios y saltos de línea al principio y al final del campo Fuente.
Leyenda - un mensaje de texto que acompaña al archivo o una variable con texto que debe adjuntarse al archivo. Se conservan los saltos de línea.
Los mensajes largos se recortarán a 1024 caracteres (esta longitud de mensaje cumple los requisitos de todos los mensajeros instantáneos y plataformas omnicanal compatibles).
Se permite la concatenación de cadenas y variables incluyendo variables con el formato {{ var }} en el texto, por ejemplo: aquí está su archivo {{ nombre_archivo }}.
Los espacios exteriores del mensaje final se recortarán.
Tipo primario - tipo de archivo que se envía, para una correcta visualización y previsualización del Canal Final. Opciones válidas:
Imagen
Audio
Video
Archivo
a. Validación: al pulsar el botón CREAR (al crear una ranura) o GUARDAR (al editar una ranura), se comprueba la presencia del tipo de archivo seleccionado:
i. Si no hay ningún tipo del tipo de fichero seleccionado, aparece el error Por favor, elija un tipo primario
El usuario selecciona el tipo deseado en el que el archivo debe mostrarse al usuario del bot. Por ejemplo, en Telegram se puede enviar una imagen con el tipo Imagen, entonces se mostrará directamente en el mensajero, o con el tipo Archivo, entonces se mostrará como un archivo que se puede descargar.
En la Ranura de Adjuntos, se permite utilizar Expresión y Expresión con Estructura de Control en el campo Lista de Texto. Más detalles: Sintaxis.
Funcionamiento de los Slots
El Agente recibe los valores en los campos Fuente y Leyenda, realiza la concatenación en estos campos, si existe, recorta el valor de la Leyenda a 1024 caracteres.
El Agente envía un archivo disponible a través de un enlace en el campo Fuente y un mensaje de acompañamiento desde el campo Leyenda al Canal Final indicando el tipo Primario - el tipo por el que el archivo debe llegar al Usuario Bot.
El canal final valida el vínculo entre el campo Fuente y el artículo:
este es un enlace directo al archivo (el archivo se descarga desde este enlace);
el archivo del enlace corresponde a Tipo primario;
el archivo en el enlace cumple los criterios para el tipo Primario en este Canal Final en tamaño y contenido.
Importante: para determinar los requisitos de los archivos de cada tipo, debe leer la documentación oficial de los canales a los que se aplica el Agente; cada mensajero y red social tiene sus propios requisitos, que pueden ser modificados en cualquier momento por los desarrolladores de estos canales.
Si el archivo se valida correctamente desde Origen, se entrega en el tipo Primario especificado al Usuario Bot, y se adjunta al archivo un mensaje de acompañamiento (no más de 1024 caracteres del campo Leyenda).
Importante: la entrega de archivos de gran tamaño al Usuario Bot puede llevar mucho tiempo; esto debe tenerse en cuenta a la hora de construir el Script. El Usuario Bot puede tener tiempo para escribir antes de que se le entregue el archivo grande.
En caso de que la validación del archivo desde el Origen o el error de envío desde el Canal Final no tenga éxito, el Agente repite el envío de datos desde la Ranura de Adjuntos, pero en forma de 2 mensajes de texto: el primero es el valor del campo Origen, el segundo es el valor del campo Leyenda. Antes de dicho envío, también se produce la concatenación y recuperación de los valores de las variables, si se utilizan en estos campos.
Si el canal final no admite generalmente el envío de archivos, el valor de los campos Fuente y Leyenda se envía en dos mensajes de texto. Antes de dicho envío, también se produce la concatenación y recuperación de los valores de las variables, si se utilizan en estos campos.
No todos los Canales Finales permiten transferir archivos al Usuario Bot "en forma de archivos"; algunos sólo pueden transferir un enlace para descargar el archivo. La tabla muestra qué Canales Finales admiten transferencias de archivos "en forma de archivos".
Transferencia de archivos como archivos del Agente
Webim (API de bots externos 2.0)
No
En WhatsApp a través de Webim: si el bot envió botones al usuario del bot, Webim los convertirá en una lista numerada y procesará únicamente la introducción del número de elemento; no se procesará la introducción de una etiqueta de botón u otro texto: Webim no aceptará otros caracteres/texto.
Transferencia de archivos como archivos del Agente
No
Transferencia de archivos como archivos del Agente
Webim (API de bots externos 1.0)
Yes
Transferencia de archivos como archivos del Agente
Webim (API de bots externos 1.0)
No
La ranura Attachment pasará un enlace de texto
Transferencia de archivos como archivos del Agente
Yes
Transferencia de archivos como archivos del Agente
Centro de Chat Edna
No
Transferencia de archivos como archivos del Agente
Yes
Telegram puede aceptar y enviar "archivos" adjuntos a Usuarios Bot sólo en formatos gif, pdf y zip. El soporte para otros formatos es posible, pero Telegram no lo garantiza.
Transferencia de archivos como archivos del Agente
Partially
La imagen no se transmite, el vídeo se transmite, el audio se transmite como archivo de audio, el archivo se transmite como archivo para descargar
Transferencia de archivos como archivos del Agente
Transferencia de archivos como archivos del Agente
Yes
Transferencia de archivos como archivos del Agente
No
Transferencia de archivos como archivos del Agente
No
Transferencia de archivos como archivos del Agente
No
Transferencia de archivos como archivos del Agente
Yes
Transferencia de archivos como archivos del Agente
Yes
Transferencia de archivos como archivos del Agente
Partially
El archivo adjunto se envía como un enlace desde el campo Fuente de la ranura de archivos adjuntos, que VK Teams convierte en un archivo.
Transferencia de archivos como archivos del Agente
No
Transferencia de archivos como archivos del Agente
Partially
La imagen no se transmite, el vídeo se transmite, el audio se transmite como archivo de audio, el archivo se transmite como archivo para descargar
Transferencia de archivos como archivos del Agente
No
Transferencia de archivos como archivos del Agente
Yes
Transferencia de archivos como archivos del Agente
No
Transferencia de archivos como archivos del Agente
Yes
When executing an :
El widget recibe un icono que conduce a un enlace como ; Al hacer clic, el contenido se reproduce automáticamente. Las imágenes se transmiten como imágenes.
