Functions for sending attachments in messages
How to send documents
Example
Let’s go through an example of sending a single document, adding inline buttons and a description to the document:
First, get the link to your document. A detailed explanation of how to do this can be found here.
Сreate a block and set the variables as shown in the screenshot:
Send the block to ourselves and see the result of our work:
Now let’s look at sending multiple documents.
Here as well, you need to obtain an internal Telegram link for each document and form an array. lnkdoc='[["BQACAgIAAxkBAAIQA2O8oEMNYPTgjLvglZ63HIYYOBwFAALvHwACtjXoSXFhhNvRN6MGLQQ", "Document1"],["BQACAgIAAxkBAAIQA2O8oEMNYPTgjLvglZ63HIYYOBwFAALvHwACtjXoSXFhhNvRN6MGLQQ", "Document2"]]'
Finally, put together the function for sending documents:
3. And check out the result of work:
How to send an audio / audio voice
Example
As stated in above, the function works with .OGG files. Therefore, the first task is to obtain an audio recording in this format. If you have an .MP3 file, you can convert it to .OGG using the https://t.me/mp3toolsbot bot.
Next, send the resulting file to yourself in the bot to get the file_id following the algorithm described here.
Now put the function together:
Great! Well done!
Error when sending voice messages
If a message fails to send due to privacy settings, the following error is returned:
{"ok":false,"error_code":400,"description":"Bad Request: user restricted receiving of voice messages"}
Cause of the error: the user’s privacy settings contain the option “Do not receive voice messages” (either from everyone, or only allowing from certain users):
Even if the user disables this privacy restriction, the error will still continue to appear.
In fact, only completely removing the client from the Mavibot database helps to overcome this error, even though the user has already enabled permissions.
Solution:
After the user changes their privacy settings, you need to wait for a pause of 30–60 seconds (until the messenger servers process the changes), and only then send an API request to Telegram via the bot: https://api.telegram.org/bot<TOKEN>/getChat?chat_id=#{platform_id}
After this, the user data will be refreshed and voice messages will be sent correctly.
How to send animations
Example
Let’s make the task more complex and send an animation with copy and spoiler protection.
As always, the process starts with obtaining the internal Telegram link for the selected animation (details here).
Finally, put together the function:
And check out the result of work:
How to send videos
Example
So, start by obtaining the link to the file we want to send, and then fill in the required function parameters:
After checking out we get the video:
How to send a round video
Example
If you have a square video, you can convert it to a round one using the https://t.me/roundNoteBot bot:
Once you have the round video, send it to yourself in the bot to get the link (details here), and then set up the function for sending the round video:
How to send a location
Example
So, let’s start by determining the coordinates of the place. You can get them using Google Maps
Next, convert the obtained coordinates from decimal degrees to geographic format using any online coordinates converter:
Now, let’s proceed with filling in the function parameters and obtaining the desired result:
How to send contacts
Example
Fill in the parameters: phone number, first name, and last name.
Check out result:
How to send a sticker
Example
Sending a sticker is no different from sending any other attachment: 1. Obtain the internal Telegram link (details here) 2. Fill in the function parameters 3. Send the block to yourself and check the result
Result:
How to send a photo
Understanding the caption parameter
caption parameterThe caption parameter provides descriptive text for an image (e.g., a short summary or explanation). It functions as follows:
With a single image: if a caption is provided, the message will contain both the image and the descriptive text.
With multiple images: each image can have its own individual caption. In this case, each image will be sent alongside its specific description.
User experience: the caption text is typically revealed when a user clicks or taps on the image.
For detailed technical specifications and API behavior, please refer to the official Telegram documentation.
Note: if you are following a video tutorial, please review the steps carefully as settings and interfaces may update over time.
Example
Let's look at an example function for sending multiple images:
first, create an image array
Next, fill in the function parameters
Send the block to yourself and enjoy the result
How to send a dice
Example
The simplest option is to call the function with only one required parameter:
In this case, the client will receive a dice:
If the client rolls the dice (by clicking on the received emoji), the bot will receive a callback with the number of points rolled:
You can experiment with this function. For example, let's create a slot machine and add a Points button. When the button is pressed, we will receive the client's total points:
How to send a media group
Example
Let's look at an example function for sending multiple images:
first, create an image array
Next, fill in the function parameters
Send the block to yourself and enjoy the result
How to send large file attachments
Example
In Telegram (both for business accounts and regular accounts), you can send attachments via a link:
You can send attachments of any size, bypassing file size limits.
You can also send any type of attachment you need.
How to do it:
Copy the link to an attachment that is already publicly accessible:
Then, paste the copied link into the attachment function in your block:
Done. This way, you can send attachments of any type and size.
Last updated