# Aba de anexos

Este bloco oferece suporte aos seguintes tipos de anexos:

* Link
* Vídeo
* Imagem
* Arquivo
* Áudio

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

{% hint style="warning" %}
Em um único bloco, você NÃO PODE combinar diferentes tipos de anexos!

Os anexos enviados ao construtor não devem exceder 20 MB.

É permitido enviar até 10 anexos do <mark style="color:vermelho;">**mesmo tipo**</mark> em um bloco.
{% endhint %}

Você também pode gerar uma imagem usando o botão **"Gerar imagem"** e enviá-la para o seu cliente.

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

## Como enviar anexos

Para enviar um anexo, crie um bloco vazio e abra o editor do bloco (menu à direita).

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

1. O anexo enviado não deve exceder 20 MB. Enviar até 10 anexos do <mark style="color:vermelho;">**mesmo tipo**</mark> em um bloco.
2. Não é recomendável <mark style="color:vermelho;">**enviar um bloco com vários anexos**</mark> em uma transmissão para evitar atingir os limites da API de diferentes mensageiros.
3. <mark style="color:vermelho;">**NÃO**</mark> atribua o <mark style="color:vermelho;">**mesmo nome**</mark> a anexos diferentes **dentro de um projeto**!
4. Se você enviar um novo anexo com o mesmo nome de um já existente, o sistema entregará o arquivo original. Para evitar erros e garantir o funcionamento correto do bloco, sempre atribua nomes únicos aos seus anexos.
   {% endhint %}

{% hint style="warning" %}
**Por favor, observe!**

**Especificidades do Telegram:**

* Botões <mark style="color:vermelho;">**NÃO aparecerão**</mark> ao enviar mais de um anexo em um bloco.
* *Exceção:* Se o texto do bloco exceder 1024 caracteres, a mensagem será dividida em duas — os botões aparecerão com o texto, e os anexos serão enviados em uma mensagem separada.
* A formatação de texto em Markdown e HTML não **não** funciona ao enviar mais de um anexo em um bloco.
  {% endhint %}

Todas as configurações de anexos estão localizadas nas configurações do bloco, acessíveis ao clicar em **"Anexo"** .

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

&#x20;Vamos dar uma olhada mais de perto nos botões recém-aparecidos para os tipos de anexo.

### Link

O primeiro botão é **Link**:

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

1. Clique no botão para revelar as configurações do anexo.
2. **Opção A:** insira uma URL no campo fornecido para compartilhar um link.
3. **Opção B:** envie um arquivo; ele será apresentado ao cliente como um link de download separado.

{% hint style="info" %}
O arquivo anexado será enviado como um link do servidor mavibot.ai.
{% endhint %}

{% hint style="info" %}
Um arquivo enviado tem prioridade sobre um link. Se ambos forem fornecidos, o arquivo enviado será transmitido.
{% endhint %}

Há três caixas de seleção abaixo do campo de URL:

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

1. **Notificação de clique:** Quando ativado, o bot registrará o clique de um usuário enviando uma mensagem no formato `link_was_pressed [link1] [link2]`.

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

Para que isso serve?

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

Esse evento permite rastrear quais usuários clicaram em um link. Quando a caixa de seleção está ativada, o sistema envia um callback para o diálogo no formato:

`link_was_pressed {url}` &#x20;

Nesse callback, `link_was_pressed` é um prefixo fixo, e `{url}` é uma variável que representa a URL específica que você configurou no bloco.

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

Por exemplo, você pode dar continuidade enviando lembretes aos clientes.

