Biblioteca de Mídia #

A Biblioteca de Mídia permite que seu bot de IA envie imagens, vídeos, GIFs, notas de voz e documentos PDF para um contato durante uma conversa. Você faz o upload dos arquivos uma vez, diz ao bot quando cada um deve ser enviado, e o bot escolhe o arquivo certo no momento certo - por exemplo, enviando a foto de um produto quando alguém pergunta “posso ver?”, um folheto em PDF quando alguém pede a lista de preços completa, ou uma nota de voz rápida que guia o cliente pelo seu menu.

Pense nela como uma prateleira de arquivos prontos para envio para o seu bot. Você decide o que está na prateleira e quando cada item é usado.

A Biblioteca de Mídia está disponível em todas as contas por padrão.

Por que usar uma Biblioteca de Mídia #

Respostas apenas em texto têm suas limitações. Uma foto, um vídeo curto ou uma nota de voz geralmente respondem a uma pergunta de forma mais rápida e convincente do que um parágrafo de texto.

O que uma biblioteca de mídia permite que seu bot faça:

• Envie uma foto de produto quando um contato pedir para ver algo
• Compartilhe um menu, lista de preços ou foto de produto como uma imagem
• Envie um vídeo curto de demonstração ou tutorial
• Responda com um GIF quando isso combinar com o tom da conversa
• Envie uma nota de voz ou clipe de áudio para um toque pessoal e humano
• Envie um documento PDF - um folheto, lista de preços, catálogo ou documento de termos

O bot envia apenas arquivos que você carregou e aprovou - ele nunca busca imagens da internet nem as inventa.

Onde encontrar #

Na barra lateral principal, em AI Studio, clique em Media Library. Esta página mostra todos os arquivos que o bot pode enviar em uma visualização de conta inteira, agrupados de forma que um arquivo usado em vários lugares apareça como um único cartão. Cada item pertence a um ou mais dos seus AI Agents — o cartão lista quais. Use o filtro Show na parte superior para visualizar tudo ou apenas a mídia de um agente específico.

Em contas mais antigas que ainda usam Campaigns clássicas, a mesma página funciona de forma idêntica — os itens pertencem a campanhas em vez de agentes, e o filtro lista as campanhas.

Como o bot decide o que enviar #

Esta é a parte mais importante para acertar. Para cada item que você carregar, você escreve uma instrução curta descrevendo quando o bot deve enviá-lo. O bot lê essas instruções e só envia um item quando a situação que você descreveu realmente acontece.

Por exemplo:

Quanto mais clara for sua instrução, melhor será o tempo de resposta do bot. Instruções vagas como “enviar quando relevante” dão ao bot menos informações do que “enviar quando um cliente perguntar sobre o preço do plano premium”.

Como o bot sabe o que há em cada arquivo #

Quando você faz o upload de um arquivo, a plataforma o analisa automaticamente e escreve uma breve descrição do que ele contém - ela “olha” para sua imagem ou vídeo, ou transcreve seu áudio. O bot usa isso junto com sua instrução de “quando enviar”, para que ele entenda tanto o que é o arquivo quanto quando usá-lo - mesmo que sua própria descrição seja breve. Você verá esse resumo da IA em cada item da lista (exibido como “IA vê: …”).

Você não precisa fazer nada para isso - acontece no momento do upload. Isso significa apenas que um título e uma instrução claros, somados à leitura do arquivo feita pela IA, dão ao bot a melhor chance de enviar a coisa certa no momento certo.

Mídia em Follow-ups #

Um dos lugares mais úteis para mídia é um follow-up - o lembrete automático que o bot envia quando um contato que respondeu anteriormente fica em silêncio por um tempo. Uma nota de voz curta, um vídeo rápido ou um clipe de “ainda está aí?” geralmente reengaja alguém muito melhor do que mais uma linha de texto.

Para usar, escreva uma instrução de “quando enviar” que descreva uma situação de follow-up, por exemplo:

