# Настройки проекта

В настройках проекта можно выбрать входящие уведомления, настроить работу с воронками, а затем задать переменные и константы, переименовать проект и многое другое.

<figure><img src="/files/68b50aebf0bfe847d0c4ed14317d5ade816d2bbf" alt="" width="210"><figcaption></figcaption></figure>

Инструкция указана ниже.

## Основные настройки

<figure><img src="/files/4ff23e8caf3d38cbcd94d1c4797c7b4145169880" alt=""><figcaption></figcaption></figure>

В основных настройках проекта пользователь может изменить:

* название проекта;
* часовой пояс;
* владельца проекта;
* задать домен для ссылок в боте:

<figure><img src="/files/d9b511ebe6fa0d712b90318af629022805fc806e" alt=""><figcaption></figcaption></figure>

Вам потребуется подключить собственный домен, если необходимо, чтобы прокси-ссылка была на вашем домене, а не на домене Mavibot. Это необязательная настройка.

URL вебхука

* Нужен для получения событий от сторонних сервисов.

Также в основных настройках проекта можно активировать чекбоксы:

<figure><img src="/files/69058c164b90fd685cc58c0b1e7a232116e3240b" alt=""><figcaption></figcaption></figure>

* Автоматически принимать лиды на первый этап воронки\
  Этот чекбокс сразу создаст карточки сделок на первом этапе воронки в MaviCRM.
* Запретить операторам отправлять файлы\
  После выбора этой настройки сотрудники вашего проекта с ролью Оператор (или другой вручную настроенной ролью) не смогут отправлять файлы в диалогах.
* Клиенты, ожидающие ответа, всегда сверху \
  Он будет отображать клиентов, которым вы или ваши сотрудники еще не ответили, вверху всего списка.
* Не проверять формат параметров post-json\
  Для настроек в боте
* Бот включен\
  Чекбокс для включения/выключения бота в проекте

## Колбэки

В настройках проекта можно настроить, какие колбэки вы хотите получать в MaviBot:

<figure><img src="/files/548d551693d20d2a5a1fa6fc961fb17bbb4a9b27" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
Колбэк — это системное уведомление, которое поможет отслеживать события в Mavibot без необходимости каждый раз проверять списки, метки и воронки в CRM, что значительно сэкономит ваше время.
{% endhint %}

{% hint style="info" %}
В этом разделе настраиваются системные уведомления только из разделов Mavibot. Чтобы увидеть, какие колбэки приходят, например, от платежных систем, мессенджеров и других интеграций, нужно прочитать соответствующую статью документации.
{% endhint %}

&#x20;можно настроить колбэки для уведомлений:

* Добавление/удаление списков и меток
* Действия с задачами: создание, удаление, редактирование и завершение

Например, при создании задачи, привязанной к конкретному клиенту, в разделе «Клиенты» в диалоге с ним появится сообщение с текстом: new\_task\_added\_callback task\_id:#{task.id}, task\_name:#{task.name}

<figure><img src="/files/9140e8f23d4efd3681e6027353371368f698c37c" alt="" width="375"><figcaption></figcaption></figure>

А при редактировании задачи, привязанной к конкретному клиенту, в диалоге с клиентом появится комментарий с текстом: «Задача была отредактирована» #{current\_user.display\_name}: edit\_task\_callback task\_id:#{task.id}, task\_name:#{task.name}"

<figure><img src="/files/8efde2153c9ff1e3f13f86fc8e773d7dcb4c4ff2" alt="" width="375"><figcaption></figcaption></figure>

* Изменение ответственного за клиента

Колбэк включает ID сделки, а также имя ответственного, на которого был заменен ваш предыдущий сотрудник:

<figure><img src="/files/cdc5a56102fb741a640be2b19ef358236db63fad" alt="" width="375"><figcaption></figcaption></figure>

* Удаление сделки

Чтобы видеть все действия в CRM, также отслеживайте удаление сделок в ваших воронках, чтобы не пропустить ничего важного:

<figure><img src="/files/670c03a0f540c8320e5dcd6b1a5a5c6f081616e8" alt="" width="375"><figcaption></figcaption></figure>

* Перетаскивание сделок в системный статус

Существуют системные статусы воронки, в которые сделку можно перевести в MavibotCRM:

Можно настроить отправку колбэков при перетаскивании сделок по статусам: «удалить сделку», «сделка завершена», «успешная сделка», «архив». Тогда в диалоге с клиентом вы получите уведомление следующего типа:

<figure><img src="/files/9c23064b55eadead6099c755192d6bd98bbc7403" alt="" width="375"><figcaption></figcaption></figure>

### Настройка колбэков при переключении между этапами CRM

<figure><img src="/files/770fe73a48687de71ccd38cd1371afb8f429e350" alt=""><figcaption></figcaption></figure>

После нажатия на «Настройки колбэков для переходов между этапами CRM» откроется модальное окно со всеми воронками, которые существуют в проекте:

<figure><img src="/files/a5c0f988a65dd004c1a76e2110d7eb40adc347c2" alt=""><figcaption></figcaption></figure>

