# Messenger broadcasts

{% hint style="warning" %}
Attention!&#x20;

The maximum number of scheduled messages per client is 32 messages.
{% endhint %}

{% hint style="warning" %}
Please note!

Mailing lists are NOT AVAILABLE during the test period. During downloading clients from a file, the offset and sending functionality is NOT AVAILABLE!
{% endhint %}

Each messenger has its own requirements for the content of the sent messages. For more information, see Messengers and Chats. — вставить ссылку

## How to make broadcast

There are two ways to send broadcasts: from the Mailing List menu

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXecZNt8oUpsGZiMlH-4LRa2BISAWA5_iWlobFEh_FnzwUmZvlhE1pZV4yNkGKexb_8IGhrJwS6WCz0cLk0_fflpyxNRg67Ay7yhn8HaHNrNRT-06wbIXEiv39nhX00f14kvnTrd?key=0k4bj15m2-XSYnqO52VLa4p8" alt=""><figcaption><p>Picture 1. The menu on the left side of the screen is the Mailing List section.</p></figcaption></figure>

Or directly from the Funnel Constructor by selecting a block and clicking on "Create mailing" on the right. In the same way, you can start mailing chains by setting the desired time intervals in the arrows.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXe1pi_9H0kY0FPLUprXIcgG5hatyrJLj2nVlEeljXl4ZuMwNbl4-BhM5me9edCs8_Zy7EdLc_jul95cBa0I_z_XBMeNGGc9sw0U67nzcwUszIAxMeKivPZWAHzBU5vyX07iKTn3Dg?key=0k4bj15m2-XSYnqO52VLa4p8" alt="" width="375"><figcaption><p>Picture 2. Block Editor</p></figcaption></figure>

Message chains are very popular in messenger marketing. This is a mechanism where multiple messages are sent to the user at intervals to keep them interested. It can also be used as reminders before an event. For example, you can send notifications a week, a day, and so on before the scheduled time.

When the mailing list starts from the block, the status of the clients will change. That is, if they stop at any stage of the funnel, they will be automatically transferred to the stage from which the mailing is being sent.

If you need not to "delete" users out of the chain, use the "Out of state" blocks (Pic. 3).

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdDyahAvVANMZwwd_TA5KcQbXAxg4Yr4i2ggA2PzTWViWXpq3GZxQ5X_b4l7zNj_wYvrPBpoXFbAMZSbhkl7_RwuGiHONxTnU3_zUTEzJKFJMOFQmrP5RGE3NZC5cvGYSD32Zyd9g?key=0k4bj15m2-XSYnqO52VLa4p8" alt="" width="563"><figcaption><p>Picture 3. The scheme for mailing from the block, the block type is not the state.</p></figcaption></figure>

The mailing list creation form consists of 3 tabs: "Recipients", "Message" and "Sending".

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdjCzbCLs_H5aw2DvVifbwlBr_jIh9LB76E8kJTXbk6siawb9fzI9v5fx87P2n4KNpUhfwHX6ofExLBy9h0tILRhxcP6ew7lOivnMQWsb_9xsIz-PhTjTm6_UhIn9Z_UAVLLEGC-w?key=0k4bj15m2-XSYnqO52VLa4p8" alt="" width="563"><figcaption><p>Picture 4. The "Recipients" tab</p></figcaption></figure>

### The "Recipients" tab

The recipients of the mailing list are indicated in this form.

If no filters are set, mailing will be sent to all subscribers.

Filter types: Filter by messenger clients and Download from a file.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcCuH-zwjJrypFU_DB60nObUcfE84K7h6iSgT6I5Uwsul7hl7XcV2Hoq6YNBAqV4puhyAA9omkhdzv3va4ZAKiPuYrmoVEIvByF8qm9v46CP4pbnneP1mT6Oc7AGRekb8pAFUoCuw?key=0k4bj15m2-XSYnqO52VLa4p8" alt="" width="563"><figcaption><p>Picture 5. The type of mailing recipient filter</p></figcaption></figure>