{% hint style="info" %}
Para aprender como configurar a resposta do bot a um callback de clique em link, veja a seção abaixo intitulada [Rastreamento de Cliques em Links.](#tracking-link-clicks)
{% endhint %}

Você pode definir seu próprio domínio para gerar links com notificações de clique.

Para fazer isso, acesse as configurações do seu projeto:

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

Clique no botão “Definir domínio personalizado...” e insira seu domínio na janela modal:

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

{% hint style="info" %}
[O processo de criação e configuração de um domínio personalizado é explicado aqui.](/doc/pt/websites/sites/builder.md#domain)
{% endhint %}

Quando a notificação de clique está ativada, o link enviado ao usuário será formatado da seguinte forma:

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

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

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

2. **caixa de seleção "Mostrar prévia do link"** caixa de seleção

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

Isso gera uma prévia rica do link no mensageiro, permitindo que o usuário veja um trecho do conteúdo do arquivo (como um título, imagem ou descrição) antes de abri-lo.

3. **"Imagem abaixo do texto"** caixa de seleção

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

### Anexo de vídeo

botão de anexo de vídeo

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

Use esta opção ao enviar vídeos. Por padrão, o WhatsApp exibe vídeos apenas como links.

**Para exibir vídeos do YouTube como links em&#x20;*****todos*****&#x20;mensageiros:**

* encurte a URL usando qualquer encurtador de URL, ou
* envie-o como anexo com **notificação de clique** ativada.

{% hint style="info" %}
Atenção!&#x20;

O Telegram converte automaticamente pequenos anexos de vídeo (menos de \~2 MB) em GIFs.
{% endhint %}

Para vídeos grandes armazenados em armazenamento externo, é melhor anexá-los como links. O bloco tem um limite de envio direto de 20 MB para arquivos de vídeo.

{% hint style="warning" %}
Por favor, observe!&#x20;

O vídeo é anexado no formato MP4.
{% endhint %}

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

### Imagem

**botão "Imagem"** — use-o para enviar as imagens necessárias no bot.

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

Como qualquer outro anexo, uma imagem pode ser enviada diretamente do seu computador ou especificando sua URL.

### Arquivo

**Arquivo** ícone — use-o para enviar documentos e quaisquer outros arquivos.

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

### **Áudio**

**Ícone de áudio:** use este ícone ao anexar ou enviar um arquivo em formato de áudio (por exemplo, MP3, WAV).

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

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

{% hint style="warning" %}
Para o Instagram, o formato do arquivo deve ser .m4a.
{% endhint %}

## Enviando vários arquivos

Para enviar vários anexos (vídeos, arquivos, imagens ou áudios):

1. Navegue até a seção **"Anexo"** no editor do bloco.
2. Selecione o tipo de anexo desejado.
3. Envie os arquivos necessários um por um.

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

{% hint style="info" %} <mark style="color:vermelho;">**Observe as seguintes restrições ao enviar vários anexos:**</mark>

**Limites gerais:**

* **Quantidade:** você pode adicionar até 10 arquivos do mesmo tipo simultaneamente.
* **Tamanho:** cada arquivo individual não deve exceder 20 MB.

**Comportamento específico do Telegram:**

* **Formatação do texto:** a formatação em markdown ou HTML é desativada em mensagens que contenham vários arquivos.
* **Botões:** botões interativos não são entregues com vários anexos de arquivo.
  {% endhint %}

**No Telegram:**&#x20;

* Os botões são desativados quando um bloco contém mais de um anexo.

*<mark style="color:azul;">Exceção:</mark>* Se o texto do bloco exceder 1024 caracteres, a mensagem será dividida. Os botões serão enviados com o texto, enquanto os anexos serão entregues em uma mensagem separada.

* <mark style="color:vermelho;">**A formatação de texto em Markdown e HTML não funciona**</mark> ao enviar mais de um anexo em um bloco.

### Envio de anexos: exemplos

Vamos seguir com exemplos práticos. Vamos configurar o bot para enviar mensagens automaticamente em intervalos de 2 segundos.

Em cada bloco de exemplo, incluiremos um tipo diferente de anexo para demonstrar como eles são exibidos no Telegram.

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

O fluxo de exemplo demonstra diferentes tipos de anexos — arquivo, link, vídeo, imagem e áudio — enviados sequencialmente com um atraso de 2 segundos.

<div data-with-frame="true"><figure><img src="/files/f365d88861cee8fd01930b654b0184851576b930" 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/pt/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.