Quando esse momento chega, o bot decide se um dos seus itens de mídia se encaixa no follow-up e, se sim, o envia.

Follow-ups podem conter apenas mídia. Se um item deve ser enviado sozinho - digamos, uma nota de voz que já diz tudo - o follow-up pode ser apenas essa mídia, sem texto. Sinalize isso no campo “O que o bot deve dizer ao enviar isto?”, por exemplo, “apenas envie a nota de voz, nenhum texto é necessário”. Caso contrário, o bot enviará um pequeno lembrete de texto junto com a mídia.

Algumas coisas para saber:

• Isso funciona tanto para follow-ups rápidos (os lembretes iniciais) quanto para os ciclos de follow-up de vários dias mais longos - no WhatsApp Web, Instagram, Messenger e Telegram.
• Na API do WhatsApp Business, follow-ups de mídia só podem ser enviados enquanto a janela de 24 horas ainda estiver aberta. Depois disso, o WhatsApp permite apenas modelos pré-aprovados, portanto, follow-ups posteriores lá permanecem apenas em texto.
• O mesmo limite de envio por conversa se aplica, então o bot não repetirá o mesmo arquivo em follow-ups, a menos que você aumente o limite desse item.

Como adicionar mídia #

1. Na barra lateral principal, clique em AI Studio.
2. Clique em Media Library.
3. Clique no botão + Add media.

4. Escolha a qual(is) agente(s) o item deve pertencer — um item pode ser anexado a mais de um. (Em contas baseadas em campanhas mais antigas, você escolhe campanhas aqui.)
5. Clique para escolher um arquivo (imagem, vídeo, GIF, áudio ou PDF) do seu dispositivo. Para áudio, você também pode alternar para Record voice note e gravar uma diretamente no aplicativo em vez de fazer o upload. Se você adicionar áudio, pode escolher se ele será enviado como uma voice note (um balão de voz gravada) ou um audio file comum.
6. Digite um Title curto para que você possa reconhecer o item mais tarde (por exemplo, “Foto do vestido azul”).
7. No campo When should the bot send this?, descreva a situação em linguagem simples.

8. Clique em Save. O item aparece na sua lista de mídia e fica imediatamente disponível para o bot em cada agente (ou campanha) ao qual você o anexou.

Você também pode adicionar mídia a partir da aba Mídia de um Agente — que abre a mesma biblioteca subjacente, apenas pré-filtrada para aquele agente. A aba funciona a partir do momento em que o agente existe, incluindo um que você criou há um minuto ou duplicou de outro, e um arquivo que você envia para lá pertence a esse agente imediatamente. Em contas mais antigas, uma campanha que ainda mantém suas próprias configurações de IA diretamente tem a mesma etapa de Mídia integrada ao seu próprio editor:

Já enviou um arquivo e quer reutilizá-lo em outro agente? Em vez de enviá-lo novamente, abra o item e clique em Assign, depois escolha o(s) agente(s) adicional(is). O arquivo em si não é duplicado — você está apenas adicionando outro agente ao mesmo item de mídia.

O que preencher #

Estes campos são notas para o bot, não mensagens para o seu contato #

Os campos Título, Quando o bot deve enviar isto? e O que o bot deve dizer ao enviar isto? são para você escrever no idioma em que você pensa. O seu contato nunca os verá.

O bot sempre escreve para cada contato no idioma daquele contato. Portanto, se você escrever suas notas em chinês e um contato que fala inglês pedir para ver o local, o bot enviará a foto com uma legenda em inglês baseada na sua nota. Escreva suas notas no idioma que for mais fácil para você.

Arquivos suportados e limites #

• Imagens: JPG, PNG, GIF, WebP
• Vídeo: MP4, MOV, WebM
• Áudio: MP3, OGG, WAV, M4A (enviado como uma nota de voz ou um arquivo de áudio comum)
• Documentos: PDF
• Tamanho máximo: 10 MB por arquivo
• Por agente (ou campanha): até 50 itens

