# Чат-бот MAX

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

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

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

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

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

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

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

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

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

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

## 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;

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

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

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

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

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

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

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

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

<div data-with-frame="true"><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></div>

<div data-with-frame="true"><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></div>

#### 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/chatbots/channels/max/https:/dev.max.ru">Docs\\)</a>

<div data-with-frame="true"><figure><img src="/files/lpUTcAwAhzRPXBm9UPQM" alt="" width="563"><figcaption></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="/files/gaZei5j3qn1DG4diCtY1" alt="" width="563"><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="/files/WkU8Ph8UGRSfpgRm3iW9" alt="" width="375"><figcaption></figcaption></figure></div>

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

<figure><img src="/files/0qM8pDZxJflJPIvE13DW" alt=""><figcaption></figcaption></figure>

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

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

<div data-with-frame="true"><figure><img src="/files/SATo2U8dIxLHZcu76ICJ" alt=""><figcaption></figcaption></figure></div>

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


---

# 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.salebot.pro/chatbots/channels/max/chatbot_max.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.