Biblioteca de Multimédia #

A Biblioteca de Multimédia permite que o seu bot de IA envie imagens, vídeos, GIFs, notas de voz e documentos PDF a um contacto durante uma conversa. Carrega os ficheiros uma vez, indica ao bot quando cada um deve ser enviado e o bot escolhe o ficheiro certo no momento certo - por exemplo, enviar a fotografia de um produto quando alguém pergunta “posso vê-lo?”, uma brochura em PDF quando alguém pede a lista de preços completa, ou uma nota de voz rápida que guia um cliente pelo seu menu.

Pense nisto como uma prateleira de ficheiros prontos a enviar para o seu bot. Você decide o que está na prateleira e quando cada item é utilizado.

A Biblioteca de Multimédia está disponível em todas as contas por predefinição.

Por que utilizar uma Biblioteca de Multimédia #

As respostas apenas em texto só vão até certo ponto. Uma fotografia, um vídeo curto ou uma nota de voz respondem frequentemente a uma questão de forma mais rápida e convincente do que um parágrafo de texto.

O que a biblioteca de multimédia permite que o seu bot faça:

• Envie a fotografia de um produto quando um contacto pede para ver algo
• Partilhe um menu, lista de preços ou imagem de um produto como imagem
• Envie um vídeo curto de demonstração ou tutorial
• Responda com um GIF quando se adequar ao tom da conversa
• Envie uma nota de voz ou clipe de áudio para um toque pessoal e humano
• Envie um documento PDF - uma brochura, lista de preços, catálogo ou documento de termos

A partir da biblioteca, o bot apenas envia ficheiros que você carregou e aprovou. Nunca inventa um ficheiro e nunca envia um ficheiro a partir de uma ligação que um contacto cole. Prefere manter um catálogo grande no seu próprio sistema? Consulte Ficheiros das suas próprias ferramentas.

Onde a encontrar #

Na barra lateral principal, em AI Studio, clique em Media Library. Esta página mostra todos os ficheiros que o bot pode enviar numa vista de toda a conta, agrupados de forma a que um ficheiro utilizado em vários locais apareça como um único cartão. Cada item pertence a um ou mais dos seus AI Agents — o cartão lista quais. Utilize o filtro Show na parte superior para ver tudo ou apenas os ficheiros de um agente.

Como o bot decide o que enviar #

Esta é a parte mais importante de configurar corretamente. Para cada item que carrega, escreve uma instrução curta descrevendo quando o bot deve enviá-lo. O bot lê estas instruções e apenas envia um item quando a situação que descreveu realmente acontece.

Por exemplo:

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

Como o bot sabe o que está em cada ficheiro #

Quando carrega um ficheiro, a plataforma analisa-o automaticamente e escreve uma breve descrição do que contém - “olha” para a sua imagem ou vídeo, ou transcreve o seu áudio. O bot utiliza isto juntamente com a sua instrução de “quando enviar”, para que compreenda tanto o que é o ficheiro como quando utilizá-lo - mesmo que a sua própria descrição seja breve. Verá este resumo de IA em cada item da lista (apresentado como “IA vê: …”).

Não tem de fazer nada para que isto aconteça - ocorre no momento do carregamento. Significa apenas que um título e uma instrução claros, juntamente com a leitura do ficheiro feita pela IA, dão ao bot a melhor oportunidade de enviar o conteúdo certo no momento certo.

Corrigir uma transcrição #

Para uma nota de voz ou ficheiro de áudio, essa descrição é a transcrição: as palavras ditas na gravação. É também o texto apresentado abaixo da nota de voz nas suas conversas depois de o bot a enviar. A transcrição automática por vezes interpreta mal um nome, uma marca ou uma palavra invulgar, e pode corrigir isso você mesmo.

1. Na sua Biblioteca de Multimédia, ou no separador Multimédia do agente, clique no item para abrir o seu editor.
2. Encontre o campo Transcrição. Este mostra o texto que foi escrito quando carregou o ficheiro.
3. Corrija as palavras que foram mal interpretadas e, em seguida, clique em Guardar.

