> 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 com que a IA envie 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
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=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
