> For the complete documentation index, see [llms.txt](https://academy.vambe.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://academy.vambe.ai/asistentes-ia/asistentes-ia-pt-br/funcoes/como-hacer-que-la-ia-envie-un-pdf-imagen-o-archivo-automaticamente.md).

# Como fazer a IA enviar um PDF, imagem ou arquivo automaticamente?

Entregue informações visuais. Configure seu Assistente de IA para enviar catálogos, listas de preços (PDF), imagens ou vídeos promocionais dentro do chat.

A função **Enviar Documento ou Imagem** permite que seu assistente anexe um arquivo específico (PDF, JPG, PNG, vídeo, etc.) no momento em que a conversa exigir.

**Para que serve?** É ideal para entregar material de apoio que não pode ser explicado apenas com texto, como:

* Um folheto corporativo (PDF).
* Uma lista de preços ou cardápio.
* Uma foto de um produto específico.
* Um vídeo promocional.

***

#### ⚠️ Limitação Importante: O Texto Fixo

Antes de configurá-la, você precisa saber algo crucial que nosso especialista Jorge Prieto explicou:

Esta função **NÃO permite que a IA redija uma mensagem dinâmica acompanhando o arquivo.**

* **O problema:** Se você usar esta função, o arquivo será enviado acompanhado de um texto fixo que você escreve ao configurá-la.
* **A consequência:** Se o cliente fizer uma pergunta específica justamente nesse momento (ex.: "Vocês têm tamanho M?"), a IA pode ignorar a pergunta e responder apenas com o arquivo e seu texto pré-gravado (ex.: "Aqui está o catálogo").

> **Recomendação**: Use esta função para entregas de informações muito específicas, em que não se espera muita interação conversacional naquele exato momento.

***

#### Configuração Passo a Passo

Siga estes passos para anexar seus arquivos:

**Passo 1: Entrar no Assistente**

1. Vá ao menu Assistente.
2. Entre em **Passos a Seguir** ou **Casos Possíveis.**

**Passo 2: A Instrução**

Diga à IA quando ela deve entregar o material.

* *Fórmula:* `Quando [o cliente pedir X], você deve executar a função [Enviar Documento]`.

> **Exemplo Real:** "Quando o cliente me responder as 3 perguntas, você deve executar a função enviar PDF de preços".

**Passo 3: Criar a Função e Fazer Upload do Arquivo**

Clique em **+ Adicionar Função** e selecione **Enviar Documento ou Imagem.**

<figure><img src="https://1176996256-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjZ46rFloLOG1hJ2JQGi0%2Fuploads%2Fq9u1AqN9PLl3mCfV48gR%2Fimage.png?alt=media&#x26;token=35b4086d-ed5b-44a7-948e-96f0b025141f" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1176996256-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjZ46rFloLOG1hJ2JQGi0%2Fuploads%2FKUmhgDftz98uaFt3Cv87%2Fimage.png?alt=media&#x26;token=3fb21e07-2eac-4840-a487-119f829562f9" alt=""><figcaption></figcaption></figure>

Configure os campos:

1. **Nome**: Ex.: "PDF Preços".
2. **Descrição** (**Vital**): Confirme quando é ativada (Ex.: "Quando pedirem preços").
3. **Mensagem do arquivo**: Escreva o texto que acompanhará a foto. (Ex.: *"Aqui está o documento solicitado"*). Lembre-se de que este texto não mudará.
4. **Fazer upload do arquivo**: Carregue seu documento, imagem ou vídeo aqui.
   * *Nota:* Se o arquivo for muito pesado (vídeos longos), pode levar alguns segundos para carregar e ser enviado no chat.
5. **Ordem**: Você pode escolher se quer enviar primeiro o texto e depois a imagem, ou vice-versa.

<figure><img src="https://1176996256-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjZ46rFloLOG1hJ2JQGi0%2Fuploads%2FvlsbHmtobj6BllJ29Ysy%2Fimage.png?alt=media&#x26;token=d0252813-f0a2-4ea2-a6f4-e5f7443db4d2" alt=""><figcaption></figcaption></figure>

**Passo 4: Verificação Visual**

Certifique-se de ver o cartão da função criada logo abaixo do seu texto de instrução. Se você vir o cartão com o ícone de clipe/arquivo, está pronto!

<figure><img src="https://1176996256-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjZ46rFloLOG1hJ2JQGi0%2Fuploads%2FVACX3V8M8geP0tmQoKnZ%2Fimage.png?alt=media&#x26;token=b1093a3d-c7be-4563-9aa1-0097493078b2" alt=""><figcaption></figcaption></figure>

***

## Outra forma de fazer isso: anexar o arquivo diretamente no texto

Se o que você procura é justamente resolver a limitação anterior (ter um texto dinâmico e, ao mesmo tempo, um arquivo de apoio), você tem outra opção: anexar o arquivo diretamente dentro da descrição do assistente, de um cenário ou rota, ou de um passo a seguir.

Ao contrário da função **Enviar Documento ou Imagem**, aqui o arquivo fica incorporado no meio do texto, como se fosse mais uma palavra da instrução. Isso significa que a IA pode continuar redigindo sua resposta com naturalidade e, no momento certo, enviar o arquivo junto com essa mensagem gerada na hora.

### Como anexá-lo

Estando no editor da descrição, de um cenário ou de um passo, você tem quatro formas de enviar o arquivo:

* Clicando no botão **Adicionar arquivo**, localizado logo abaixo do editor, ao lado de **Adicionar função**.
* Digitando o comando `/image`.
* Arrastando o arquivo diretamente para dentro do editor.
* Colando uma imagem copiada com `Ctrl+V`.

<figure><img src="https://273591867-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjZ46rFloLOG1hJ2JQGi0%2Fuploads%2FtZkaXtwMiUSrgAv1k9LU%2Fimage%20(2).png?alt=media&amp;token=653860ef-4205-48a5-a293-fef15c5cc225" alt=""><figcaption></figcaption></figure>

Uma vez carregado, o nome do arquivo aparece destacado em azul, em linha com o restante do texto, da mesma forma que as funções aparecem. Como ele não ocupa uma linha inteira, você pode colocá-lo no meio de uma frase (por exemplo: "Envie a imagem **catalogo-2026.png** e pergunte se tem dúvidas"). Ao clicar sobre o nome, a pré-visualização do arquivo é aberta.

Quando a IA usar esse texto para responder, a Vambe reconhece automaticamente o arquivo anexado e o entrega como um arquivo real dentro do chat, não como um simples link.

{% hint style="info" %}
**Tipos e limites:** você pode anexar imagens, vídeos, áudios e PDF. As imagens permitem até 5 MB e os demais formatos até 16 MB. Os arquivos SVG não são compatíveis.
{% endhint %}

{% hint style="info" %}
Se você já tinha um link externo colado como texto em uma instrução, ele continua funcionando exatamente igual. Não é necessário substituir nada do que você já tinha configurado.
{% endhint %}

***

## Em resumo

A Vambe te dá dois caminhos para que seu assistente compartilhe arquivos com seus clientes: a função **Enviar Documento ou Imagem**, pensada para entregas pontuais com uma mensagem fixa, e a possibilidade de anexar o arquivo diretamente dentro do texto de uma descrição, cenário ou passo, quando você quer que a IA combine esse arquivo com uma resposta redigida no momento. Escolha a opção que melhor se adapte ao que você precisa comunicar em cada caso.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://academy.vambe.ai/asistentes-ia/asistentes-ia-pt-br/funcoes/como-hacer-que-la-ia-envie-un-pdf-imagen-o-archivo-automaticamente.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.