# Pestaña de archivos adjuntos

Este bloque admite los siguientes tipos de adjuntos:

* Enlace
* Vídeo
* Imagen
* Archivo
* Audio

<div data-with-frame="true"><figure><img src="/files/d2c935473256c502a775240de8c96291d733dba5" alt=""><figcaption></figcaption></figure></div>

{% hint style="warning" %}
¡En un solo bloque, NO puedes combinar diferentes tipos de adjuntos!

Los adjuntos cargados en el generador no deben superar los 20 MB.

Se permite enviar hasta 10 adjuntos del <mark style="color:rojo;">**mismo tipo**</mark> en un solo bloque.
{% endhint %}

También puedes generar una imagen usando el **botón "Generar imagen"** y enviarla a tu cliente.

<div data-with-frame="true"><figure><img src="/files/d5a8a111d6bab17bce8b16fbd8a10e053d0601d5" alt="" width="375"><figcaption></figcaption></figure></div>

## Cómo enviar adjuntos

Para enviar un adjunto, crea un bloque vacío y abre el editor del bloque (menú derecho).

{% hint style="danger" %}
¡Importante!&#x20;

1. El adjunto cargado no debe superar los 20 MB. Se permite enviar hasta 10 adjuntos del <mark style="color:rojo;">**mismo tipo**</mark> en un solo bloque.
2. No se recomienda <mark style="color:rojo;">**enviar un bloque con varios adjuntos**</mark> en una difusión para evitar alcanzar los límites de la API de diferentes mensajeros.
3. <mark style="color:rojo;">**NO**</mark> asignes el <mark style="color:rojo;">**mismo nombre**</mark> a diferentes adjuntos **dentro de un mismo proyecto**!
4. Si cargas un nuevo adjunto con el mismo nombre que uno existente, el sistema entregará el archivo original. Para evitar errores y garantizar el correcto funcionamiento del bloque, asigna siempre nombres únicos a tus adjuntos.
   {% endhint %}

{% hint style="warning" %}
**¡Ten en cuenta!**

**Detalles específicos de Telegram:**

* Botones <mark style="color:rojo;">**NO aparecerán**</mark> 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 **no** funciona al enviar más de un adjunto en un bloque.
  {% endhint %}

Todos los ajustes de adjuntos se encuentran dentro de la configuración del bloque, accesible haciendo clic en el **"Adjunto"** botón.

<div data-with-frame="true"><figure><img src="/files/64968e86cdd306a4d68d78d935bdd101a91cf93f" alt="" width="375"><figcaption></figcaption></figure></div>

&#x20;Veamos más de cerca los nuevos botones que han aparecido para los tipos de adjuntos.

### Enlace

El primer botón es **Enlace**:

<div data-with-frame="true"><figure><img src="/files/be9956e0b3a51b1991f65b754dd412f6bc343648" alt="" width="563"><figcaption></figcaption></figure></div>

1. Haz clic en el botón para mostrar la configuración del adjunto.
2. **Opción A:** introduce una URL en el campo proporcionado para compartir un enlace.
3. **Opción B:** sube un archivo; se presentará al cliente como un enlace de descarga independiente.

{% hint style="info" %}
El archivo adjunto se enviará como un enlace desde el servidor mavibot.ai.
{% endhint %}

{% hint style="info" %}
Un archivo cargado tiene prioridad sobre un enlace. Si se proporcionan ambos, se enviará el archivo cargado.
{% endhint %}

Hay tres casillas de verificación debajo del campo URL:

<div data-with-frame="true"><figure><img src="/files/07106dc14061b4a8ad2ea3c08e5e757a0de1c8fd" alt="" width="245"><figcaption></figcaption></figure></div>

1. **Notificación de clic:** Cuando está activada, el bot registrará el clic de un usuario enviando un mensaje en el formato `link_was_pressed [link1] [link2]`.

<div data-with-frame="true"><figure><img src="/files/5135b7edcb6b3a8eee20f52fb4d2f5b278cf9dbb" alt="" width="320"><figcaption></figcaption></figure></div>

¿Para qué se utiliza esto?

<div data-with-frame="true"><figure><img src="/files/79c1c8e262445b498ffbe7051a0a36a2e04df31d" alt="" width="375"><figcaption></figcaption></figure></div>

Este evento te permite rastrear qué usuarios hicieron clic en un enlace. Cuando la casilla está activada, el sistema envía una devolución de llamada al diálogo en el formato:

`link_was_pressed {url}` &#x20;

En esta devolución de llamada, `link_was_pressed` es un prefijo fijo, y `{url}` es una variable que representa la URL específica que configuraste en el bloque.

<div data-with-frame="true"><figure><img src="/files/0102118abe72b23740862268670a031257b71eb9" alt="" width="563"><figcaption></figcaption></figure></div>

Por ejemplo, puedes hacer un seguimiento enviando recordatorios a los clientes.

