> For the complete documentation index, see [llms.txt](https://doc.nextbot.ru/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.nextbot.ru/functional/integrations/max/osobennosti-ogranicheniya-i-blokirovki-max.md). # Особенности, ограничения и блокировки MAX В этой статье собраны ответы на частые вопросы о работе с `MAX`: настройки приватности, поиск аккаунта по номеру, регистрация по иностранным номерам, временные ограничения и причины блокировок. Соблюдать правила MAX важно до подключения канала к Nextbot и особенно перед массовыми рассылками. Мессенджер может ограничить аккаунт из-за жалоб пользователей, однотипных сообщений, частых проверок номеров, отправки на неактивные номера или признаков автоматизации. {% hint style="warning" %} Ограничения и блокировки накладывает сам мессенджер MAX. Nextbot отображает доступную информацию о состоянии подключения, но не может снять ограничения с аккаунта. {% endhint %} ## Кратко * **Что означает `Временные ограничения`?** Это временное ограничение аккаунта. Обычно в этот период нельзя писать и звонить пользователям, которые не сохранили ваш номер в контакты. * **Почему опасны массовые рассылки?** Большое количество одинаковых сообщений за короткое время похоже на автоматизацию и может привести к ограничениям. Не забывайте увеличивать длительность задержки. * **Зачем "прогревать" номер?** Новый номер наиболее уязвим к блокировкам. Перед активной отправкой сообщений его нужно постепенно вводить в работу. * **Почему важны контакты и ответы клиентов?** Риск блокировки ниже, если клиенты добавили ваш номер в контакты, пишут первыми или отвечают на сообщения. ## Ограничения и блокировки
Какие типы блокировки может наложить MAX? Мессенджер **MAX** применяет автоматические и ручные меры защиты от нежелательных сообщений. Если аккаунт начинает подозрительно себя вести, или на него поступают жалобы, система может наложить на него ограничения. Основные типы ограничений, с которыми могут столкнуться пользователи: 1. **Временные ограничения на аккаунте** 2. **Полная блокировка аккаунта** 3. **Перманентная блокировка аккаунта** ### Временные ограничения на аккаунте Это начальная стадия блокировок, когда MAX обнаруживает на аккаунте подозрительную активность. * Вы не сможете писать тем, кто не сохранил ваш номер в контакты, * Вы не сможете звонить тем, кто не сохранил ваш номер в контакты, * Если незнакомый пользователь напишет вам первым, то вы сможете ответить. Ограничения имеют временный характер и через некоторое время снимаются с аккаунта автоматически. В API мессенджера MAX для отображения временных ограничений существует статус **«Временные ограничения»**. Более подробно о статусе читайте в статье «Что означает статус Временные ограничения у аккаунта MAX?». ### Блокировка аккаунта Это полноценная блокировка, запрещающая использование аккаунта MAX. При её получении: 1. Приложение сбрасывает авторизацию аккаунта, 2. При попытке войти снова позволяет ввести номер телефона, 3. СМС с кодом приходит, однако при вводе кода возникает сообщение **«Данный аккаунт заблокирован или удален»**. ### Перманентная блокировка аккаунта В отличие от других мессенджеров, в **MAX** аккаунты, помеченные как мошеннические, получают пожизненную блокировку. Используемые номера телефонов вносятся во внутреннюю базу данных мессенджера MAX, и чаще всего аккаунты удаляются без возможности восстановления, даже через службу поддержки. > В редких случаях при обращении в техническую поддержку есть вероятность разблокировать ранее заблокированный аккаунт.
Что означает статус Временные ограничения у аккаунта MAX? Статус **«Временные ограничения»** на инстансе информирует вас о применении временных ограничений на аккаунт со стороны мессенджера MAX. Это начальная стадия блокировки аккаунта MAX. ### Как узнать о появлении статуса Временные ограничения на аккаунте * MAX бот присылает уведомление о том, что на аккаунт наложены ограничения. * Ответ метода `getStateInstance` приходит со статусом **«Временные ограничения»**. * При вызове метода `getAccountSettings` отображается срок действия ограничений в формате `unix time`. Timestamp указывает, до какого времени введены ограничения. * Сообщения клиентам, с которыми не было переписки, доставляются с ошибкой. * Нельзя добавить контакты в приложении MAX. * Нельзя звонить тем, кто не сохранил ваш номер в контакты. ### Как смягчить последствия ограничений * Временно не пишите первыми клиентам, которых не добавляли в контакты. * Для добавления новых контактов используйте телефонную книгу. После синхронизации мессенджера MAX с телефонной книгой все новые контакты будут добавлены в контакты приложения MAX.
За что аккаунт MAX может получить блокировку? ### 1. Жалобы от пользователей Если получатели отмечают ваши сообщения как **нежелательные**, система автоматически ограничивает аккаунт. Особенно это касается рассылок незнакомым людям без их согласия. Повторные жалобы могут привести к более длительным или даже постоянным ограничениям. *** ### 2. Массовые рассылки и спам Отправка большого количества одинаковых сообщений за короткий промежуток времени также может привести к ограничениям на аккаунте. Использование скриптов, ботов или сторонних приложений для массовой отправки сообщений, а также ненормально высокая скорость отправки или частые повторные действия, в большинстве мессенджеров воспринимаются как автоматизация, что повышает риск получения ограничений. *** ### 3. Частые проверки номеров через CheckAccount Система фиксирует, если часто отправляются запросы на проверку существования аккаунта по номеру телефона. Особенно это подозрительно, когда многократно проверяется один и тот же номер, которого не существует. В результате мессенджер может наложить временные ограничения. Проще говоря, не стоит использовать `CheckAccount` как массовую проверку базы номеров. *** ### 4. Сообщения на несуществующие или неактивные номера Многократные попытки отправлять сообщения на номера, к которым не привязан аккаунт MAX, также выглядят как подозрительная активность. *** ### 5. Частые попытки связать устройство Многократные попытки авторизовать инстанс или связать иное устройство приводят к временному ограничению подключения новых устройств. Если продолжить попытки авторизации после получения ошибки `rate_limit_exceeded`, аккаунт может получить блокировку со стороны MAX. *** ## Как избежать ограничений? 1. Отправляйте сообщения **только знакомым пользователям**, которые сохранили ваш номер. 2. Не используйте аккаунт для массовых рассылок без согласия получателей. 3. Проверяйте существование аккаунта через `CheckAccount` только один раз, а не многократно. 4. Избегайте отправки сообщений на несуществующие номера. 5. Не злоупотребляйте автоматизацией и сторонними скриптами.
Как снизить риск блокировки MAX? Блокировка учетной записи осуществляется самим мессенджером MAX — сторонние сервисы на этот процесс повлиять не могут. Причинами для ограничений могут стать: * признаки автоматизации (отправка сообщений без задержек), * жалобы пользователей, * низкий коэффициент ответов (соотношение исходящих и входящих сообщений), * агрессивный характер рассылки. Чтобы минимизировать риски, необходимо учитывать несколько ключевых параметров: 1. Возраст номера (прогрев номера) 2. Проверка номера получателя 3. Отправка по идентификатору пользователя 4. Коэффициент ответов 5. Согласие на получение сообщений 6. Обращение по имени 7. Короткие сообщения 8. Настройка инстанса 9. Добавление в контакты ### 1. Возраст номера (прогрев номера) Чем дольше номер зарегистрирован в MAX, тем он более устойчив к блокировке. Если вы только что зарегистрировали новый номер, то он наиболее уязвим к блокировке. Новый номер обязательно необходимо прогревать не менее 10 дней. Рекомендуем начинать прогрев на следующие сутки после создания аккаунта MAX. **Последовательность прогрева номера:** 1. Для снижения риска бана мы рекомендуем сделать паузу в 24 часа между регистрацией нового аккаунта MAX на телефоне и моментом сканирования QR-кода в веб-клиенте MAX или в личном кабинете. 2. Со второго по четвёртый день: номер получает входящие сообщения с других аккаунтов, каждые 2 часа по одному сообщению. 3. На четвёртый день: номер начинает писать в ответ, так же по одному сообщению каждые 2 часа (на номера, которые есть в контактах). 4. В течение 7 дней постепенно увеличивайте поток сообщений с 12 до 100. 5. После 10 дней номер гораздо более устойчив к банам. По нашим наблюдениям MAX дает номерам зеленый свет после 25-30 дней, если на них нет подозрительной активности. **Важно!** Если номер получил блокировку, то его прогрев **обнуляется**, и его необходимо начинать с начала. ### 2. Проверка номера получателя При частом вызове метода `checkAccount` также есть риск получения ограничений со стороны MAX. Проверяйте номер один раз, сохраняйте полученный `chatId` и не повторяйте проверку без необходимости. Рекомендуемые решения: * После запроса `checkAccount` отправлять сообщение, чтобы шла череда проверки/отправки. * Если при проверке номера методом `checkAccount` ответ `"exist": false`, не вызывайте метод на этот номер повторно. * Использовать встроенную проверку на наличие аккаунта при отправке сообщения. Если на номере получателя нет аккаунта MAX, то возвращается уведомление со статусом `noAccount`. Уведомление со статусом `noAccount` будет приходить даже при отключенной настройке `outgoingWebhook` (в личном кабинете это параметр `Получать уведомления о статусах отправленных сообщений`). ### 3. Отправка по идентификатору пользователя Рекомендуется отправлять сообщения по идентификатору чата `chatId`. * Если идентификатор чата известен, то используйте его в методах отправки сообщений `SendMessage` и др. * Если идентификатор чата неизвестен, то сначала используйте метод `CheckAccount`, получите значение `chatId`, и далее используйте `chatId` в методах отправки сообщений `SendMessage` и др. ### 4. Коэффициент ответов (соотношение отправленных и полученных сообщений) Идеальным является случай, когда клиенты пишут вам первыми и добавляют вас в контакты. Однако в большинстве случаев не получается добиться такого сценария. Часто требуется начинать диалог первым. Если вы много отправляете сообщений и в ответ не получаете ни одного ответа, то вы рискуете получить бан. Стремитесь к тому, чтобы не менее 50% клиентов отвечали на ваши сообщения. ### 5. Согласие на получение сообщений У получателя всегда сохраняется возможность заблокировать ваш номер в случае навязчивых сообщений. Однако запрос согласия на получение сообщений от вас в первом сообщении будет явной установкой границ вашего клиента. Альтернативным вариантом является добавление в конце рассылки фразы *«Напишите stop, чтобы отказаться от дальнейших сообщений»*, что значительно упрощает пользователю отказ от рассылки. Это снижает вероятность жалоб через MAX, способствует более корректной фильтрации аудитории, а также позволяет сохранить работоспособность вашего номера. Дополнительно такая практика может положительно повлиять на коэффициент ответов. ### 6. Обращение по имени Первый контакт с клиентом очень важен. Обращение по имени повышает вероятность получения ответа и делает сообщение более персонализированным. Обращение также делает каждое сообщение уникальным, что положительным образом сказывается на устойчивости номера от блокировки. ### 7. Короткие сообщения Вместо одного громоздкого сообщения отправляйте несколько маленьких сообщений. Такой стиль более похож на реальное общение, чем на автоматизированную рассылку. ### 8. Настройка инстанса Частая отправка сообщений с номера может стать признаком автоматизации. Для более «живой» переписки установите интервал отправки сообщений из очереди в личном кабинете или через метод `SetSettings` до `15000`. ### 9. Добавление в контакты Рассылайте сообщения только тем клиентам, которые добавили ваш номер в список контактов. Риск блокировки номера значительно снижается в случае, если вы отправляете сообщения клиентам, которые добавили ваш номер себе в контакты. *** ## Сценарии по степени риска блокировки **(идеально) Вас никогда не забанят:** * клиенты пишут первыми, * клиенты добавляют ваш номер в контакты, * клиенты могут написать `stop`, чтобы отписаться, **(рекомендуется) Минимальный риск блокировки:** * вы пишете первыми, постепенно наращивая базу клиентов на номере, * при первом контакте с клиентом запрашиваете разрешение на отправку сообщений, * обращаетесь к клиенту по имени, персонализировано, * на 100 отправленных сообщений вы получаете не менее 50 входящих сообщений от клиентов, * клиенты всегда могут написать `stop`, чтобы отписаться. **(не рекомендуется) Максимальный риск блокировки:** * номер зарегистрирован менее 10 дней назад, * вы пишете первым, * сообщения однотипные, без персонализации, * большое количество получателей, * ответов от клиентов нет, * отправляете рекламу, в которой клиент не заинтересован (спам).
## Особенности MAX
Что такое Безопасный режим в MAX? **Безопасный режим** — это специальный набор настроек приватности, который помогает защитить ваш аккаунт и ограничить нежелательные контакты. При активации режима автоматически применяются следующие параметры: * Приём звонков **только от номеров из вашей телефонной книги**. * Приглашения в чаты **только от знакомых**. * Установка **ПИН-кода** для изменения настроек приватности. Таким образом, связаться с вами смогут только те люди, у кого ваш номер сохранён, и чьи контакты синхронизированы в MAX. ### Для чего нужен Безопасный режим? Безопасный режим создан для тех, кто хочет максимально защитить себя от нежелательных звонков, сообщений и приглашений. Он особенно полезен: * Если ваш номер попал в спам-рассылки, * Если вы не хотите, чтобы с вами связывались незнакомые люди, * Если вы используете номер для работы и важно сохранить конфиденциальность. ### Как включить Безопасный режим? Чтобы активировать режим на мобильном устройстве: 1. Перейдите в **Настройки -> Приватность**. 2. Нажмите на переключатель напротив пункта **Безопасный режим**. 3. Выберите **Установить ПИН-код**. 4. Введите и подтвердите ПИН-код. После активации: * Все изменения приватности будут защищены ПИН-кодом. * Отключить или изменить Безопасный режим можно будет только с его помощью. ### Как отключить Безопасный режим? 1. Откройте **Настройки -> Приватность**. 2. Нажмите на переключатель напротив **Безопасного режима**. 3. Подтвердите действие с помощью ранее установленного ПИН-кода. После отключения вы снова сможете вручную изменять параметры приватности.
Как ограничить поиск моего аккаунта по номеру телефона? По умолчанию другие пользователи **MAX** могут найти ваш аккаунт по номеру телефона, если он сохранён в их контактах. Если вы хотите скрыть свой профиль от поиска по номеру, в приложении доступна специальная настройка. ### Что даёт ограничение поиска? * Ваш аккаунт не будет отображаться в результатах поиска по номеру телефона. * Найти вас смогут только те люди, у которых вы уже есть в контактах. * Дополнительный уровень приватности: вы сами решаете, кто может выйти с вами на связь. ### Для чего это нужно? * Если вы хотите использовать **MAX** только для общения с близкими и знакомыми. * Если не хотите, чтобы ваш номер можно было найти случайным образом. * Если используете один и тот же номер для рабочих и личных целей и хотите отделить контакты. ### Как включить ограничение поиска по номеру? 1. Откройте **Настройки -> Приватность**. 2. Найдите пункт **Кто может найти меня по номеру телефона**. 3. Выберите один из вариантов: * **Все** — аккаунт доступен для поиска любым пользователям; * **Мои контакты** — только люди из вашей телефонной книги смогут вас найти; * **Никто** — поиск по номеру телефона полностью отключён.
Проверка и хранение идентификаторов пользователей в MAX В системе **MAX** отправка сообщений производится по идентификатору чата (`chatId`). Особенности идентификатора в **MAX**: * `chatId` формируется в момент создания аккаунта. * `chatId` является уникальным и постоянным для всего времени жизни аккаунта. * `chatId` перестаёт быть актуальным в момент удаления аккаунта. Это значит, что после его получения можно использовать сохранённое значение для отправки сообщений без необходимости постоянно его проверять. При отправке сообщения на несуществующий `chatId` система вернёт ошибку `noAccount` во входящем вебхуке. В такой ситуации необходимо повторно выполнить метод `CheckAccount` для получения актуального `chatId`. Таким образом, безопасная стратегия работы выглядит так: 1. Один раз получить `chatId` методом `CheckAccount`. 2. Сохранить `chatId` в базе данных и использовать его для отправки сообщений. 3. Обрабатывать ошибку `noAccount`: если она пришла, повторно вызвать метод `CheckAccount`, чтобы обновить `chatId` в базе данных. Такое поведение системы предотвращает нежелательную отправку сообщений посторонним получателям. > Например, если номер телефона перешёл от одного человека к другому, старый `chatId` становится неактуальным и сообщения не попадут новому владельцу.
Регистрация в MAX, если номер не из РФ или РБ ### Как зарегистрироваться в MAX по иностранному номеру? Вы можете зарегистрироваться в MAX по номеру телефона из следующих стран: Азербайджана, Армении, Афганистана, Беларуси, Боливии, Венесуэлы, Вьетнама, Гамбии, Гренады, Грузии, ДР Конго, Индии, Индонезии, Ирака, Казахстана, Камбоджи, Катара, Колумбии, Кубы, Кувейта, Кыргызстана, Лаоса, Ливана, Малайзии, Молдовы, Мьянмы, Никарагуа, ОАЭ, Пакистана, Палау, Республики Конго, Российской Федерации, Саудовской Аравии, Сент-Китса и Невиса, Таджикистана, Таиланда, Танзании, Туркменистана, Турции, Узбекистана. ### Особенности работы в некоторых регионах В некоторых случаях часть функций может быть недоступна из-за особенностей работы MAX в вашем регионе. Доступно: * Писать и звонить пользователям, которые добавили вас в контакты или написали первыми; * Принимать сообщения и звонки от любых людей; * Вступать в групповые чаты, если вас пригласил другой пользователь; * Добавлять в групповые чаты тех, кто добавил вас в контакты. Не получится: * Начать чат с пользователями, которые не добавили вас в контакты; * Позвонить тем, кто не добавил вас в список контактов; * Добавиться в групповой чат по ссылке; * Пригласить пользователей в групповой чат, если они не добавили вас в контакты; * Создать приватный канал. > Обратите внимание! Эти ограничения не влияют на возможность общения с теми, у кого вы уже добавлены в список контактов.
## Материалы GREEN-API Дополнительно можно изучить исходные статьи GREEN-API: * [Полная документация по работе с мессенджером MAX](https://green-api.com/v3/docs/faq/) * [Что такое Безопасный режим в MAX?](https://green-api.com/v3/docs/faq/what-is-safe-mode-in-max/) * [Как ограничить поиск моего аккаунта по номеру телефона?](https://green-api.com/v3/docs/faq/disable-account-search-by-phone-number/) * [Проверка и хранение идентификаторов пользователей в MAX](https://green-api.com/v3/docs/faq/identifier-in-max/) * [Регистрация в MAX, если номер не из РФ или РБ](https://green-api.com/v3/docs/faq/registration-if-number-not-from-rf-rb/) * [Какие типы блокировки может наложить MAX?](https://green-api.com/v3/docs/faq/what-types-of-blocking-can-max-impose/) * [Что означает статус Временные ограничения у вашего аккаунта?](https://green-api.com/v3/docs/faq/what-is-meaning-status-suspended/) * [За что аккаунт MAX может получить блокировку?](https://green-api.com/v3/docs/faq/reasons-for-blocking-MAX-account/) * [Как снизить риск блокировки MAX?](https://green-api.com/v3/docs/faq/how-to-reduce-risk-of-blocking/) --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## 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, and the optional `goal` query parameter: ``` GET https://doc.nextbot.ru/functional/integrations/max/osobennosti-ogranicheniya-i-blokirovki-max.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.