> For the complete documentation index, see [llms.txt](https://book.microcrm.online/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://book.microcrm.online/konstruktor-chat-botov/tipy-uzlov/triggery.md).

# Триггеры

## **Команда**

**Запускается когда:** пользователь отправляет команду (например, `/start`)

### **Настройки:**

* **Команда** — название команды без слэша (например, `start`, `help`, `menu`)
* Команды не чувствительны к регистру

### **Пример использования:**

```
/start → запуск приветственного сценария
/help → показ справки
/menu → главное меню бота
```

## **Содержит текст**

**Запускается когда:** сообщение пользователя содержит указанную фразу

### **Настройки:**

* **Текст** — ключевое слово или фраза
* Регистр не учитывается
* Проверяется вхождение подстроки

### **Пример использования:**

```
"цена" → показ прайс-листа
"контакт" → отправка контактной информации
"помощь" → вызов поддержки
```

## **Точный текст**

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

### **Настройки:**

* **Текст** — точное сообщение
* Регистр не учитывается
* Должно совпадать полностью

### **Пример использования:**

```
"да" → подтверждение действия
"нет" → отмена действия
"готово" → завершение процесса
```

## **Кнопка (Callback)**

**Запускается когда:** пользователь нажимает на inline-кнопку

### **Настройки:**

* **Callback данные** — уникальный идентификатор кнопки
* Должен совпадать с callback\_data кнопки в узле "Отправить сообщение"

### **Пример использования:**

```
"buy_product_1" → обработка покупки товара 1
"show_catalog" → показ каталога
"confirm_order" → подтверждение заказа
```

## **Контроль доступа к триггерам**

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

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

### **Визуальная индикация в редакторе**

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

Триггеры с ограниченным доступом отображают специальный значок справа от названия:

* 👥 **Сотрудники** — доступ только для сотрудников компании
* 🎭 **Роли** — доступ для конкретных ролей
* 👤 **Персона** — доступ для одного человека

Публичные триггеры не показывают значок (доступны всем).

### **Уровни доступа**

1. **Публичный (по умолчанию)** — триггер доступен всем пользователям бота
   * При создании нового триггера автоматически устанавливается этот уровень
2. **Только сотрудники компании** — триггер могут активировать только те пользователи, чей Telegram аккаунт привязан к учетной записи сотрудника в вашей компании через настройки профиля
3. **Конкретные роли** — выберите одну или несколько ролей компании:
   * Владелец
   * Главный менеджер
   * Менеджер
   * Сотрудник
4. **Конкретный человек** — только один выбранный сотрудник компании может использовать этот триггер

### **Сообщение при отказе в доступе:**

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

Если сообщение не указано, пользователь просто не получит никакого ответа от бота.

### **Примеры использования:**

* **Команда `/admin`** — доступна только владельцу и главному менеджеру
  * Сообщение при отказе: "Извините, эта команда доступна только руководству."
* **Команда `/stats`** — доступна менеджерам и выше
  * Сообщение при отказе: "Для просмотра статистики обратитесь к вашему менеджеру."
* **Команда `/secret`** — доступна только конкретному сотруднику
  * Без сообщения при отказе (пользователь не получит ответа)
* **Команда `/help`** — публичная команда, доступна всем

### **Важные замечания**

* Для работы контроля доступа пользователь должен привязать свой Telegram аккаунт к учетной записи в компании
* Привязка осуществляется через настройки профиля в личном кабинете
* Если пользователь не привязал аккаунт, он будет считаться внешним пользователем
* Внешние пользователи могут использовать только публичные триггеры


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://book.microcrm.online/konstruktor-chat-botov/tipy-uzlov/triggery.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.