Эта настройка поможет активировать бота при переключении клиента в определенный статус воронки. Для этого достаточно выбрать либо всю воронку (тогда любое переключение сделки клиента по воронке будет активировать бота), либо только переключение в определенный статус:

<figure><img src="/files/153954afe8f474166551ce62937002a5f614cd3c" alt="" width="375"><figcaption></figcaption></figure>

Теперь при изменении статуса сделки (автоматически или вручную) будет генерироваться уведомление из любой точки сайта, которое может запускать бота.

{% hint style="info" %}
Уведомление выглядит так: crm\_state\_changed Название воронки:Название этапа
{% endhint %}

В карточке клиента также появится переменная callback\_query\_id, в которой будет храниться идентификатор сделки, для которой было отправлено уведомление:

<figure><img src="/files/937e7634f50156ab9a6fa436a4d95cf339b9a02e" alt="" width="375"><figcaption></figcaption></figure>

Чтобы запустить бота по этому событию, необходимо указать текст уведомления в поле Condition стрелки или любого блока с условием (блок проверки первичного условия, а не условие статуса).

## Константы

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

Необходимо учитывать лимиты на переменные и константы в проекте:

* Максимальное количество шаблонных переменных — 100;
* Имя шаблонной переменной не может превышать 100 символов;
* Максимальное количество констант проекта — 50;
* Имя константы не может превышать 100 символов;
* Значение константы не может превышать 5000 символов.
  {% endhint %}

Константа проекта — это постоянная, неизменяемая переменная. Например, она может понадобиться для работы с платежами в боте.

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

Чтобы добавить константы проекта, нажмите на иконку карандаша. Затем откроется модальное окно, где можно ввести имя переменной и ее значение:

<figure><img src="/files/548558f34f2019c14e398d4e677939715b23099b" alt="" width="375"><figcaption></figcaption></figure>

Далее нужно просто ввести переменную:

<figure><img src="/files/3199b3e775708d2c363604458f5ffc62928d2547" alt="" width="375"><figcaption></figcaption></figure>

Затем в диалоге с клиентом бот подставит значения из константы проекта:

<figure><img src="/files/fc3f8d6ebcf39b199d6570f099f07d3368de8cb7" alt="" width="375"><figcaption></figcaption></figure>

## Переменные

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

Необходимо учитывать лимиты на переменные и константы в проекте:

* Максимальное количество шаблонных переменных — 100;
* Имя шаблонной переменной не может превышать 100 символов;
* Максимальное количество констант проекта — 50;
* Имя константы не может превышать 100 символов;
* Значение константы не может превышать 5000 символов.
  {% endhint %}

Назначенные переменные в настройках проекта также можно использовать внутри вашего чат-бота (в том числе и [ИИ-чатбот](/doc/ru/chatbot/ai/online-booking.md)).&#x20;

<figure><img src="/files/882a11bb4eb7f813a99dff1d084d60594d998beb" alt=""><figcaption></figcaption></figure>

Назначенные переменные в настройках проекта также можно использовать внутри вашего чат-бота (в том числе и ИИ-чатбота).

{% hint style="warning" %}
Разница между переменными и константами

* Переменные можно изменять через ботов, тогда как из константы можно только взять значение.
* Значение переменных одинаково для всех пользователей. Это означает, что если изменить значение переменной через бота, оно изменится для всех клиентов, в том числе и в настройках проекта. Константу так изменить нельзя.
* Значение константы можно изменить только уникально для одного клиента, соответственно, в настройках проекта константа останется без изменений с ранее заданным значением.
* Если обратиться к переменной в боте с помощью конструкции «project.», можно изменить значение переменной.
  {% endhint %}

{% hint style="success" %}
Наглядный пример работы с переменной через бота и конструкцию project. можно прочитать в статье «[Чатбот с ИИ для онлайн-записи](/doc/ru/chatbot/ai/online-booking.md)".&#x20;
{% endhint %}

### Как правильно назначать переменные/константы в настройках проекта

{% hint style="danger" %}
ОБРАТИТЕ ВНИМАНИЕ!

Нельзя использовать интерполяцию переменной в значении переменной/константы В НАСТРОЙКАХ ПРОЕКТА!

Интерполяция — это присваивание одной переменной другой через конструкцию #{}.
{% endhint %}

<mark style="color:красный;">**НЕПРАВИЛЬНО:**</mark>

<figure><img src="/files/c270c38ba222fdfcdc82749680dd0f78fe86313f" alt="" width="375"><figcaption></figcaption></figure>

<mark style="color:зелёный;">**ПРАВИЛЬНО:**</mark>

При назначении переменных в настройках проекта можно использовать разные значения:

<figure><img src="/files/3275dec17400e76f4a65d803731f52bc00c6d263" alt="" width="375"><figcaption></figcaption></figure>

Например, переменные со скриншота выше были закэшированы в проекте через бота с помощью блоков-конструкторов и установленных функций:

