> 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). # Управление клиентом Выполняет операции над клиентами в вашей CRM системе: обновляет информацию, создаёт транзакции и сделки
## **Основные возможности** ### **Выбор целевого клиента** Сначала выберите, с каким клиентом работать: 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 → [Поблагодарить и завершить] ```