Attachment tab

This block supports the following attachment types:

• Link

• Video

• Image

• File

• Audio

In a single block, you CANNOT combine different types of attachments!

Attachments uploaded to the builder must not exceed 20 MB.

Sending up to 10 attachments of the same type in one block is allowed.

You can also generate an image using the "Generate image" button and send it to your client.

How to send attachments

To send an attachment, create an empty block and open the block editor (right menu).

Important!

1. The uploaded attachment must not exceed 20 MB. Sending up to 10 attachments of the same type in one block is allowed.

2. It is not recommended to send a block with multiple attachments in a broadcast to avoid hitting the API limits of different messengers.

3. DO NOT assign the same name to different attachments within one project!

4. If you upload a new attachment with the same name as an existing one, the system will deliver the original file. To prevent errors and ensure correct block operation, always assign unique names to your attachments.

Please note!

Telegram specifics:

• Buttons will NOT appear when sending more than one attachment in a block.

• Exception: If the block’s text exceeds 1024 characters, the message will be split into two — buttons will appear with the text, and attachments will be sent in a separate message.

• Markdown and HTML text formatting do not work when sending more than one attachment in a block.

All attachment settings are located within the block settings, accessible by clicking the "Attachment" button.

Let’s take a closer look at the newly appeared buttons for attachment types.

Link

The first button is Link:

1. Click the button to reveal the attachment settings.

2. Option A: rnter a URL in the provided field to share a link.

3. Option B: upload a file; it will be presented to the client as a separate download link.

The attached file will be sent as a link from the mavibot.ai server.

An uploaded file takes priority over a link. If both are provided, the uploaded file will be sent.

There are three checkboxes below the URL field:

1. Click notification: When enabled, the bot will log a user's click by sending a message in the format link_was_pressed [link1] [link2].

What is this used for?

This event allows you to track which users clicked a link. When the checkbox is enabled, the system sends a callback to the dialog in the format:

link_was_pressed {url}

In this callback, link_was_pressed is a fixed prefix, and {url} is a variable representing the specific URL you configured in the block.

For instance, you can follow up by sending reminders to clients.

To learn how to set up the bot's response to a link click callback, see the section below titled Tracking Link Clicks.

You can set your own domain for generating links with click notifications.

To do this, go to your project settings:

Click the “Set custom domain...” button and enter your domain in the modal window:

The process of creating and setting up a custom domain is explained here.

When click notification is enabled, the link sent to the user will be formatted as follows:

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

1. "Show link preview" checkbox

This generates a rich link preview in the messenger, allowing the user to see a snippet of the file's content (like a title, image, or description) before opening it.

1. "Image below text" checkbox

Video attachment

Video attachment button

Use this option when sending videos. By default, WhatsApp only displays videos as links.

To display YouTube videos as links in all messengers:

• Shorten the URL using any URL shortener, or

• Send it as an attachment with click notification enabled.

Note!

Telegram automatically converts small video attachments (under ~2 MB) into GIFs.

For large videos stored in external storage, it's better to attach them as links. The block has a direct upload limit of 20 MB for video files.

Please note!

The video is attached in MP4 format.

Image

"Image" button — use it to send the necessary images in the bot.

Like any other attachment, an image can be uploaded directly from your computer or by specifying its URL.

File

File icon — use it to send documents and any other files.

Audio

Audio Icon: use this icon when attaching or sending a file in an audio format (e.g., MP3, WAV).

For Instagram, the file format should be .m4a.

Sending multiple files

To send multiple attachments (videos, files, images, or audio):

1. Navigate to the "Attachment" section in the block editor.

2. Select the desired attachment type.

3. Upload the required files one by one.

Please be aware of the following constraints when sending multiple attachments:

General limits:

• Quantity: you can add up to 10 files of the same type simultaneously.

• Size: each individual file must not exceed 20 MB.

Telegram-specific behavior:

• Text formatting: markdown or HTML formatting is disabled in messages containing multiple files.

• Buttons: interactive buttons are not delivered with multiple file attachments.

In Telegram:

• Buttons are disabled when a block contains more than one attachment.

Exception: If the block text exceeds 1024 characters, the message is split. The buttons will be sent with the text, while the attachments are delivered in a separate message.

• Markdown and HTML text formatting do not work when sending more than one attachment in a block.

Sending attachments: examples

Let's proceed with practical examples. We will configure the bot to send messages automatically at 2-second intervals.

In each example block, we will include a different type of attachment to demonstrate how they are displayed in Telegram.

The example flow demonstrates different attachment types—file, link, video, image, and audio—sent sequentially with a 2-second delay.