Este bloco suporta os seguintes tipos de anexo:

  • Link
  • Vídeo
  • Imagem
  • Arquivo
  • Áudio

Em um único bloco, NÃO é possível combinar diferentes tipos de anexos!

Os anexos enviados para o builder não devem exceder 20 MB.

É permitido enviar até 10 anexos do mesmo tipo em um bloco.

Você também pode gerar uma imagem usando o botão "Gerar imagem" e enviá-la para seu cliente.

Como enviar anexos

Para enviar um anexo, crie um bloco vazio e abra o editor de blocos (menu direito).

Importante!

  1. O anexo enviado não deve exceder 20 MB. É permitido enviar até 10 anexos do mesmo tipo em um bloco.
  2. Não é recomendado enviar um bloco com vários anexos em uma transmissão para evitar atingir os limites de API de diferentes mensageiros.
  3. NÃO atribua o mesmo nome a anexos diferentes dentro de um mesmo projeto!
  4. Se você enviar um novo anexo com o mesmo nome de um existente, o sistema entregará o arquivo original. Para evitar erros e garantir a operação correta do bloco, sempre atribua nomes exclusivos aos seus anexos.

Por favor, note!

Especificidades do Telegram:

  • Os botões NÃO aparecerão ao enviar mais de um anexo em um bloco.
  • Exceção: Se o texto do bloco exceder 1024 caracteres, a mensagem será dividida em duas — os botões aparecerão com o texto e os anexos serão enviados em uma mensagem separada.
  • A formatação de texto Markdown e HTML não funciona ao enviar mais de um anexo em um bloco.

Todas as configurações de anexo estão localizadas nas configurações do bloco, acessíveis clicando no botão "Anexo".

Vamos dar uma olhada mais de perto nos botões recém-aparecidos para tipos de anexo.

O primeiro botão é Link:

  1. Clique no botão para revelar as configurações do anexo.
  2. Opção A: insira uma URL no campo fornecido para compartilhar um link.
  3. Opção B: envie um arquivo; ele será apresentado ao cliente como um link de download separado.

O arquivo anexado será enviado como um link do servidor mavibot.ai.

Um arquivo enviado tem prioridade sobre um link. Se ambos forem fornecidos, o arquivo enviado será enviado.

Há três caixas de seleção abaixo do campo de URL:

  1. Notificação de clique: Quando ativada, o bot registrará o clique de um usuário enviando uma mensagem no formato link_was_pressed [link1] [link2].

Para que isso é usado?

Este evento permite rastrear quais usuários clicaram em um link. Quando a caixa de seleção está ativada, o sistema envia um callback para o diálogo no formato:

link_was_pressed {url}

Neste callback, link_was_pressed é um prefixo fixo, e {url} é uma variável que representa a URL específica que você configurou no bloco.

Por exemplo, você pode acompanhar enviando lembretes aos clientes.

Para aprender como configurar a resposta do bot a um callback de clique em link, veja a seção abaixo intitulada Rastreando Cliques em Links.

Você pode definir seu próprio domínio para gerar links com notificações de clique.

Para fazer isso, vá para as configurações do seu projeto:

Clique no botão "Definir domínio personalizado..." e insira seu domínio na janela modal:

O processo de criação e configuração de um domínio personalizado é explicado aqui.

Quando a notificação de clique está ativada, o link enviado ao usuário será formatado da seguinte forma:

https://{your_domain}/{proxy_id}/s

  1. Caixa de seleção "Mostrar pré-visualização do link"

Isso gera uma pré-visualização rica do link no mensageiro, permitindo que o usuário veja um trecho do conteúdo do arquivo (como título, imagem ou descrição) antes de abri-lo.

  1. Caixa de seleção "Imagem abaixo do texto"

Anexo de vídeo

Botão de anexo de vídeo

Use esta opção ao enviar vídeos. Por padrão, o WhatsApp exibe vídeos apenas como links.

Para exibir vídeos do YouTube como links em todos os mensageiros:

  • Encurte a URL usando qualquer encurtador de URL, ou
  • Envie-o como um anexo com notificação de clique ativada.

Nota!

O Telegram converte automaticamente anexos de vídeo pequenos (abaixo de ~2 MB) em GIFs.

Para vídeos grandes armazenados em armazenamento externo, é melhor anexá-los como links. O bloco tem um limite de upload direto de 20 MB para arquivos de vídeo.

Por favor, note!

O vídeo é anexado no formato MP4.

Imagem

Botão "Imagem" — use-o para enviar as imagens necessárias no bot.

Como qualquer outro anexo, uma imagem pode ser enviada diretamente do seu computador ou especificando sua URL.

Arquivo

Ícone de Arquivo — use-o para enviar documentos e quaisquer outros arquivos.

Áudio

Ícone de Áudio: use este ícone ao anexar ou enviar um arquivo em formato de áudio (por exemplo, MP3, WAV).

Para o Instagram, o formato do arquivo deve ser .m4a.

Enviando vários arquivos

Para enviar vários anexos (vídeos, arquivos, imagens ou áudio):

  1. Navegue até a seção "Anexo" no editor de blocos.
  2. Selecione o tipo de anexo desejado.
  3. Envie os arquivos necessários um por um.

Esteja ciente das seguintes restrições ao enviar vários anexos:

Limites gerais:

  • Quantidade: você pode adicionar até 10 arquivos do mesmo tipo simultaneamente.
  • Tamanho: cada arquivo individual não deve exceder 20 MB.

Comportamento específico do Telegram:

  • Formatação de texto: a formatação markdown ou HTML está desabilitada em mensagens contendo vários arquivos.
  • Botões: botões interativos não são entregues com anexos de vários arquivos.

No Telegram:

  • Os botões são desabilitados quando um bloco contém mais de um anexo.

Exceção: Se o texto do bloco exceder 1024 caracteres, a mensagem é dividida. Os botões serão enviados com o texto, enquanto os anexos são entregues em uma mensagem separada.

  • A formatação de texto Markdown e HTML não funciona ao enviar mais de um anexo em um bloco.

Enviando anexos: exemplos

Vamos prosseguir com exemplos práticos. Configuraremos o bot para enviar mensagens automaticamente em intervalos de 2 segundos.

Em cada bloco de exemplo, incluiremos um tipo diferente de anexo para demonstrar como eles são exibidos no Telegram.

O fluxo de exemplo demonstra diferentes tipos de anexo—arquivo, link, vídeo, imagem e áudio—enviados sequencialmente com um atraso de 2 segundos.