{% hint style="info" %}
Para aprender cómo configurar la respuesta del bot a una devolución de llamada de clic en un enlace, consulta la sección a continuación titulada [Seguimiento de clics en enlaces.](#tracking-link-clicks)
{% endhint %}

Puedes configurar tu propio dominio para generar enlaces con notificaciones de clic.

Para ello, ve a la configuración de tu proyecto:

<div data-with-frame="true"><figure><img src="/files/4a93ec25304c78aba91fe813a7f38da5cc10e57a" alt=""><figcaption></figcaption></figure></div>

Haz clic en el botón “Establecer dominio personalizado...” e introduce tu dominio en la ventana modal:

<div data-with-frame="true"><figure><img src="/files/84976486639de7baa800502e1585fc9b897da4e1" alt="" width="563"><figcaption></figcaption></figure></div>

{% hint style="info" %}
[El proceso de creación y configuración de un dominio personalizado se explica aquí.](/doc/es/websites/sitios/builder.md#domain)
{% endhint %}

Cuando la notificación de clic está activada, el enlace enviado al usuario tendrá el siguiente formato:

`https://{your_domain}/{proxy_id}/s`

<div data-with-frame="true"><figure><img src="/files/9c9fa62b829ed8eaa067a85a7cb4b8b918092bbb" alt="" width="375"><figcaption></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="/files/50e196363adc9056cd434bbed8bdeac941ee9d93" alt="" width="375"><figcaption></figcaption></figure></div>

2. **casilla "Mostrar vista previa del enlace"** casilla de verificación

<div data-with-frame="true"><figure><img src="/files/164dba891f6d8cb6c49ea8ff095762ebc1fd0481" alt="" width="344"><figcaption></figcaption></figure></div>

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.

3. **"Imagen debajo del texto"** casilla de verificación

<div data-with-frame="true"><figure><img src="/files/6868b5ead8e2b98388f41399f262bfd8fc15f2b7" alt="" width="375"><figcaption></figcaption></figure></div>

### Adjunto de video

Botón de adjunto de video

<div data-with-frame="true"><figure><img src="/files/0dcb02cad91051ec1b2211cbedd12f31e9d429be" alt="" width="375"><figcaption></figcaption></figure></div>

Usa esta opción al enviar videos. Por defecto, WhatsApp solo muestra los videos como enlaces.

**Para mostrar videos de YouTube como enlaces en&#x20;*****todos*****&#x20;los mensajeros:**

* Acorta la URL usando cualquier acortador de URL, o
* Envíalo como un adjunto con **notificación de clic** activada.

{% hint style="info" %}
¡Nota!&#x20;

Telegram convierte automáticamente los adjuntos de video pequeños (de menos de \~2 MB) en GIF.
{% endhint %}

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.

{% hint style="warning" %}
¡Ten en cuenta!&#x20;

El video se adjunta en formato MP4.
{% endhint %}

<div data-with-frame="true"><figure><img src="/files/fd222e8fd210941eb11dc64adda57e55a221c15b" alt="" width="375"><figcaption></figcaption></figure></div>

### Imagen

**botón "Imagen"** — úsalo para enviar las imágenes necesarias en el bot.

<div data-with-frame="true"><figure><img src="/files/a910e1ada8adb5b849b2a8fd911dc075f4e9979f" alt="" width="563"><figcaption></figcaption></figure></div>

Como cualquier otro adjunto, una imagen puede cargarse directamente desde tu computadora o especificando su URL.

### Archivo

**Archivo** icono — úsalo para enviar documentos y cualquier otro archivo.

<div data-with-frame="true"><figure><img src="/files/045e49817ba2aea793f585ee1eee58840e475a0e" alt="" width="563"><figcaption></figcaption></figure></div>

### **Audio**

**Icono de audio:** usa este icono al adjuntar o enviar un archivo en formato de audio (p. ej., MP3, WAV).

<div data-with-frame="true"><figure><img src="/files/801dc6aa04d5b1550f8a3ec16f468decf919b923" alt="" width="563"><figcaption></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="/files/6c04bbe8cd1c9d6a743ebf4790613ac429e70e22" alt="" width="563"><figcaption></figcaption></figure></div>

{% hint style="warning" %}
Para Instagram, el formato del archivo debe ser .m4a.
{% endhint %}

## Envío de varios archivos

Para enviar varios adjuntos (videos, archivos, imágenes o audio):

1. Ve a la **"Adjunto"** sección en el editor del bloque.
2. Selecciona el tipo de adjunto deseado.
3. Carga los archivos necesarios uno por uno.

<div data-with-frame="true"><figure><img src="/files/90c820c0948b25bdb16ae59813044072b9bf9517" alt="" width="563"><figcaption></figcaption></figure></div>

{% hint style="info" %} <mark style="color:rojo;">**Ten en cuenta las siguientes restricciones al enviar varios adjuntos:**</mark>

**Límites generales:**

* **Cantidad:** puedes añadir 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 varios archivos.
* **Botones:** los botones interactivos no se entregan con varios archivos adjuntos.
  {% endhint %}

**En Telegram:**&#x20;

* Los botones se deshabilitan cuando un bloque contiene más de un adjunto.

*<mark style="color:azul;">Excepción:</mark>* 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 entregarán en un mensaje separado.

* <mark style="color:rojo;">**El formato de texto Markdown y HTML no funciona**</mark> al enviar más de un adjunto en un bloque.

### Envío de adjuntos: ejemplos

Pasemos a 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.

<div data-with-frame="true"><figure><img src="/files/48436aebef0285cb50a8f60fdea53e0cfedada72" alt=""><figcaption></figcaption></figure></div>

El flujo de ejemplo demuestra diferentes tipos de adjuntos: archivo, enlace, video, imagen y audio, enviados secuencialmente con un retraso de 2 segundos.

<div data-with-frame="true"><figure><img src="/files/5abd584fc41c1b2dfc96ad7856143463fdd5c54a" alt="" width="375"><figcaption></figcaption></figure></div>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.mavibot.ai/doc/es/chatbot/builder/attachments/tab.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.