A partir desse momento, o bot lê o texto corrigido e todas as notas de voz que envia mostram o texto corrigido por baixo. As mensagens que já foram enviadas mantêm o texto com que foram enviadas.

Informações úteis:

• A transcrição é mantida como um parágrafo curto de até 300 caracteres. Uma gravação mais longa é cortada nesse comprimento, por isso mantenha a parte que indica ao bot sobre o que é a gravação.
• Imagens, vídeos e documentos têm o mesmo campo, chamado O que o bot vê neste ficheiro. Edite-o quando a descrição automática estiver errada ou omitir algo importante.
• Pode deixar o campo vazio. O bot passará a basear-se apenas no seu título e na instrução “quando enviar”.
• O campo aparece quando edita um item existente. Um novo carregamento começa sempre com o texto automático.

Multimédia em seguimentos #

Um dos locais mais úteis para multimédia é um seguimento - o lembrete automático que o bot envia quando um contacto que respondeu anteriormente fica em silêncio durante algum tempo. Uma pequena nota de voz, um vídeo rápido ou um clip do tipo “ainda aí?” muitas vezes reengaja alguém muito melhor do que mais uma linha de texto.

Para o utilizar, escreva uma instrução de “quando enviar” que descreva uma situação de seguimento, por exemplo:

Quando esse momento chega, o bot decide se um dos seus itens multimédia se adequa ao seguimento e, em caso afirmativo, envia-o.

Pretende um ficheiro específico num seguimento específico? Uma nota de “quando enviar” descreve uma situação, pelo que o bot decide quando esta se adequa; não sabe qual é o número do seguimento que está a ser acionado. Para enviar a nota de voz exatamente no segundo lembrete e a imagem de preços no terceiro, fixe os itens a esses passos no passo de Seguimentos do agente: consulte Anexar um item multimédia a um seguimento específico.

Os seguimentos podem ser apenas multimédia. Se um item se destina a ser autónomo - por exemplo, uma nota de voz que já diz tudo - o seguimento pode ser apenas esse conteúdo multimédia, sem texto. Indique isto no campo “O que deve o bot dizer ao enviar isto?”, por exemplo, “envia apenas a nota de voz, não é necessário texto”. Caso contrário, o bot envia um pequeno lembrete de texto juntamente com o conteúdo multimédia.

Algumas coisas a saber:

• Isto funciona tanto para os seguimentos rápidos (os lembretes iniciais) como para os ciclos de seguimento de vários dias mais longos - no WhatsApp Web, Instagram, Messenger e Telegram.
• Na API do WhatsApp Business, os seguimentos multimédia só podem ser enviados enquanto a janela de 24 horas ainda estiver aberta. Depois disso, o WhatsApp permite apenas modelos pré-aprovados, pelo que os seguimentos posteriores nesse canal permanecem apenas em texto.
• Aplica-se o mesmo limite de envio por conversa, pelo que o bot não repetirá o mesmo ficheiro em vários seguimentos, a menos que aumente o limite desse item.

Como adicionar multimédia #

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

4. Em Adicionar a agentes, selecione o(s) agente(s) a que o item deve pertencer. Um item pode ser anexado a mais do que um, e pode pesquisar na lista ou ordená-la por Recente, Nome ou Em direto primeiro.
5. Clique para escolher um ficheiro (imagem, vídeo, GIF, áudio ou PDF) do seu dispositivo. Para áudio, também pode mudar para Gravar nota de voz e gravar uma diretamente na aplicação em vez de carregar. Se adicionar áudio, pode escolher se é enviado como uma nota de voz (um balão de voz gravada) ou como um ficheiro de áudio normal.
6. Escreva um Título curto para que possa reconhecer o item mais tarde (por exemplo, “Foto do vestido azul”).
7. No campo Quando deve o bot enviar isto?, descreva a situação em linguagem simples.

