> 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/upravlenie-klientom.md). # Управление клиентом
## **Основные возможности** ### **Выбор целевого клиента** Сначала выберите, с каким клиентом работать: 1. **Текущий пользователь бота** — клиент, который сейчас общается с ботом * Автоматически находится по Telegram ID * Если клиента нет в базе, он будет создан автоматически 2. **Конкретный клиент** — выбор клиента из списка CRM * Используйте поиск по имени, email или телефону * Полезно для операций от имени менеджера ## **Типы действий** После выбора клиента, укажите действие: *** ## **Обновить информацию** #### **Когда использовать:** * ✅ Сохранение данных, собранных в диалоге (имя, телефон, email) * ✅ Обновление категории клиента (VIP, постоянный и т.д.) * ✅ Установка пользовательских полей (бонусные баллы, дата последнего заказа) ### **Что можно обновлять** *Статические поля клиента:* * **Имя** — полное имя клиента * **Телефон** — номер телефона * **Email** — адрес электронной почты * **Telegram** — username в Telegram * **Категория** — категория клиента (Новые, Постоянные, VIP и др.) * **Статус** — активен/неактивен * **День рождения** — дата рождения *Контекстные переменные* (пользовательские поля): * **Бонусные баллы** — накопленные баллы лояльности * **Дата последнего заказа** — когда клиент делал заказ * **Предпочитаемый продукт** — любимый товар/услуга * **VIP статус** — является ли VIP клиентом * Любые другие поля, которые вы настроили в разделе "Клиенты → Настройки" ### **Настройки** Для каждого поля укажите: 1. **Название поля** — выберите из списка или введите имя контекстной переменной 2. **Значение** — что сохранить (может содержать переменные типа `{{context.user_name}}`) 3. **Тип поля** — статическое поле или контекстная переменная ### **Доступные поля** #### **Назначить менеджера** Для назначения менеджера клиенту есть два способа: 1. **Выбрать из списка** — выберите конкретного активного сотрудника компании из выпадающего списка ``` Пример: Выбираете "Иван Петров" из списка Результат: UUID менеджера автоматически подставится ``` 2. **Из переменной** — используйте переменную с UUID менеджера ``` Пример: {{context.manager_id}} Использование: После ноды "Найти сотрудника" ``` **💡 Совет:** Используйте ноду "Найти сотрудника" перед "Управлением клиентом" для автоматического выбора менеджера по критериям (например, менеджер с минимальным количеством клиентов). #### **Категория клиента** Категорию можно выбрать **только из существующих** категорий, настроенных в разделе "Клиенты" → "Настройки" → "Категории". * ✅ Выберите категорию из выпадающего списка * ❌ Нельзя ввести произвольное значение * ❌ Нельзя создать новую категорию через бота ``` Пример настроенных категорий: - Новый клиент (🟢 зелёный) - VIP клиент (🟡 золотой) - Проблемный клиент (🔴 красный) ``` ### **Пример использования** ``` [Найти сотрудника] → Найти менеджера с минимумом клиентов ↓ (сохранить в: free_manager_id) ↓ [Управление клиентом] → Обновить информацию Поля: - Назначить менеджера: {{context.free_manager_id}} (из переменной) - Категория: "Новый клиент" (из списка) ``` #### **Пример сценария: регистрация клиента** ``` [Отправить сообщение ⏳] Текст: "Как вас зовут?" Ожидать ответ: ВКЛ Сохранить в: user_name ↓ 💬 ↓ [Отправить сообщение ⏳] Текст: "Укажите ваш телефон:" Ожидать ответ: ВКЛ Сохранить в: user_phone ↓ 💬 ↓ [Управление клиентом] Целевой клиент: Текущий пользователь Действие: Обновить информацию Поля: - Имя: {{context.user_name}} (статическое) - Телефон: {{context.user_phone}} (статическое) - Дата регистрации: {{now}} (контекстная переменная) ``` *** ## **Создать транзакцию** ### **Когда использовать** * ✅ Фиксация покупки или платежа * ✅ Начисление бонусов * ✅ Учёт возвратов или списаний ### **Настройки** 1. **Сумма транзакции** (обязательно) — числовое значение или переменная ``` Примеры: 5000 {{context.payment_amount}} {{context.price * context.quantity}} ``` 2. **Описание** (необязательно) — пояснение к транзакции ``` Примеры: Оплата заказа №{{context.order_id}} Начисление бонусов Возврат средств ``` 3. **Категория** (необязательно) — тип транзакции для отчётности ``` Примеры: Продажа Возврат Бонусы ``` ### **Пример сценария** ``` [Отправить сообщение ⏳] Текст: "Укажите сумму покупки:" Ожидать ответ: ВКЛ Сохранить в: purchase_amount ↓ 💬 ↓ [Управление клиентом] Целевой клиент: Текущий пользователь Действие: Создать транзакцию Сумма: {{context.purchase_amount}} Описание: Покупка через Telegram бот Категория: Продажа ↓ [Отправить сообщение] Текст: "Покупка на сумму {{context.purchase_amount}} руб. зарегистрирована! ✅" ``` *** ## **Создать сделку** ### **Когда использовать** * ✅ Клиент проявил интерес к товару/услуге * ✅ Начало переговоров о сотрудничестве * ✅ Фиксация заявки на консультацию * ✅ Создание лида для менеджера ### **Настройки** 1. **Название сделки** (обязательно) — краткое описание ``` Примеры: Запрос консультации Интерес к тарифу Premium Заказ корпоративного обучения Сделка: {{context.product_name}} ``` 2. **Сумма** (необязательно) — предполагаемая сумма сделки ``` Примеры: 50000 {{context.estimated_amount}} ``` 3. **Статус** (необязательно) — этап сделки * **Новая** — только что создана (по умолчанию) * **В работе** — ведутся переговоры * **Выиграна** — сделка успешно закрыта * **Проиграна** — сделка не состоялась 4. **Описание** (необязательно) — дополнительные детали ``` Примеры: Клиент интересуется {{context.product_name}} Заявка получена через Telegram бот Требуется связаться в течение 24 часов ``` 5. **Категория** (необязательно) — тип сделки ``` Примеры: Входящий запрос Повторная продажа Корпоративный клиент ``` ### **Пример сценария** Создание сделки с уведомлением менеджера ``` [Триггер: Кнопка "Заказать консультацию"] ↓ [Отправить сообщение ⏳] Текст: "Какой продукт вас интересует?" Ожидать ответ: ВКЛ Сохранить в: product_interest ↓ 💬 ↓ [Управление клиентом] Целевой клиент: Текущий пользователь Действие: Создать сделку Название: Запрос консультации Сумма: (не указана) Статус: Новая Описание: Клиент интересуется: {{context.product_interest}} Категория: Входящий запрос ↓ [Уведомление] Канал: Telegram Получатели: [Менеджер по продажам] Сообщение: "🔔 Новая сделка! Клиент: {{client.name}} Интерес: {{context.product_interest}} Telegram: @{{client.telegram}}" ↓ [Отправить сообщение] Текст: "Спасибо! Менеджер свяжется с вами в ближайшее время." ``` *** ## **Использование переменных** Все поля поддерживают переменные: ### **Из контекста** * `{{context.variable_name}}` — переменные, сохранённые ранее * `{{message.text}}` — последнее сообщение пользователя ### **Данные клиента** * `{{client.name}}` — имя текущего клиента * `{{client.phone}}` — телефон клиента * `{{client.email}}` — email клиента ### **Специальные** * `{{now}}` — текущая дата и время * `{{callback_data}}` — данные нажатой кнопки ### **Вычисления** ``` {{context.price * 1.2}} — цена + 20% {{context.score + 10}} — добавить 10 баллов ``` *** ## **Советы по использованию** #### **✅ Хорошие практики:** 1. **Всегда сохраняйте контакты клиента** ``` После сбора имени и телефона → Обновить информацию ``` 2. **Создавайте сделки при явном интересе** ``` Клиент нажал "Хочу купить" → Создать сделку + Уведомить менеджера ``` 3. **Фиксируйте транзакции после оплаты** ``` После подтверждения платежа → Создать транзакцию ``` 4. **Используйте контекстные переменные для бизнес-логики** ``` Сохраняйте: количество заказов, средний чек, дату последней покупки ``` #### **❌ Чего избегать:** 1. Не обновляйте поля пустыми значениями без необходимости 2. Не создавайте дубликаты транзакций в одном сценарии 3. Не забывайте указывать описание для транзакций и сделок *** ## **Комбинирование с другими узлами** ### **С уведомлениями** ``` [Создать сделку] → [Уведомление менеджеру] ``` ### **С условиями** ``` [Условие: сумма > 10000] ├─ true → [Обновить категорию на VIP] └─ false → [Стандартная обработка] ``` ### **С ИИ Агентом** ``` [ИИ Агент: Квалификация лида] ↓ [Условие: лид качественный?] ├─ true → [Создать сделку] └─ false → [Поблагодарить и завершить] ``` --- # 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/upravlenie-klientom.md?ask=&goal= ``` `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.