Este bloque admite los siguientes tipos de adjuntos:
- Enlace
- Video
- Imagen
- Archivo
- Audio
¡En un solo bloque NO se pueden combinar diferentes tipos de adjuntos!
Los adjuntos subidos al constructor no deben superar los 20 MB.
Se permite enviar hasta 10 adjuntos del mismo tipo en un solo bloque.
También puedes generar una imagen usando el botón "Generar imagen" y enviarla a tu cliente.
Cómo enviar adjuntos
Para enviar un adjunto, crea un bloque vacío y abre el editor de bloques (menú derecho).
¡Importante!
- El adjunto subido no debe superar los 20 MB. Se permite enviar hasta 10 adjuntos del mismo tipo en un solo bloque.
- No se recomienda enviar un bloque con múltiples adjuntos en una transmisión para evitar alcanzar los límites de API de diferentes mensajeros.
- NO asignes el mismo nombre a diferentes adjuntos dentro de un mismo proyecto.
- Si subes un nuevo adjunto con el mismo nombre que uno existente, el sistema entregará el archivo original. Para evitar errores y garantizar el funcionamiento correcto del bloque, asigna siempre nombres únicos a tus adjuntos.
¡Tenga en cuenta!
Particularidades de Telegram:
- Los botones NO aparecerán al enviar más de un adjunto en un bloque.
- Excepción: Si el texto del bloque supera los 1024 caracteres, el mensaje se dividirá en dos: los botones aparecerán con el texto y los adjuntos se enviarán en un mensaje separado.
- El formato de texto Markdown y HTML no funciona al enviar más de un adjunto en un bloque.
Toda la configuración de adjuntos se encuentra dentro de la configuración del bloque, accesible haciendo clic en el botón "Adjunto".
Echemos un vistazo más de cerca a los botones recién aparecidos para los tipos de adjuntos.
Enlace
El primer botón es Enlace:
- Haz clic en el botón para revelar la configuración del adjunto.
- Opción A: ingresa una URL en el campo proporcionado para compartir un enlace.
- Opción B: sube un archivo; se presentará al cliente como un enlace de descarga separado.
El archivo adjunto se enviará como un enlace desde el servidor de mavibot.ai.
Un archivo subido tiene prioridad sobre un enlace. Si se proporcionan ambos, se enviará el archivo subido.
Hay tres casillas de verificación debajo del campo de URL:
-
Notificación de clic: Cuando está habilitada, el bot registrará el clic de un usuario enviando un mensaje en el formato
link_was_pressed [link1] [link2].
¿Para qué se usa esto?
Este evento te permite rastrear qué usuarios hicieron clic en un enlace. Cuando la casilla está habilitada, el sistema envía un callback al diálogo en el formato:
link_was_pressed {url}
En este callback, link_was_pressed es un prefijo fijo, y {url} es una variable que representa la URL específica que configuraste en el bloque.
Por ejemplo, puedes hacer un seguimiento enviando recordatorios a los clientes.
Para aprender cómo configurar la respuesta del bot a un callback de clic en enlace, consulta la sección a continuación titulada Seguimiento de clics en enlaces.
Puedes configurar tu propio dominio para generar enlaces con notificaciones de clic.
Para hacer esto, ve a la configuración de tu proyecto:
Haz clic en el botón "Establecer dominio personalizado..." e ingresa tu dominio en la ventana modal:
El proceso de creación y configuración de un dominio personalizado se explica aquí.
Cuando la notificación de clic está habilitada, el enlace enviado al usuario tendrá el siguiente formato:
https://{your_domain}/{proxy_id}/s
- Casilla de verificación "Mostrar vista previa del enlace"
Esto genera una vista previa enriquecida del enlace en el mensajero, permitiendo al usuario ver un fragmento del contenido del archivo (como un título, imagen o descripción) antes de abrirlo.
- Casilla de verificación "Imagen debajo del texto"
Adjunto de video
Botón de adjunto de video
Usa esta opción al enviar videos. Por defecto, WhatsApp solo muestra videos como enlaces.
Para mostrar videos de YouTube como enlaces en todos los mensajeros:
- Acorta la URL usando cualquier acortador de URL, o
- Envíalo como un adjunto con notificación de clic habilitada.
¡Nota!
Telegram convierte automáticamente los adjuntos de video pequeños (menos de ~2 MB) en GIF.
Para videos grandes almacenados en almacenamiento externo, es mejor adjuntarlos como enlaces. El bloque tiene un límite de carga directa de 20 MB para archivos de video.
¡Tenga en cuenta!
El video se adjunta en formato MP4.
Imagen
Botón "Imagen" — úsalo para enviar las imágenes necesarias en el bot.
Como cualquier otro adjunto, una imagen se puede subir directamente desde tu computadora o especificando su URL.
Archivo
Icono de Archivo — úsalo para enviar documentos y cualquier otro archivo.
Audio
Icono de Audio: usa este icono al adjuntar o enviar un archivo en formato de audio (por ejemplo, MP3, WAV).
Para Instagram, el formato del archivo debe ser .m4a.
Envío de múltiples archivos
Para enviar múltiples adjuntos (videos, archivos, imágenes o audio):
- Navega a la sección "Adjunto" en el editor de bloques.
- Selecciona el tipo de adjunto deseado.
- Sube los archivos necesarios uno por uno.
Tenga en cuenta las siguientes restricciones al enviar múltiples adjuntos:
Límites generales:
- Cantidad: puedes agregar hasta 10 archivos del mismo tipo simultáneamente.
- Tamaño: cada archivo individual no debe superar los 20 MB.
Comportamiento específico de Telegram:
- Formato de texto: el formato markdown o HTML está deshabilitado en mensajes que contienen múltiples archivos.
- Botones: los botones interactivos no se entregan con adjuntos de múltiples archivos.
En Telegram:
- Los botones están deshabilitados cuando un bloque contiene más de un adjunto.
Excepción: Si el texto del bloque supera los 1024 caracteres, el mensaje se divide. Los botones se enviarán con el texto, mientras que los adjuntos se entregan en un mensaje separado.
- El formato de texto Markdown y HTML no funciona al enviar más de un adjunto en un bloque.
Envío de adjuntos: ejemplos
Procedamos con ejemplos prácticos. Configuraremos el bot para enviar mensajes automáticamente a intervalos de 2 segundos.
En cada bloque de ejemplo, incluiremos un tipo diferente de adjunto para demostrar cómo se muestran en Telegram.
El flujo de ejemplo demuestra diferentes tipos de adjuntos (archivo, enlace, video, imagen y audio) enviados secuencialmente con un retraso de 2 segundos.