Quando você faz o upload de um PDF, a plataforma lê o texto dele para que o bot saiba o que há dentro - assim como a análise automática para imagens e áudio.

Editando e removendo mídia #

• Para alterar o título de um item ou sua instrução de quando enviar, clique no item, edite os campos e salve. (Editar a instrução não exige o reenvio do arquivo.)
• Para remover um item, clique no ícone de exclusão (lixeira) nele. O arquivo e sua instrução são removidos e o bot para de enviá-lo.
• Para substituir o próprio arquivo, exclua o item e adicione um novo.

Quais canais podem receber mídia #

A maioria dos canais pode receber mídia, mas nem todos:

Algumas coisas para manter em mente:

• SMS não pode receber mídia. Em conversas por SMS, o bot simplesmente não oferecerá itens de mídia.
• Instagram não pode receber documentos. Em uma conversa no Instagram, o bot não enviará PDFs - ele responderá com texto.
• GIFs são otimizados automaticamente quando você os envia para que sejam animados no WhatsApp. Em alguns outros canais, um GIF pode aparecer como uma imagem estática.
• A janela de 24 horas do WhatsApp também se aplica à mídia. Se muito tempo tiver passado desde que o contato enviou a última mensagem, o WhatsApp pode bloquear qualquer mensagem - incluindo mídia - até que ele responda novamente.

Dicas para Melhores Resultados #

1. Escreva a instrução de “quando enviar” como se estivesse orientando um novo membro da equipe. Descreva o momento exato - “quando um cliente pedir para ver fotos do apartamento” - e não apenas o tópico.
2. Um propósito por item. Faça o upload de itens separados para situações diferentes, em vez de um único arquivo que você espera que cubra tudo.
3. Mantenha os arquivos pequenos e rápidos de carregar. Uma imagem compactada ou um clipe curto chega mais rápido e parece melhor no chat do que um arquivo enorme.
4. Use títulos claros e reconhecíveis. Quando sua biblioteca crescer, bons títulos facilitarão encontrar e atualizar o item correto.
5. Teste no Try Out. Após adicionar a mídia, use a aba Try Out do Agente para verificar se o bot escolhe o item certo no momento certo antes de entrar em operação. A imagem, vídeo, áudio ou documento aparece diretamente no chat de teste, exatamente onde o contato o receberia.

Conversas de teste mais antigas podem exibir “Prévia de mídia expirada”. O chat de teste é um ambiente de simulação - nenhuma mensagem real sai da sua conta - e suas prévias de mídia permanecem visíveis por 7 dias. Se você voltar a uma conversa de teste antiga mais tarde, uma prévia expirada mostrará uma pequena nota; basta pedir ao bot novamente para vê-la atualizada. Conversas reais não são afetadas: os contatos recebem o arquivo real, que não expira.

O bot não enviará o mesmo arquivo repetidamente. Cada item é enviado no máximo uma vez por conversa por padrão. Se um cliente continuar perguntando sobre a mesma coisa, o bot responderá em texto em vez de disparar a mesma imagem novamente. Aumente o valor de “Máximo de envios por conversa” em um item se você realmente quiser que ele seja reenviável.

Enviando mídia você mesmo #

A Biblioteca de Mídia é para os envios automáticos do bot. Você sempre pode enviar qualquer imagem, vídeo ou arquivo para um contato manualmente a partir da Interface de Chat a qualquer momento - isso não requer a configuração de um item na biblioteca.

Próximos passos #

• Agentes de IA — a aba Mídia dentro do editor de cada Agente.
• Agentes de IA — a página principal do grupo AI Studio, ao lado da Base de Conhecimento e Funções Personalizadas.
• Follow-ups Automatizados — o guia completo sobre as sequências de follow-up às quais a mídia pode ser anexada.