8. Clique em Adicionar multimédia. O item aparece na sua lista de multimédia e fica imediatamente disponível para o bot em todos os agentes a que o anexou.

Também pode adicionar multimédia a partir do separador Multimédia de um Agente — isso abre a mesma biblioteca subjacente, apenas pré-filtrada para esse agente. O separador funciona a partir do momento em que o agente existe, incluindo um que criou há um minuto ou duplicou de outro, e um ficheiro que carregue aí pertence imediatamente a esse agente:

Já carregou um ficheiro e quer reutilizá-lo noutro agente? Em vez de o carregar novamente, abra o item e clique em Assign, depois escolha o(s) agente(s) adicional(is). O ficheiro em si não é duplicado — está apenas a adicionar outro agente ao mesmo item multimédia.

O que preencher #

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

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

O bot escreve sempre a cada contacto no idioma desse contacto. Portanto, se escrever as suas notas em chinês e um contacto que fala inglês pedir para ver o local, o bot envia a fotografia com uma legenda em inglês baseada na sua nota. Escreva as suas notas no idioma que lhe for mais fácil.

Ficheiros suportados e limites #

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

Quando carrega um PDF, a plataforma lê o seu texto para que o bot saiba o que contém - tal como a análise automática para imagens e áudio.

Editar e remover multimédia #

• Para alterar o título de um item ou a sua instrução de quando enviar, clique no item e edite os campos, depois guarde. (Editar a instrução não requer voltar a carregar o ficheiro.)
• Para corrigir uma transcrição que interpretou mal uma palavra, ou a descrição do que o bot vê num ficheiro, edite esse campo no mesmo editor. Consulte Corrigir uma transcrição.
• Para remover um item, clique no ícone de eliminar (lixo) no mesmo. O ficheiro e a sua instrução são removidos e o bot deixa de o enviar.
• Para substituir o próprio ficheiro, elimine o item e adicione um novo.

Que canais podem receber multimédia #

A maioria dos canais pode receber multimédia, mas não todos:

Algumas coisas a ter em conta:

• O SMS não pode receber multimédia. Em conversas por SMS, o bot simplesmente não oferecerá itens multimédia.
• O Instagram não pode receber documentos. Numa conversa no Instagram, o bot não enviará PDFs - em vez disso, responde com texto.
• Os GIFs são automaticamente otimizados quando os carrega para que sejam animados no WhatsApp. Noutros canais, um GIF pode aparecer como uma imagem estática.
• A janela de 24 horas do WhatsApp também se aplica à multimédia. Se tiver passado demasiado tempo desde que o contacto lhe enviou a última mensagem, o WhatsApp pode bloquear qualquer mensagem - incluindo multimédia - até que este responda novamente.

Dicas para Melhores Resultados #

1. Escreva a instrução “quando enviar” como se estivesse a dar orientações a um novo membro da equipa. Descreva o momento exato - “quando um cliente pede para ver fotografias do apartamento” - e não apenas o tópico.
2. Um objetivo por item. Carregue itens separados para situações diferentes em vez de um único ficheiro que espera que cubra tudo.
3. Mantenha os ficheiros pequenos e rápidos de carregar. Uma imagem comprimida ou um pequeno clip chega mais depressa e tem melhor aspeto no chat do que um ficheiro enorme.
4. Utilize títulos claros e reconhecíveis. À medida que a sua biblioteca cresce, bons títulos facilitam a localização e a atualização do item correto.
5. Teste no Try Out. Após adicionar multimédia, utilize o separador Try Out do Agente para verificar se o bot escolhe o item certo no momento certo antes de entrar em funcionamento. A imagem, vídeo, áudio ou documento aparece diretamente no chat de teste, exatamente onde o contacto o receberia.