You can select "when" to recalculate the mailing list recipients:

1. during creating the mailing list, the number of recipients will not change;
2. at the start of the mailing list, at the scheduled time of the mailing, the system itself will recalculate the number of users who match the selected filters.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXepjEINB8loZe_Ez7jkg8X5Akk6TdQb_fI6WQSGwkkb4Pb1U_D7Zxhl5BknJ5Xgpr3vRNNqvv7KIV0uRK5xxFz_SOaTfc69YyDEDQwpO_OozqnsBiufC9b3NJbCVGn8-9MiBkCmrQ?key=0k4bj15m2-XSYnqO52VLa4p8" alt="" width="563"><figcaption><p>Picture 6. Options for counting mailing recipients</p></figcaption></figure>

#### Subscribers filter

Here you can also filter clients by messengers and send mailing, for example, only to users from Telegram. Or select clients who wrote to the bot before/after a certain date.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXfFpNs3oUm4I9AKjKOqU4yMhvvvZiZ020TaZFGW3LQnKYHIfsdV_KbWGakZDd6c925DymeDTL7dqqefuC57YKArnVOYc6_YGW8aMtxYCbKnlZyHDQsdyJlIqtXzXWAyUdQyR_KH?key=0k4bj15m2-XSYnqO52VLa4p8" alt="" width="563"><figcaption><p>Picture 7. Available options for filtering users</p></figcaption></figure>

Mailing Lists: Select available lists from the Lists section. You can select several one.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXc0z2z-jojclsC-lh8ezriwYZxXc5levb-o0fqlj21M0H8UfJlheoSnx09emx7zPm3kJFVMYt2jaUyfVkDC19-3fKt1NzfF7Hi2d4aUe85EIOUrZtyKmhAeLbTV6wuUtUf18zP9eQ?key=0k4bj15m2-XSYnqO52VLa4p8" alt="" width="563"><figcaption><p>Picture 8. Filter by lists</p></figcaption></figure>

Status in CRM: selecting the stages (states) of the built-in CRM: The mailing will be received by customers who are at the selected stages of the funnel.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXczDm5QllT6yoedeWbLIJAQ0DfxepA9cRDWKNb-DJXuTsQ1wNfW2M1K1q-S1DZqh99oz-w01XiIMlO9AbvbWzSBHRkqcArYlbOfnBCsguirIYE49Vc0nHzYx0ysaJAfCqYJqvKRjQ?key=0k4bj15m2-XSYnqO52VLa4p8" alt="" width="563"><figcaption><p>Picture 9. Status in СRM</p></figcaption></figure>

Exclude lists: Those who are on the selected lists will be excluded from the recipients. You can select several.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdQA8Y_ZMFHmk6JalunMMQ_zksI_CT_Co4ft53I_B62sANAdYrO-jMlE2fz7cMwK0HMHmXnAI8z4NiTGf_RQKOuWJdGvCFiRiz8JvnkFuxDkMHEBIVHU5bhZA7RNa8H0l0YkTHa?key=0k4bj15m2-XSYnqO52VLa4p8" alt="" width="563"><figcaption><p>Picture 10. An example of using filters by lists</p></figcaption></figure>

For clients who are in the following condition: filter by funnel constructor blocks. To select blocks, put a tick.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdooQiGKS98m4oTuEC7xBCPZaSr8ptHzn_xRQAOKQhBbTkvLAXiu8RBht8SvBCCKgNF6GultZayO-74rrHI6K3pu_PRlseWMSTY9EB-PrLS02Yx3_mqE9S90HpFsMGMbgjGGjFpng?key=0k4bj15m2-XSYnqO52VLa4p8" alt="" width="563"><figcaption><p>Picture 11. Example of selecting block in a filter</p></figcaption></figure>

Connected messengers filter: clients of only the selected messenger will be included in the mailing.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcL4s2J4EMOfZHBxWeBWyPJQCx5g1dxZppMvzQuMgczGlI0n3hBOn34iK70rL6DmEu-SKZaJKwDW1s4VXeQCybalX97spwIdfTlQCuOF8450UMBm7P448xIugCHTo7-w4oMYcLwOA?key=0k4bj15m2-XSYnqO52VLa4p8" alt="" width="563"><figcaption><p>Picture 12. Messenger subscriber filter</p></figcaption></figure>

