Управление клиентом

Выполняет операции над клиентами в вашей 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 → [Поблагодарить и завершить]