# МАХ Bot

#### Важные нюансы перед запуском

1. **Первое сообщение**\
   Отправить первое сообщение с MAX-бота нельзя. Диалог начинается только после сообщения клиента.\
   Клиент нажимает кнопку начала общения (даёт согласие на получение сообщений) и отправляет сообщение.
2. **Регистрация и модерация бота**\
   Регистрация, верификация и модерация бота выполняются на стороне MAX.\
   Сроки зависят от MAX и обычно составляют до **48 часов в рабочие дни**.
3. **Ограничения по количеству ботов**\
   В MAX действует ограничение — **не более 5 ботов на одну организацию**.
4. **Токен бота**\
   Токен — это ключ доступа к боту.\
   Его нельзя передавать третьим лицам или хранить в открытом виде.\
   Если токен был обновлён на стороне MAX, его необходимо заменить в Radist.Online, иначе отправка и приём сообщений будут остановлены.
5. **Доступ к платформе MAX**\
   Подключение к платформе MAX и её сервисам (чат-боты, мини-приложения, каналы) доступно не всем.\
   На данный момент подключение возможно только для юридических лиц и ИП, которые:
   * разместили приложение в **RuStore**;
   * зарегистрированы на **МСП.РФ**.

***

## Функционал подключения

#### Поддерживаемые типы сообщений 

<figure><img src="https://2086500725-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MXlY6zVfZf9OqBmsNV0%2Fuploads%2FElfBcV4jCcMgpcEgfYEL%2FScreenshot%202025-12-26%20at%2015.40.30.png?alt=media&#x26;token=c07b5cfb-5b06-43ad-ae73-ecdb0634cca1" alt=""><figcaption></figcaption></figure>

Поддерживается отправка и приём следующих типов сообщений:

* текстовые сообщения;
* голосовые сообщения;
* медиафайлы;
* документы;
* смайлики.

Поддерживается отправка **документов с подписью** — например, шаблонов, содержащих текст и прикреплённый файл.&#x20;

{% hint style="warning" %}
В боте МАХ через контакт передаётся только информация об имени контакта и МАХ user ID (отображается исключительно в шапке чата). Номер телефона не передаётся.
{% endhint %}

***

### Ограничения МАХ bot:

• В боте МАХ через контакт передаётся только информация об имени контакта и МАХ user ID (отображается исключительно в шапке чата). Номер телефона не передаётся.

• Нельзя начинать чат с клиентом через МАХ бот. \
Диалог начинается только после сообщения клиента.

***

### Черный список:&#x20;

В карточках подключений МАХ Bot отображается кнопка для раскрытия подробной информации. Эта кнопка видна всем сотрудникам, имевшим доступ к разделу «Подключения»:&#x20;

<figure><img src="https://2086500725-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MXlY6zVfZf9OqBmsNV0%2Fuploads%2FjFpMo86WBR9LtKqUOeYC%2FScreenshot%202025-12-26%20at%2015-51-03.png?alt=media&#x26;token=5e8858d6-8c28-4d16-b310-871ae3681c2f" alt=""><figcaption></figcaption></figure>

> Настроить права доступа можно в личном кабинете RadistWeb в разделе - Настройки - Сотрудники: "[Доступные права у ролей](https://docs.radist.online/radist.online-docs/nashi-produkty/radist-web/polzovateli#dostupnye-prava-u-rolei)"

{% hint style="info" %}
❗️Обратите внимание: через подключение МАХ бот можно просматривать только список заблокированных чатов и разблокировать отдельные чаты. Блокировка осуществляется в разделе «Чаты» — через действие «Заблокировать» в конкретном чате.\
\
Подробнее как это сделать можно посмотреть [тут](https://docs.radist.online/radist.online-docs/nashi-produkty/radist-web/chaty).
{% endhint %}

Если у сотрудника есть только право на просмотр, при раскрытии карточки подключения он сможет видеть только имена контактов заблокированных чатов:

<figure><img src="https://2086500725-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MXlY6zVfZf9OqBmsNV0%2Fuploads%2F51SamTCE9K2L8YPLMjDK%2FScreenshot%202025-04-22%20at%2012.28.01.png?alt=media&#x26;token=74295be4-4977-471d-95b1-a0f3c1220a15" alt=""><figcaption></figcaption></figure>

Если же у сотрудника есть право «Подключения — Редактирование», ему также станут доступны кнопки «Разблокировать» рядом с каждым именем контакта:

<figure><img src="https://2086500725-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MXlY6zVfZf9OqBmsNV0%2Fuploads%2F4odHgE1MpRt1NCudzD3J%2FScreenshot%202025-04-22%20at%2012.28.32.png?alt=media&#x26;token=cb63400b-38d1-4261-ac80-1b70648b2ff0" alt=""><figcaption></figcaption></figure>

При успешной разблокировке появляется уведомление о выполненной операции, сообщающее, что изменения вступят в силу в течение 15 минут:

<figure><img src="https://2086500725-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MXlY6zVfZf9OqBmsNV0%2Fuploads%2FX2q7M7YPrNZAXCYdbOqF%2FScreenshot%202025-04-22%20at%2012.20.18.png?alt=media&#x26;token=64892e7e-5e9c-4141-a8df-9ab086c03136" alt=""><figcaption></figcaption></figure>

## **ID компании**

При обращении вашего сотрудника по вопросам работы интеграции в тех.поддержку, он должен указать ID компании из ЛК.

Это нужно для соблюдения конфиденциальности, чтобы мы были уверены, что это сотрудник вашей компании. В противном случае, в тех.поддержке может быть отказано до момента подтверждения участия сотрудника вами.  Где взять ID, указано на скриншоте ниже.&#x20;

<figure><img src="https://2086500725-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MXlY6zVfZf9OqBmsNV0%2Fuploads%2FOBvQ5gz9MvybIx6AgPBG%2FScreenshot%202025-12-26%20at%2015-58-32.png?alt=media&#x26;token=845c291b-f776-4b68-ac20-b960a6b8ca91" alt=""><figcaption></figcaption></figure>