> For the complete documentation index, see [llms.txt](https://docs.flw.chat/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.flw.chat/guide/documentacao/apps/chatbot/enviar-mensagem/enviar-audio.md).

# Enviar Áudio

A ação **"Enviar mensagem"** do chatbot permite enviar áudios diretamente para o contato durante o fluxo de conversa. O comportamento de entrega varia conforme o tipo de canal configurado no chatbot — canais não oficiais (Z-API e Evolution API) e Instagram/Messenger sempre entregam o áudio como mensagem de voz, enquanto canal do Whatsapp da API Oficial oferece a opção de escolher entre voz e arquivo. Este artigo explica como configurar essa ação e o que esperar em cada cenário.

{% embed url="<https://drive.google.com/file/d/1UqdTJC9LMMyPLVNYnO4uxWpDaPveqYRZ/view?usp=sharing>" %}

#### **Como acessar a ação de envio de áudio**

1. No menu superior, acesse **Apps > Chatbot**.
2. Abra o chatbot que deseja editar ou crie um novo.
3. No fluxo, clique em **"+"** para adicionar um novo nó e selecione **"Enviar mensagem"**.
4. No painel lateral, selecione o tipo **"Áudio"**.

<figure><img src="/files/vOP7Me91NE9NJvilOtdN" alt=""><figcaption></figcaption></figure>

#### **Como adicionar o áudio**

Após selecionar o tipo "Áudio", você terá duas formas de inserir o conteúdo:

* **Gravar áudio:** grave diretamente pela plataforma, sem precisar de um arquivo externo.

<figure><img src="/files/gwz1V3MMIOA85OoEyYUU" alt=""><figcaption></figcaption></figure>

* **Anexar áudio:** faça o upload de um arquivo de áudio já gravado. É possível selecionar múltiplos arquivos de uma vez — mas o limite é de **5 áudios por ação**. Se você selecionar mais de 5, somente os primeiros 5 serão considerados.

<figure><img src="/files/YS37m8maxSNSRy09OMOh" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**Dica:** É possível adicionar até **5 versões de áudio** na mesma ação. Quando houver mais de uma versão, o chatbot escolherá e enviará uma delas de forma aleatória a cada execução — útil para variar a comunicação com o contato.
{% endhint %}

Cada áudio adicionado exibirá:

* **Ícone de som** — para controlar o volume na pré-visualização.
* **Menu de três pontos** — com opções para baixar o áudio ou ajustar a velocidade de reprodução. Essas opções são apenas para pré-visualização e não afetam o envio.
* **Ícone de lixeira** — para remover o áudio da lista. Ao clicar, um modal de confirmação será exibido antes de concluir a remoção.

<figure><img src="/files/4g28ML8pMVWQQn40Jzxn" alt=""><figcaption></figcaption></figure>

#### **Como o áudio é entregue ao contato**

O formato de entrega depende do tipo de canal configurado no chatbot:

<table><thead><tr><th width="249">Tipo de canal</th><th>Formato de entrega</th><th>Opção de enviar como arquivo</th></tr></thead><tbody><tr><td><strong>API Oficial (Meta)</strong></td><td>Mensagem de voz nativa por padrão</td><td>Sim — via toggle "Enviar áudio como arquivo"</td></tr><tr><td><strong>Z-API</strong></td><td>Mensagem de voz nativa (sempre)</td><td>Não disponível</td></tr><tr><td><strong>Evolution API</strong></td><td>Mensagem de voz nativa (sempre)</td><td>Não disponível</td></tr><tr><td><strong>Instagram / Messenger</strong></td><td>Mensagem de voz nativa (sempre)</td><td>Não disponível</td></tr></tbody></table>

Mensagens de voz nativas são exibidas no WhatsApp do contato com gráfico de forma de onda, ícone de microfone e botão de reprodução integrado no balão — diferente do formato de arquivo, que exibe ícone de download e barra de progresso simples.

<figure><img src="/files/MUwiX46POGJt6DRFUBUe" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
Áudios enviados via **API** são sempre entregues no formato de mensagem de voz, independentemente do canal ou da configuração. O toggle "Enviar áudio como arquivo" não se aplica a envios realizados por integração via API.
{% endhint %}

#### **Enviar áudio como arquivo (somente API Oficial)**

Para chatbots configurados com canal de **API Oficial**, é possível optar por enviar o áudio no formato de arquivo em vez de mensagem de voz. Para isso:

1. No painel de configuração da ação, ative o toggle **"Enviar áudio como arquivo"**.
2. Quando ativado, os botões de gravar e anexar áudio ficam desabilitados e os áudios já adicionados são removidos da lista — o conteúdo precisará ser reconfigurado no novo formato.
3. O áudio será entregue ao contato como um arquivo para download, e não como mensagem de voz.

{% hint style="warning" %}
Essa opção **não está disponível** para chatbots cujo canal seja **Z-API**, **Evolution API** ou **Instagram/Messenger**. Nesses casos, o toggle não é exibido.
{% endhint %}

<figure><img src="/files/FGYG8lf6OGdEizpenkW4" alt=""><figcaption></figcaption></figure>


---

# 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:

```
GET https://docs.flw.chat/guide/documentacao/apps/chatbot/enviar-mensagem/enviar-audio.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.