{% hint style="warning" %}
Please note!

If there is not a single client in the messenger, then it is NOT displayed in the "Filter by connected messengers".

If whatsapp bot has been recently connected and there are no clients in it, then it will NOT be displayed in the filter for connected messengers.
{% endhint %}

If there are two bots of the same type in the project, then you can choose which bot subscribers will receive mailing. The mailing will not be sent to clients who have not previously contacted selected bot.

Example: you have two Whatsapp bots connected in your project. All your clients are linked to bot A - they only communicated with him. Task: make a mailing from the number of bot B.

Acceptable solution: Channels section - whatsapp bot B - Download client list button - add a csv file with phone numbers.

Next, when creating a mailing list, you can use a Filter for connected messengers. Now there are clients in both bot A and bot B.

#### Add by variables/Exclude by variables: filter by the presence of a variable in the client

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXf0OoGKCZohWFo_qVgDu23hvEDwlMNS0GPERYb9oGxt13VbxuBSqSyS1t4pYKV17hLLcMtCFzGijN1jGbKue_GNXJcCztkY48YuLbiGTfohwYMAITJ2Jlzd6DnlEeTaxu_bWE0bng?key=0k4bj15m2-XSYnqO52VLa4p8" alt="" width="563"><figcaption><p>Picture 13. Filter by client variables</p></figcaption></figure>

Registered before / Registered after: date of creation filter, registration in the bot.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXek9UWUp9H9ApxfFnvJNID3BIHmFQTE4WcZkZptHgVQ1Lz0peI-IWU67Ik96n4Ft9VbiMVLE7KOOpwB9kIOlrFTRfAxazScMC5-hkEq5ePz1Xt0lE67qJ9YNIc6NlsrsDbCrZQ2fQ?key=0k4bj15m2-XSYnqO52VLa4p8" alt="" width="563"><figcaption><p>Picture 14. Filter by date of registration in the bot</p></figcaption></figure>

The creation date can be found in the dialogue with the client: section Clients - dialogue with the client - Variables - System variables.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXeTxkAH1z7-rXfa6BI2UnwhNGbDanOizWe-BrzkKLl6NnsihvbPVKYS6KPBcd9A_gDN1ocJU9a2hU2tzOFjrNJsILdTgGWJ7ShLLXTcsBgmt5JncQhb8C53AYr2GV69H61rMVmp3w?key=0k4bj15m2-XSYnqO52VLa4p8" alt="" width="375"><figcaption><p>Picture 15. The registration date example in the bot</p></figcaption></figure>

The "Registered before" filter does not include the selected date, but "Registered after" does.

### Upload from a file

To fine-tune the mailing list, you can upload a csv file with customer IDs in the first column.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdx5pfOAhrFZ3r5ZLZ4Z7CcbXaYUBvGDGZ5PvLvYWXoHDmat4bkov724vzVymHILW6miFBESPKsWBRSt7FIcOSheRZJVQA1J2Tzke21dUjicm1ytd-r-bxE27O_q8Ps-6rfijTHRQ?key=0k4bj15m2-XSYnqO52VLa4p8" alt=""><figcaption><p>Picture 16. Filter type: Upload from a file.</p></figcaption></figure>

You can upload a list of clients from one project to another as follows from the "Clients" section:

{% hint style="success" %}
This allows you to create a list of mailing list recipients from the list downloaded in the Clients section (it contains all recipient variables).
{% endhint %}

Step 1. Go to the clients section where you need to upload clients:

<figure><img src="/files/0vhLQ6jKYksFWWT8bGgW" alt="" width="563"><figcaption></figcaption></figure>

Step 2. Filter the clients by the required criteria and click on "Download":

<figure><img src="/files/mnh7TvTLl1iXm4U3igXp" alt="" width="563"><figcaption></figcaption></figure>

