# Налаштування проєкту

У налаштуваннях проєкту ви можете вибрати вхідні сповіщення, налаштувати роботу з воронками, а потім задати змінні та константи, перейменувати проєкт і багато іншого.

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

Інструкцію наведено нижче.

## Основні налаштування

<figure><img src="/files/7aa48a5d1ba3356b72ea433188b01be12206fb2b" alt=""><figcaption></figcaption></figure>

У основних налаштуваннях проєкту користувач може змінити:

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

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

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

URL вебхука

* Потрібен для отримання подій від сторонніх сервісів.

Також у основних налаштуваннях проєкту можна активувати прапорці:

<figure><img src="/files/58373f8b77c2ef0f3f438c092808fe68311ceaaf" alt=""><figcaption></figcaption></figure>

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

## Callback-и

У налаштуваннях проєкту ви можете визначити, які callback-и хочете отримувати в MaviBot:

<figure><img src="/files/1ad00be6babbffcfa1c42e822924f4022f89934c" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}
Callback — це системне сповіщення, яке допоможе відстежувати події в Mavibot без постійної перевірки списків, міток і воронок у CRM, що значно заощадить ваш час.
{% endhint %}

{% hint style="info" %}
У цьому розділі системні сповіщення налаштовуються лише з розділів Mavibot. Щоб побачити, які callback-и приходять, наприклад, від платіжних систем, месенджерів та інших інтеграцій, потрібно прочитати відповідну статтю документації.
{% endhint %}

&#x20;можна налаштувати callback-и для сповіщень:

* Додавання/видалення списків і міток
* Дії із завданнями: створення, видалення, редагування та завершення

Наприклад, під час створення завдання, пов’язаного з певним клієнтом, у розділі "Клієнти" в діалозі з ним з’явиться повідомлення з текстом: new\_task\_added\_callback task\_id:#{task.id}, task\_name:#{task.name}

<figure><img src="/files/5643e3e9c4892d1cb6a82022a6e91d27dce6eca6" 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/23da46533f3759bb4c4f161b1a545cb90fc3ea4b" alt="" width="375"><figcaption></figcaption></figure>

* Зміна відповідальної особи клієнта

Callback містить ID угоди, а також ім’я відповідальної особи, на яку було замінено вашого попереднього співробітника:

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

* Видалення угоди

Щоб бачити всі дії в CRM, також відстежуйте видалення угод у ваших воронках, щоб не пропустити нічого важливого:

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

* Перетягування угод у системний стан

Існують системні стани воронки, у які можна перемістити угоду в MavibotCRM:

Можна налаштувати надсилання callback-ів під час перетягування угод у стан: "видалити угоду", "угоду завершено", "успішна угода", "архів". Тоді в діалозі з клієнтом ви отримаєте сповіщення такого типу:

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

### Налаштування callback-ів під час переходів між етапами CRM

<figure><img src="/files/3155c71c94eac4a0f3c65cdd481b8270d4bb7bcb" alt=""><figcaption></figcaption></figure>

Після натискання на "Налаштування callback для переходів між етапами CRM" відкривається модальне вікно з усіма воронками, що існують у проєкті:

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

Це налаштування допоможе активувати бота під час переходу клієнта до певного стану воронки. Для цього достатньо вибрати або всю воронку (тоді будь-який перехід угоди клієнта через воронку активує бота), або лише перехід до певного стану:

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

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

{% hint style="info" %}
Сповіщення виглядає так: crm\_state\_changed Назва воронки:Назва етапу
{% endhint %}

Також у картці клієнта з’явиться змінна callback\_query\_id, у якій зберігатиметься ідентифікатор угоди, для якої було надіслано сповіщення:

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

Щоб запустити бота для цієї події, необхідно вказати текст сповіщення в полі Condition стрілки або будь-якого блоку з умовою (блок первинної перевірки умови, а не умови стану).

## Константи

{% hint style="danger" %}
Зверніть увагу!

Необхідно враховувати обмеження на змінні та константи в проєкті:

* Максимальна кількість шаблонних змінних — 100;
* Назва шаблонної змінної не може перевищувати 100 символів;
* Максимальна кількість констант проєкту — 50;
* Назва константи не може перевищувати 100 символів;
* Значення константи не може перевищувати 5000 символів.
  {% endhint %}

Константа проєкту — це постійна, незмінна змінна. Наприклад, вона може знадобитися вам для роботи з платежами в боті.

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

Щоб додати константи проєкту, натисніть на іконку олівця. Після цього відкриється модальне вікно, де ви можете ввести назву змінної та її значення:

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

Далі вам потрібно просто ввести змінну:

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

Після цього в діалозі з клієнтом бот підтягує значення з константи проєкту:

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

## Змінні

{% hint style="danger" %}
Зверніть увагу!

Необхідно враховувати обмеження на змінні та константи в проєкті:

* Максимальна кількість шаблонних змінних — 100;
* Назва шаблонної змінної не може перевищувати 100 символів;
* Максимальна кількість констант проєкту — 50;
* Назва константи не може перевищувати 100 символів;
* Значення константи не може перевищувати 5000 символів.
  {% endhint %}

Призначені змінні в налаштуваннях проєкту також можна використовувати всередині вашого чат-бота (зокрема, [AI чат-бота](/doc/uk/chatbot/ai/online-booking.md)).&#x20;