As conversas de teste mais antigas podem apresentar “Pré-visualização de multimédia expirada”. O chat de teste é um ambiente isolado - nenhuma mensagem real sai da sua conta - e as suas pré-visualizações de multimédia permanecem visíveis durante 7 dias. Se voltar a uma conversa de teste antiga mais tarde, uma pré-visualização expirada mostrará uma pequena nota; basta pedir novamente ao bot para a ver atualizada. As conversas reais não são afetadas: os contactos recebem o ficheiro real, que não expira.

Vários ficheiros para a mesma coisa. O bot escolhe normalmente o melhor item para o momento, por isso, cinco fotografias com a mesma nota “Quando deve o bot enviar isto?” significa habitualmente que apenas uma fotografia é enviada. Se um conjunto pertence ao mesmo grupo (todas as fotografias de um produto, um menu completo), indique-o nas instruções do agente, por exemplo “Quando alguém perguntar sobre a cadeira de jardim, envie todas as fotografias da cadeira de jardim”, e dê a cada fotografia uma nota que identifique o produto. O bot enviará então o conjunto completo numa única resposta.

O bot não fará spam com o mesmo ficheiro. Cada item é enviado, por predefinição, no máximo uma vez por conversa. Se um cliente continuar a perguntar sobre a mesma coisa, o bot responde em texto em vez de enviar a mesma imagem novamente. Aumente o valor de “Máximo de envios por conversa” num item se pretender genuinamente que este possa ser reenviado.

Ficheiros das Suas Próprias Ferramentas #

Uma biblioteca comporta até 50 itens por agente. Se as suas fotografias de produtos, menus ou folhas de especificações já residem no seu próprio sistema (uma base de dados, uma loja, um CRM), não precisa de os carregar aqui. Ligue esse sistema ao agente como uma Função Personalizada ou um servidor MCP que devolva uma ligação direta para o ficheiro, e o bot enviará o próprio ficheiro em vez de colar a ligação.

Como funciona:

1. O contacto pede algo, por exemplo, “posso ver o azeite?”
2. O bot chama a sua ferramenta e o resultado contém uma ligação de ficheiro como https://yourstore.com/images/olive-oil.jpg
3. O bot envia esse ficheiro ao contacto como uma imagem, vídeo, ficheiro de áudio ou documento real, com uma pequena legenda no idioma do contacto

O que a ligação precisa de ser:

• Uma ligação direta para o ficheiro que comece com https://. Uma ligação para uma página web (uma página de produto) não é um ficheiro; o bot partilha isso como uma ligação normal.
• Imagens: JPG, PNG, WebP, GIF. Vídeo: MP4, MOV, WebM, 3GP. Áudio: MP3, OGG, M4A, AAC, WAV. Documentos: PDF, Word, Excel, PowerPoint, CSV
• Até 16 MB por ficheiro
• Acessível sem iniciar sessão. Uma ligação que necessite de uma palavra-passe ou que já tenha expirado não pode ser enviada.

Bom saber:

• O bot apenas envia ligações que foram devolvidas pelas suas próprias ferramentas nessa conversa. Uma ligação que um contacto escreva, ou uma que o bot invente, nunca é enviada como ficheiro.
• O ficheiro é copiado quando é enviado, pelo que o contacto o mantém mesmo que a sua ligação expire mais tarde.
• Cada ligação de ficheiro é enviada no máximo uma vez por conversa.
• Aplicam-se os mesmos limites de canal que para os itens da biblioteca, consulte Que Canais Podem Receber Multimédia.
• No separador Experimentar do agente, o ficheiro aparece na conversa de teste e nada é enviado a ninguém.

Enviar multimédia manualmente #

A Biblioteca Multimédia destina-se aos envios automáticos do bot. Pode sempre enviar qualquer imagem, vídeo ou ficheiro a um contacto 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 — o separador Media dentro do editor de cada Agente.
• Agentes de IA — a página principal do grupo AI Studio, juntamente com a Base de Conhecimento e as Funções Personalizadas.
• Acompanhamentos Automatizados — o guia completo sobre as sequências de acompanhamento às quais os conteúdos multimédia podem ser anexados.