{% hint style="info" %}
For more information on how to filter clients, see the article "How to filter clients for mailing" — <mark style="color:red;">**вставить ссылку**</mark>
{% endhint %}

The uploaded client file is encoded in Windows or UTF-8 and separators: period, semicolon, or tab.

Step 3. Upload the list in the mailing list section:

<figure><img src="/files/kLq8NqkqOnvRtpJKkzNH" alt="" width="563"><figcaption></figcaption></figure>

For whatsapp mailing, simply upload a csv file with phone numbers in the first column.

If you have duplicates of clients in the file, the mailing will still be sent correctly. The client will receive one message. The total number of recipients will be shown in the mailing list settings in the Mailing List section.

### The "Message" tab

You can send a text with emoji in the message. It is possible to add [buttons](https://docs.salebot.pro/osnovnye-ponyatiya.-kak-sozdavat-botov-na-salebot.pro/knopki) and [attachments](https://docs.salebot.pro/osnovnye-ponyatiya.-kak-sozdavat-botov-na-salebot.pro/otpravka-vlozhenii-audio-video). For convenience, there are fields on the right: “Preview with buttons”, “Recalculate” recipients and “Test". — <mark style="color:red;">**вставить ссылки**</mark>

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXf0DgM5aQkuZCvtETwBTkjBLLLJB3gP2LHnyLqB9wcgigRyLEW7Tm-Xg-Iq5fGUTaEqBhNZ3yqd5cfmjcElu7aX07Q54Al3Sgun7AVVWdR0vknuwcoRmUgxn2iz-rxxuC1FERQ5GQ?key=0k4bj15m2-XSYnqO52VLa4p8" alt=""><figcaption><p>Picture 19. The "Message" tab</p></figcaption></figure>

During sending a mailing, you can upload multiple attachments at once

### "Sending" tab

You can schedule sending at a convenient time or send it immediately. Also, if the editing is not finished yet, you can save mailing as a draft.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXfRUwvAnANmnS3ZTbHkm5wI5SQtPJNKEdhzEpWFeGGedGOX90LiK1PdUbgteMPxqW-Bk8Ub273oRxe7vuk4nvD8fMfqUFd1bmcHhd9T_Dc59P6flXhVL8Ozf1D7hSwQY8yYotZ1XQ?key=0k4bj15m2-XSYnqO52VLa4p8" alt=""><figcaption><p>Picture 20. “Sending” tab</p></figcaption></figure>

If you need to split mailing into several parts, use the fields Offset relative to the first client and the number of clients to send

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXfm8PDhop88C103KvCmmgfX9ZNLxqfT571jws7B_ogNuOR8RGtZtFtN2JYSBFCnckAc-aa6U-ji_lV7TT5siEjX4yNy0kvflXd4v6oKXXylOHn-NYJq5mpcdgbVWUoqA__l-bOvWw?key=0k4bj15m2-XSYnqO52VLa4p8" alt="" width="563"><figcaption><p>Picture 21. Divide mailing into several parts</p></figcaption></figure>

For example, you have 1000 clients and you want to send a message to 200 clients today and 800 to the remaining ones tomorrow. To do this, put 0 in the "Offset relative to the first client" field, and 200 in the "Number of clients to send" field. The next day, you put 200 in the first field, 800 in the second.

After creating a mailing list, tasks for sending messages are immediately planned. This allows you to track the result of sending messages. After creating a mailing list, you can see the number of unsent messages.

#### Important points:

1. The mailing list messages will not be lost under any circumstances.
2. Until the message is not sent, the sending task will not be deleted.
3. If the bot has any problems, the message will not disappear. It will be sent when the problems are fixed.
4. The speed of sending text messages in the mailing list is above 10 messages per second.
5. If mailing is sent from the block and it is necessary to perform certain logic during sending a message, then the speed slows down.
6. If the clients are duplicated in the file, the client will be added to the mailing only once.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.mavibot.ai/mailings/messenger-broadcasts.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