<figure><img src="/files/028010f665970a66f897b42a39f3f649fbcd1bcc" alt=""><figcaption></figcaption></figure>

Призначені змінні в налаштуваннях проєкту також можна використовувати всередині вашого чат-бота (зокрема, AI чат-бота).

{% hint style="warning" %}
Різниця між змінними та константами

* Змінні можна змінювати через ботів, тоді як із константи можна лише отримати значення.
* Значення змінних однакове для всіх користувачів. Це означає, що якщо ви зміните значення змінної через бот, воно зміниться для всіх клієнтів, зокрема й у налаштуваннях проєкту. Константу так змінити не можна.
* Значення константи можна змінити лише індивідуально для одного клієнта, відповідно, у налаштуваннях проєкту константа залишиться незмінною з раніше встановленим значенням.
* Якщо у боті звертатися до змінної за допомогою конструкції "project.", ви можете змінити значення змінної.
  {% endhint %}

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

### Як правильно призначати змінні/константи в налаштуваннях проєкту

{% hint style="danger" %}
УВАГА!

Ви не можете використовувати інтерполяцію змінних у значенні змінної/константи У НАЛАШТУВАННЯХ ПРОЄКТУ!

Інтерполяція — це присвоєння однієї змінної іншій за допомогою конструкції #{}.
{% endhint %}

<mark style="color:red;">**НЕПРАВИЛЬНО:**</mark>

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

<mark style="color:green;">**ПРАВИЛЬНО:**</mark>

Під час призначення змінних у налаштуваннях проєкту ви можете використовувати різні значення:

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

Наприклад, змінні зі скриншота вище було кешовано в проєкті через бот за допомогою блоків конструктора та встановлених функцій:

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

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

Зверніть увагу, що змінна кешується в налаштуваннях проєкту через конструкцію "project.":

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

Також можна додати змінну в налаштуваннях проєкту, натиснувши на іконку олівця:

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

Після цього відкриється модальне вікно з наявним списком змінних, де потрібно натиснути на "Додати змінну":

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

Ба більше, ви можете встановити назву змінної на свій розсуд, [уникаючи назв системних змінних](/doc/uk/chatbot/functions/zminni.md#how-to-work-with-variables)

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

### Шаблони змінних

За допомогою функції "Шаблони змінних проєкту" ви можете швидко зібрати змінні, незалежно від їхніх типів.

Щоб зібрати змінну за шаблоном, натисніть на кнопку з такою ж назвою:

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

Ви побачите модальне вікно, у якому буде порожнє поле для назви змінної та випадаючий список із типом:

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

Якщо ви вибрали тип змінної "Список", тоді можете вказати можливі значення для змінної:

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

Щоб додати кілька значень:

Крок 1: Введіть назву змінної;

Крок 2: Введіть значення 1 для змінної;

Крок 3: натисніть на плюс у рядку зі значенням: після натискання на плюс для одного зі значень змінної під полем з’явиться панель із даними, які ви ввели для змінної:

<figure><img src="/files/15c67cf0efdc31095fcf9c9b2233190489d03e85" alt=""><figcaption></figcaption></figure>

Крок 4. Введіть наступне значення змінної та знову натисніть кнопку плюс: після кожного введення одного зі значень змінної потрібно натискати кнопку плюс.

Крок 5. Натисніть "Створити": після цього змінна буде додана внизу модального вікна:

<figure><img src="/files/44dca564a2ce183d0ba0bea0c691c34556225f41" alt=""><figcaption></figcaption></figure>

## Повідомлення

Цей розділ охоплює всі необхідні моменти під час роботи з чат-ботами:

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

1. Ви можете вказати власну адресу/кілька адрес електронної пошти, щоб отримувати замовлення/запити на вашу пошту, не пропускаючи жодної події.
2. За потреби є налаштування автоматичної відповіді на перше повідомлення користувача у вікні онлайн-чату або в месенджері з кнопками.

{% hint style="info" %}
Для детальнішої інформації дивіться статтю [Перше повідомлення в месенджерах](/doc/uk/chatbot/mesendzheri/message.md)&#x20;
{% endhint %}

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

### Дублювання повідомлень

Також у налаштуваннях проєкту в розділі Повідомлення ви можете налаштувати дублювання повідомлень на пошту ваших учнів і клієнтів:

<figure><img src="/files/172742b50525df029b57c68e7ccbaa287407ff48" alt=""><figcaption></figcaption></figure>

Якщо учень / клієнт пише вам в онлайн-чат, і після цього повідомлення не буде прочитано, тоді за наявності цього налаштування через заданий проміжок часу буде надіслано повідомлення учню / клієнту.

{% hint style="warning" %}
Важливо! Щоб ця функція працювала, вам потрібен підключений і авторизований поштовий бот.
{% endhint %}

{% hint style="info" %}
Як підключити поштовий бот, описано в статті "[Поштові розсилки](/doc/uk/rozsilki/email-kampaniyi.md)". — вставте посилання
{% endhint %}

Щоб дублювання на email працювало, необхідно встановити інтервал, після якого непрочитане повідомлення учня/клієнта буде продубльовано на пошту:

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

Якщо до проєкту підключено кілька поштових ботів, тоді ви можете обрати, з якого саме буде надіслано дубльоване повідомлення:

<figure><img src="/files/0811a4c934e35290d1ee6d1183dee92823e01bd1" 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/uk/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.