# Чат-бот MAX

{% hint style="warning" %}
Обращаем внимание!

В мессенджере запрещены рассылки и сообщения по таймеру. Ограничение «24-часового окна» для отправки сообщений не применяется. При этом соблюдение пункта 1.5 пользовательского соглашения MAX остаётся на вашей стороне.

[См. пункт 1.5 Правил MAX.](https://dev.max.ru/docs/legal/requirements)

Спасибо за понимание!
{% endhint %}

{% hint style="info" %}
При настройке кнопок для чат-бота в одной строке может быть максимум 7 кнопок.
{% endhint %}

## Создание бота

Чат-боты умеют решать типовые задачи прямо в MAX. Создайте бота, который будет делать что-то за вас.

Даже без навыков программирования сделать своего бота в приложении просто — придумайте сценарий и следуйте пошаговой инструкции. 

## Как получить токен бота

{% hint style="success" %}
Обращаем внимание!

**Создание чат-бота в MAX доступно для ю/л и ИП.**
{% endhint %}

**Шаг 1. Перейдите во вкладку Каналы в Salebot.**

Чтобы перейти на страницу регистрации в мессенджере, войдите в личный кабинет Сейлбот и выберите проект, в котором нужно подключить чат-бота MAX.

Затем в проекте перейдите во вкладку "Каналы" и нажмите на кнопку MAX:

<figure><img src="https://4216716816-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LxKl4rC_EcwBAz40Qn_%2Fuploads%2FZJtNsew661SBlEPukwBD%2F%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202026-02-04%20%D0%B2%2014.37.29.png?alt=media&#x26;token=68daf14a-8f2d-4c05-b3a6-fcd93a00e1dc" alt=""><figcaption></figcaption></figure>

При клике по кнопке подключения мессенджера откроется форма, где можно найти кнопку для регистрации в мессенджере для компаний (ю/л и ИП):

<figure><img src="https://4216716816-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LxKl4rC_EcwBAz40Qn_%2Fuploads%2F74fZOZ7Xf0DGc5psUakj%2F%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202026-02-04%20%D0%B2%2014.40.47.png?alt=media&#x26;token=0adc53ee-7c6d-46cf-b0b5-c3905c1f6acb" alt=""><figcaption></figcaption></figure>

**Шаг 2. Создайте бота**

{% hint style="info" %}
Если вы уже создали бота на платформе  и он прошёл проверку, перейдите к разделу "[Подключение мессенджера](#podklyuchenie-messendzhera)" ниже.
{% endhint %}

<figure><img src="https://4216716816-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LxKl4rC_EcwBAz40Qn_%2Fuploads%2Fm9Q2EXLodHmlJTMqzneQ%2F%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202025-10-29%20%D0%B2%2014.53.01.png?alt=media&#x26;token=48c0a8f1-c811-4b0f-85fa-e7d50132fc32" alt=""><figcaption></figcaption></figure>

Чтобы подключить инструменты коммуникации с клиентами в MAX, вам нужно:

1. Пройти регистрацию по номеру телефона на платформе MAX для партнеров;
2. Ввести данные своей организации, чтобы создать Личный Кабинет;
3. В ЛК пройти верификацию организации (через Госуслуги или Банки-провайдеры).

**Шаг 3. Скопируйте токен из настроек бота**

Для этого:

1. Перейдите на платформу и авторизуйтесь.
2. Если у вас несколько ботов, в левом верхнем углу выберите нужный.
3. В разделе Чат-бот и мини-приложение нажмите Настроить.

<figure><img src="https://4216716816-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LxKl4rC_EcwBAz40Qn_%2Fuploads%2FiRPReWdRYeB2GstSfmaa%2F%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202025-10-29%20%D0%B2%2014.40.04.png?alt=media&#x26;token=9eb5f8b9-d395-422e-9236-bbd965b7cf22" alt="" width="375"><figcaption></figcaption></figure>

**Шаг 4. Скопируйте токен:**

<figure><img src="https://4216716816-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LxKl4rC_EcwBAz40Qn_%2Fuploads%2FzA3H0KWN9ml8Bx26aXyT%2F%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202025-10-29%20%D0%B2%2014.40.10.png?alt=media&#x26;token=b3519a50-6c18-4bc7-a7c3-26689336bb6c" alt="" width="563"><figcaption></figcaption></figure>

Теперь можно подключать мессенджер к Сейлбот.

## Подключение мессенджера

После того как вы создали бота в мессенджере, необходимо перейти в раздел "Каналы" в Сейлбот:

<figure><img src="https://4216716816-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LxKl4rC_EcwBAz40Qn_%2Fuploads%2FOY6MHDbuAZRDfuh4V7Or%2F%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202025-03-26%20%D0%B2%2017.43.10.png?alt=media&#x26;token=36daee05-7691-47d4-8ea2-2c6b195444a1" alt="" width="327"><figcaption></figcaption></figure>

В разделе каналы нажимаем на “MAX” для ввода токена, который вы скопировали ранее при создании бота:

<figure><img src="https://4216716816-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LxKl4rC_EcwBAz40Qn_%2Fuploads%2F5j04KyPFsdwNgHNStlgm%2F%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202025-10-29%20%D0%B2%2014.49.08.png?alt=media&#x26;token=f5bea8ba-2c0e-45f5-9505-91ce7f63108f" alt=""><figcaption></figcaption></figure>

Вставьте скопированный токен и нажмите на “Готово”:

<figure><img src="https://4216716816-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LxKl4rC_EcwBAz40Qn_%2Fuploads%2FqMCZfVOrOclc9ZfQPT5g%2F%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202025-03-26%20%D0%B2%2017.39.30.png?alt=media&#x26;token=5880c905-fca0-47cf-8c19-5e41164f939f" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
Готово! Бот подключен
{% endhint %}

При запуске бота, в диалоге с клиентом появится сообщение /start&#x20;

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcSUnHPFsQZwkZ8Es4f4Vr4Y-FPFNp1QvSEm9grsfWdZm7bPOA9Uxa-V0G-VYe-UhMULsB_ryMXzW1BTDqwcQ2IdJIwo-xrU2oG6veJrG8dFxDMrvmlWKjDbg0_yN-nacwGaGPM4Q?key=lOib_VIcXHaMAcJLN34KW0zJ" alt=""><figcaption></figcaption></figure>

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXc5lbrI_Obv31boqxI_3Uy8rFPSQ1dGzp6z6sK_YyvaVV6DoHuL4J5efIInLkFDUEQuf6i3Z-epXgO_bHUihWseodF6nw3br5Tw2j_rIUPDHlEbmPVS7yUGduhfG52NJT6dhuO5bg?key=lOib_VIcXHaMAcJLN34KW0zJ" alt=""><figcaption></figcaption></figure>

## Как получить полный вебхук

Для получения полного вебхука от Max достаточно присвоить любое значение переменной  save\_webhook(переменная может быть как константой проекта, так и переменной сделки).

При этом ответ из мессенджера будет записываться в переменную tt\_request, которую вы найдете в карточке клиента среди переменных сделки

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXfkxBmjNp7B04tzU3usUJQdbLHaUVQb4zgmO9wG67avS7Z3sfVfSIPLt4BW216hNA9TFAF3uCMZL0yaItSClObKS0TE3cXwHw5c-4l87lQOC9bBkYQzO1ZzbQnmRUvQkJ52p7hjhg?key=lOib_VIcXHaMAcJLN34KW0zJ" alt=""><figcaption></figcaption></figure>

Max поддерживает кнопки callback, кнопки с ссылкой, запрос номера телефона, запрос геолокации

Если клиент нажмет на кнопку с запросом номера и даст разрешение, в чат поступит сообщение с его номером телефона и появится переменная phone

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXf8hqPt54QLddtsoPBV_7MMIJ692rZKtitBdtDOYdtS4_zcZAfIF1cUR3dEqAzIu-wz_ylxA5csjPZ0iviryykp6Aehh4QwCh70lAShabaQGsBhiZSVQjzs8FABCI-Ufh4-LNnahA?key=lOib_VIcXHaMAcJLN34KW0zJ" alt=""><figcaption></figcaption></figure>

Если клиент поделится своей геолокацией, данные поступят в виде сообщения, и будут созданы переменные latitude и longitude

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdqY5OvrFwuivc-KzKohVVqf0W0ZCf4MLCd6iOFnkPwB_eLJ887PK_Kcet6H1CaG3Uh6yDUJLkicvmz5wm35yi5jzSfKnJ6hR9zyrgEk_7WE5_MqYGgj1yppXPnRQG7pVHDMFAK-w?key=lOib_VIcXHaMAcJLN34KW0zJ" alt=""><figcaption></figcaption></figure>

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcYdlcImfwnNhYKZqHdx3MP0U9RbNZeXPPHbelHTc-AC4rWJBjRmO2TKCZ64oNshE5xHnvqHyjftAYT-mgT7aapd5YD2mrmwzZS765W7DX3uUyu_s1SIqRZTValGbDuifcRpfUE5Q?key=lOib_VIcXHaMAcJLN34KW0zJ" alt=""><figcaption></figcaption></figure>

## Inline-клавиатура

Такая клавиатура может иметь до 210 кнопок, сгруппированных в 30 рядов — до 7 кнопок в каждом. Если ряды кнопок не помещаются в плейсхолдер клавиатуры, автоматически подключается скролл

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdOvlu3Pf5fE3kBIxON37cXuey0fmeh9X4DW7Elvs44dc3jtroJ-rQjaGtNAScvF4T81KnWGSSapshEoqxZt5WjidQmA1O5_Folelg2-mabcYXPoVULb7c66A9yz8iLMAZbp4Vusw?key=TskrhZ7SwgOwOYQNjojb7VKN" alt=""><figcaption><p>Inline-клавиатура в чат-боте</p></figcaption></figure>

Поддерживаемые типы кнопок

* callback — сервер MAX отправляет событие с типом message\_callback (через Webhook или Long polling)
* link — позволяет пользователю открыть ссылку в новой вкладке
* request\_contact — запрашивает у пользователя разрешение на доступ к контактам — нику или телефону
* request\_geo\_location — запрашивает у пользователя его местоположение

## Доступные коллбеки

bot\_added -  подключенный бот добавлен в групповой чат/канал

bot\_removed - подключенный бот удален из группового чата/канала

user\_added - в групповой чат добавлен новый участник/другой бот

user\_removed  - из группового чата удален участник/другой бот

При срабатывании коллбеков на добавление/удаление участников, создаются переменные клиента

chat\_member\_name - имя пользователя

chat\_member\_username - ник пользователя (если установлен)

chat\_member\_id - id пользователя

Чтобы писать сообщения от имени бота, а также видеть сообщения других участников в групповом чате/канале, бота нужно назначить администратором и дать соответствующие разрешения&#x20;

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcayIDrqacWVl_jDsnno0J51KkSGhOeI2VidLf1g2mo5SZjCN1raRljOcxcU9Vn4kBZ1CI4q7m70yPylwBTfwOOO_Rcif0D7vrz8EoMHzse2fPFaqCuTBNj6o8ahcq_DVknscWnqQ?key=lOib_VIcXHaMAcJLN34KW0zJ" alt=""><figcaption></figcaption></figure>

## Форматирование сообщений <a href="#formatirovanie-soobshenii" id="formatirovanie-soobshenii"></a>

#### Markdown <a href="#markdown" id="markdown"></a>

\*Курсив\* или \_курсив\_

\*\*Жирный\*\* или \_\_Жирный\_\_

\~\~Зачеркнутый\~\~

++Подчеркнутый++

\`Моноширинный\`

<figure><img src="https://docs.salebot.pro/~gitbook/image?url=https%3A%2F%2F4216716816-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-LxKl4rC_EcwBAz40Qn_%252Fuploads%252FE0sQVcLuODi0XSr5k8zb%252F%25D0%25A1%25D0%25BD%25D0%25B8%25D0%25BC%25D0%25BE%25D0%25BA%2520%25D1%258D%25D0%25BA%25D1%2580%25D0%25B0%25D0%25BD%25D0%25B0%25202026-01-05%2520%25D0%25B2%252010.27.57.png%3Falt%3Dmedia%26token%3D31a84f7b-98b9-4d43-9d6c-822ce8c56030&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=8670001d&#x26;sv=2" alt="" width="375"><figcaption></figcaption></figure>

<figure><img src="https://docs.salebot.pro/~gitbook/image?url=https%3A%2F%2F4216716816-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-LxKl4rC_EcwBAz40Qn_%252Fuploads%252FOP3kBsfJNFP8ATB5WXmC%252F%25D0%25A1%25D0%25BD%25D0%25B8%25D0%25BC%25D0%25BE%25D0%25BA%2520%25D1%258D%25D0%25BA%25D1%2580%25D0%25B0%25D0%25BD%25D0%25B0%25202026-01-05%2520%25D0%25B2%252010.16.22.png%3Falt%3Dmedia%26token%3D3bfad43a-a62e-4369-aae0-309bf2e0b3b1&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=160a1748&#x26;sv=2" alt="" width="375"><figcaption></figcaption></figure>

#### HTML <a href="#html" id="html"></a>

\<i>курсив\</i> или \<em>курсив\</em>

\<b>жирный\</b> или \<strong>жирный\</strong>

\<del>зачёркнутый\</del> или \<s>зачёркнутый\</s>

\<ins>подчёркнутый\</ins> или \<u>подчёркнутый\</u>

\<pre>моноширинный\</pre> или \<code>моноширинный\</code>

ссылка \<a href="[https://dev.max.ru">Docs\\](https://docs.salebot.pro/chat-boty/podklyuchenie-messendzherov-i-kanalov/max/https:/dev.max.ru">Docs\\)</a>

<div><figure><img src="https://4216716816-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LxKl4rC_EcwBAz40Qn_%2Fuploads%2FoIRceAMbRWwbvWUXs5Sj%2F%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202026-01-21%20%D0%B2%2014.54.37.png?alt=media&#x26;token=d202d704-c712-428f-ad92-8bf6f67aa735" alt=""><figcaption></figcaption></figure> <figure><img src="https://4216716816-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LxKl4rC_EcwBAz40Qn_%2Fuploads%2F2kvAgpgSjxDgLGB2mbto%2F%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202026-01-21%20%D0%B2%2014.54.47.png?alt=media&#x26;token=e0840ef1-df75-4bce-82fe-be6cedd037a5" alt=""><figcaption></figcaption></figure></div>

## Кнопка MAX WebApp

В MAX теперь можно добавлять мини-приложения (WebApp) с ссылкой на ваш сайт или онлайн-магазин.

Ссылку возможно вставить только на бота, у которого настроено мини-приложение.&#x20;

{% hint style="info" %}
Ссылка на сайт настраивается вручную в настройках бота.\
[Подробнее в официальной документации MAX.](https://dev.max.ru/docs/webapps/introduction)
{% endhint %}

{% hint style="warning" %}
Важно!

В настройке кнопки на стороне Salebot допустимо вставлять ссылку на другого бота с настроенным мини-приложением. Ссылку сразу на сайт вставить нельзя
{% endhint %}

### Настройки: как добавить приложение в MAX <a href="#kak-dobavit-prilozhenie-v-max" id="kak-dobavit-prilozhenie-v-max"></a>

1. Откройте [платформу MAX для партнёров](https://business.max.ru/self), зайдите в профиль организации → перейдите в раздел **Чат-боты**
2. Если у вас несколько ботов, в панели управления ботом нажмите на имя текущего бота и выберите нужный из списка
3. Перейдите в раздел **Чат-бот и мини-приложение** → **Настроить**
4. Вставьте URL мини-приложения в поле для ссылки
5. Выберите вид кнопки открытия мини-приложения (**Открыть**, **Старт**, **Играть** или без названия) и нажмите **Сохранить**

**Требования к URL мини-приложения:**

* Длина: не более 1024 символов
* Протокол: только https\://
* Допустимые символы: буквы (латиница), цифры, точка (.) и дефис (-)
* Пробелы не поддерживаются
* URL должен быть валидный

<div data-with-frame="true"><figure><img src="https://4216716816-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LxKl4rC_EcwBAz40Qn_%2Fuploads%2FKlm5adOJ2A3YPDtRgYKA%2F%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202026-03-04%20%D0%B2%2017.17.49.png?alt=media&#x26;token=a9ddd892-c2ed-4f40-b261-20d9c3a5c811" alt="" width="375"><figcaption></figcaption></figure></div>

Как только вы подключите мини-приложение к платформе, в чате с его ботом появится заметная кнопка для быстрого запуска сервиса.

<figure><img src="https://4216716816-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LxKl4rC_EcwBAz40Qn_%2Fuploads%2Funb8WtR1As7YKsHoHolq%2Fminiapp_launch_dark.png?alt=media&#x26;token=b2c8c592-b544-4580-92fb-0eda9c6d0f25" alt=""><figcaption></figcaption></figure>

### Настройки кнопки с WebApp

Чтобы отправлять клиенту кнопку с WebApp в цепочке бота, в блоке создайте кнопку:

<div data-with-frame="true"><figure><img src="https://4216716816-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LxKl4rC_EcwBAz40Qn_%2Fuploads%2FU75yM5yQUOSKzOyZfSmP%2F%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202026-03-04%20%D0%B2%2017.19.55.png?alt=media&#x26;token=696d8dfd-b724-48ad-af1a-866a3cdb8577" alt=""><figcaption></figcaption></figure></div>

В настройках кнопки выберите функцию MAX Web Application и вставьте ссылку на вашего бота.