<figure><img src="/files/f038b4d21cff32de7895b800d19b5f2668787ebd" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Функция get\_info\_for\_booking() работает только при настройке раздела «Услуги» на онлайн-запись и берет значения для доступных свободных слотов записи.
{% endhint %}

Обратите внимание, что переменная кэшируется в настройках проекта через конструкцию «project.»:

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

Также добавить переменную в настройках проекта можно, нажав на иконку карандаша:

<figure><img src="/files/74f871b20b3ff63255c0ec7c208964e1e4f3d3db" alt=""><figcaption></figcaption></figure>

После этого откроется модальное окно с существующим списком переменных, где нужно нажать на «Добавить переменную»:

<figure><img src="/files/bae612de600175a0c9d347077cc761402fee4de8" alt="" width="375"><figcaption></figcaption></figure>

Кроме того, вы можете задать имя переменной по своему усмотрению, [избегая имен системных переменных](/doc/ru/chatbot/functions/peremennye.md#how-to-work-with-variables)

<figure><img src="/files/5806ea7c023b143625c90fcc1335549623c3ac78" alt="" width="375"><figcaption></figcaption></figure>

### Шаблоны переменных

С помощью функции «Шаблоны переменных проекта» можно быстро собирать переменные независимо от их типов.

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

<figure><img src="/files/8c777b0e9780734816738beec582ce195602f62f" alt="" width="375"><figcaption></figcaption></figure>

Вы увидите модальное окно, в котором будет пустое поле для имени переменной и выпадающий список с типом:

<figure><img src="/files/99c31a7cdcdcc9c49713f7076c75ad1e105a2aaf" alt=""><figcaption></figcaption></figure>

Если вы выбрали тип переменной «Список», то можно указать возможные значения для переменной.:

<figure><img src="/files/b2e4e635745e44231d8699b1187589cf37963469" alt=""><figcaption></figcaption></figure>

Чтобы добавить несколько значений:

Шаг 1: Введите имя переменной;

Шаг 2: Введите значение 1 для переменной;

Шаг 3: нажмите на плюс в строке со значением: после нажатия на плюс для одного из значений переменной под полем появится панель с данными, которые вы ввели для переменной:

<figure><img src="/files/a29a0198bec0da69d48fd3ae19028ff2b7603586" alt=""><figcaption></figcaption></figure>

Шаг 4. Введите следующее значение переменной и снова нажмите кнопку плюс: после каждого введенного значения переменной нужно нажимать кнопку плюс.

Шаг 5. Нажмите «Создать»: после этого переменная будет добавлена внизу модального окна:

<figure><img src="/files/b6f73c9769ea2e29588e752d073affd8e815d89e" alt=""><figcaption></figcaption></figure>

## Сообщения

Этот раздел охватывает все необходимые моменты при работе с чат-ботами:

<figure><img src="/files/e93887436a07d507ea15d55dd3bfedde6be3fba6" alt="" width="375"><figcaption></figcaption></figure>

1. Вы можете указать свой адрес/несколько адресов электронной почты для получения заказов/заявок на вашу почту, не пропустив ни одного события.
2. При необходимости есть настройка автоматического ответа на первое сообщение пользователя в окне онлайн-чата или мессенджере с кнопками.

{% hint style="info" %}
Для получения дополнительной информации см. статью [Первое сообщение в мессенджерах](/doc/ru/chatbot/messendzhery/message.md)&#x20;
{% endhint %}

3. Также вы можете подстраховаться, чтобы бот никогда не останавливался: задайте текст сообщения на случай, если бот не знает ответ пользователя.
4. Также, активировав уведомления, вы сможете видеть клиентов, которые написали вам в боте, даже если в данный момент вы находитесь в другом проекте Salebot.

### Дублирующие сообщения

Также в настройках проекта в разделе «Сообщения» можно настроить дублирование сообщений на почту ваших учеников и клиентов:

<figure><img src="/files/6c8a88594c2fe9d97d27bc14dbd87b77b01627e7" alt=""><figcaption></figcaption></figure>

Если ученик / клиент пишет вам в онлайн-чате, и после этого сообщение не прочитано ими, то при включенной этой настройке сообщение будет отправлено ученику / клиенту через указанный промежуток времени.

{% hint style="warning" %}
Важно! Для работы этой функции нужен подключенный и авторизованный email-бот.
{% endhint %}

{% hint style="info" %}
Как подключить email-бота, описано в статье «[Email-рассылки](/doc/ru/rassylki/email-rassylki.md)». — вставить ссылку
{% endhint %}

Для того чтобы дублирование на email работало, необходимо задать интервал, после которого непрочитанное сообщение ученика/клиента будет продублировано на почту:

<figure><img src="/files/a902b2a4054a80e2af430dae6ab3df5e3658d5b0" alt="" width="375"><figcaption></figcaption></figure>

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

<figure><img src="/files/65123dd184f7b66bbfebd5021966f6ec123c4825" alt=""><figcaption></figcaption></figure>

#### Видеоурок

{% embed url="<https://youtu.be/Teb_onsWUYA>" %}


---

# 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/doc/ru/us/admin/settings.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.