2026-11-13
ИИ-агент в CRM: от заявки до задачи менеджеру
Карта полей, проверка дублей и повторной доставки на примере CRM. Как задать безопасный пилот обработки заявок для бизнеса Казахстана.
Клиент пишет на казахском: «Сәлеметсіз бе! Алматыдағы кеңсеге 20 орындық керек. Баға ұсынысын қазақша жіберіңіз. Бюджет әлі бекітілмеген». Менеджер должен завести обращение, не потерять количество, отметить язык ответа и уточнить характеристики. Если ИИ вместо этого заполнит предполагаемую сумму сделки и создаст три одинаковые задачи после повторной доставки письма, ручного труда станет больше.
Начинайте не с разрешения агенту «вести CRM», а с одного маршрута: входящее обращение → проверенный набор полей → карточка или предложение обновления → одна задача менеджеру. Ни отправка коммерческого предложения, ни назначение цены, ни смена этапа сделки в этот пилот не входят. Для руководителя продаж результатом станет карта полей и правил, которую можно проверить на примерах до подключения записи в CRM.
Ниже — синтетический сценарий для компании в Казахстане. Клиент, сообщение и идентификаторы условные; это не история внедрения GolemWorkers. Технические границы разобраны по действующей документации Битрикс24, но ни рабочий портал, ни готовый коннектор здесь не проверялись. Для другой CRM ту же бизнес-карту нужно заново сопоставить с её объектами и правами.
Сначала выберите одну карточку, а не всю воронку
Зафиксируем исходный маршрут: одна разрешённая папка входящих сообщений, один тип запроса на товар, одна очередь продаж. На первом этапе агент готовит пакет для проверки, а менеджер подтверждает создание лида и связанной задачи. В компании, где лиды не используются, целевым объектом может быть другой объект CRM: его выбирают до реализации, а не создают параллельно лид и сделку «на всякий случай».
Для этого сообщения пакет содержит исходный текст, ссылку или внутренний идентификатор разрешённого источника, предлагаемые поля и отдельный список неизвестного. «20 орындық» — двадцать стульев, а не двадцать сотрудников. Язык запроса — казахский. Бюджет не утверждён; это не нулевой бюджет и не разрешение взять сумму из прайс-листа. Модель не должна угадывать тип стула, цену, срок поставки или юридическое название покупателя.
Если процесс ещё не выбран, полезнее сначала сравнить кандидатов на первый пилот. Здесь решаем уже другую задачу: как конкретное обращение должно пройти в CRM без недостоверных полей и лишних действий.

Карта полей: значение, доказательство, действие при пробеле
Это бизнес-спецификация, а не JSON для отправки в API. Системные имена, обязательность, справочники и пользовательские поля берутся из конкретного портала. У Битрикс24 есть документация полей лида [1]; доступность нужных полей проверяют в выбранной версии API.
На телефоне таблицу можно прокручивать по горизонтали.
| Что переносим | Откуда известно | Проверка и действие |
|---|---|---|
| Источник и ID события | Конверт сообщения: канал mailbox-A, ID demo-0042 |
Пара должна быть стабильной при повторе. Отсутствует — карантин, не запись |
| Тема обращения | «20 орындық» и город в тексте | «Запрос: 20 стульев, Алматы»; без выдуманной модели товара |
| Количество | Фрагмент «20 орындық» | Целое 20; единица — штуки, не KZT |
| Язык ответа | Просьба «қазақша жіберіңіз» | kk; исходный текст сохраняется, перевод не заменяет его |
| Контакт | Адрес отправителя buyer@example.invalid из конверта |
Тестовый адрес; в рабочем процессе проверить допустимость источника, не считать адрес доказанной личностью |
| Компания | В сообщении отсутствует | Не придумывать; менеджер уточняет |
| Бюджет и валюта | «Бюджет әлі бекітілмеген» | Бюджет неизвестен. KZT — настройка примера, не извлечённая из письма валюта |
| Ответственный и срок | Утверждённая очередь и правило компании | Менеджер demo-user-17; срок — только по правилу, с часовым поясом |
Полезно хранить не только итог, но и происхождение: «из текста», «из конверта», «из правила» или «неизвестно». Значение из правила нельзя показывать как слова клиента. Поле уверенности модели не заменяет эту проверку: уверенно выдуманная сумма остаётся выдуманной.
В задаче менеджеру будет конкретное действие: «Уточнить тип стула, название компании, бюджет и срок поставки; ответить на казахском». Связь с карточкой и исходным обращением обязательна. Для tasks.task.add документация требует заголовок и ID ответственного, а также обязательные пользовательские поля портала [2]. Срок и связь с CRM нужно проверить отдельно; наличие текста «создал задачу» в ответе агента не подтверждает запись.
Два разных повтора: тот же клиент и то же событие
Это главное различие в проекте. Поиск контакта по телефону или email отвечает на вопрос «есть ли похожая запись?». Ключ события отвечает на другой: «обрабатывали ли мы именно это входящее сообщение?».
Битрикс24 документирует crm.duplicate.findbycomm: метод возвращает идентификаторы лидов, контактов и компаний по телефону или email [3]. Это не автоматическое подтверждение личности. Общая почта закупок может принадлежать нескольким людям; один человек может отправить новый запрос. В пилоте совпадение даёт кандидатов для решения, а не разрешение объединять карточки или перезаписывать контакт.
У метода есть ограничения: не более 20 значений за вызов; поиск без указания типа объекта при 20 и более найденных дублях одного типа может не вернуть другие типы [3]. Нельзя трактовать такой ответ как полный список всего портала. Права чтения тоже влияют на доступный контур: «не вижу» не означает «не существует».
На телефоне таблицу можно прокручивать по горизонтали.
| Ситуация | Решение пилота | Чего не делать |
|---|---|---|
| Тот же канал и ID, результат уже подтверждён | Вернуть сохранённые ID карточки и задачи | Повторно создавать объекты |
| Тот же ID, но содержимое изменилось | Остановить обработку и проверить конфликт | Молча принять изменённый текст |
| Новое событие, один найденный контакт | Показать кандидата менеджеру; после подтверждения связать новое обращение | Считать новый запрос старой доставкой |
| Несколько кандидатов или противоречивые контакты | Ручная проверка | Выбирать первого или объединять автоматически |
| Контакт не найден, источник и поля допустимы | Предложить новую карточку; запись после подтверждения | Обещать отсутствие дублей без проверки прав |
Для идемпотентности сохраняют ключ уровня организации, источника и события, например demo-org:mailbox-A:demo-0042, и отпечаток нормализованного пакета. Это проектное правило нашей схемы, не встроенная гарантия Битрикс24. Один email сам по себе не годится как ключ события: иначе вторая покупка того же клиента исчезнет.

Карточка создана, задача — ещё нет
Предположим, CRM приняла лид, но связь оборвалась до получения ответа. Повторить создание сразу — риск получить второй лид. Даже если ID лида уже сохранён, задача менеджеру может не создаться: это отдельная операция с отдельным результатом.
Нужен небольшой журнал состояний: received → reviewed → lead_confirmed → task_confirmed → completed. У каждой записи — ключ события, отпечаток пакета, решение проверяющего, ID лида, ID задачи и время последней проверки. Подтверждение относится к конкретным полям и действиям. Изменился ответственный или содержание после проверки — прежнее подтверждение не переносится автоматически.
При неизвестном результате система переходит в unknown, а не в «ошибка, можно повторить». Она сверяет доступные записи и технический журнал через согласованный маркер операции. Если определить исход невозможно, оператор разбирает событие; слепая повторная запись запрещена. Если лид подтверждён, а задача ещё не отправлялась, продолжают только шаг задачи. Если неизвестен исход создания самой задачи, сначала сверяют именно её.
В рабочей реализации потребуются устойчивое хранилище, уникальное ограничение ключа и защита от одновременных обработчиков. Сверка после сбоя должна учитывать срок видимости записи и права. Эти условия нельзя заменить обещанием «ровно один раз»: наш локальный пример проверяет правила выбора следующего действия, а не доказывает распределённую гарантию или работоспособность живой интеграции.
Что проверить на Битрикс24 до оценки работ
По состоянию документации на 13 ноября 2026 года старая страница crm.lead.add помечена deprecated и отсылает к REST 3.0 [4]. Имя метода может выглядеть знакомо, но это не разрешает смешивать форматы полей и ответов разных версий. Разработчик должен зафиксировать версию и подтвердить создание, чтение и связку объектов на тестовом контуре. Здесь нет готового API-запроса, который надо скопировать в рабочий портал.
Отдельно проверьте доступность REST для фактического тарифа, пробного периода и условий перехода: она не следует из самого наличия облачного аккаунта [5]. Уточните режим CRM, обязательные поля, права технического пользователя, допустимые очереди, лимиты и процедуру отзыва доступа. Не выдавайте агенту удаление, объединение контактов, массовое редактирование и отправку клиенту ради одного маршрута ввода.
Для компании в Казахстане добавьте три проверки. Во-первых, одинаковые товарные понятия в русских, казахских и смешанных сообщениях, без перевода имён и реквизитов «по смыслу». Во-вторых, единицы и валюты: «20» без подписи не должно стать суммой сделки. В-третьих, срок задачи задаётся с явным Asia/Almaty или согласованным смещением; расплывчатое «завтра» требует исходной даты и правила. Срок внутренней реакции — не обещанный клиенту срок доставки и не SLA GolemWorkers.
Определите, какие данные можно передавать модели, где хранится исходник, кто видит журнал и когда он удаляется. Это отдельная проверка вашей архитектуры и требований к данным, а не заключение о юридическом соответствии из статьи. Для первого разбора используйте обезличенные или синтетические примеры; пароли, webhook-секреты и клиентские документы в заявку на пилот не прикладывайте.
Артефакт для пилота: карта и восемь проверок
В пакете статьи есть локализованная пустая и заполненная карта полей, шаблон задания и небольшой Python-пример без сетевых вызовов. Он получает уже извлечённые поля, а не распознаёт письма моделью. Восемь синтетических проверок охватывают новую заявку, завершённый повтор, конфликт содержимого, отсутствие контакта, несколько кандидатов, неизвестный результат лида, продолжение после подтверждённого лида и неизвестный результат задачи. Запуск показывает ожидаемое следующее действие; он не создаёт объектов и не измеряет точность ИИ.
Перенесите эти ситуации в приёмку своего портала. Проверьте не только наличие карточки, но и точное количество, язык, источник, неизвестные поля и связь задачи. После прерывания убедитесь, что оператор может понять состояние без перечитывания всего диалога. Затем добавьте реальные обезличенные RU/KK-примеры, разрешённые владельцем данных, и отдельно измерьте ошибочные поля, пропущенные обращения, дубли, время проверки и необработанные исключения.
Согласуйте пороги до подключения записи. Любая запись без необходимого подтверждения, потеря исходника или неконтролируемое повторное создание — причина остановить этот маршрут и разобрать дефект. Успех нескольких демонстрационных примеров не доказывает качество на всей почте. Считать полезный эффект нужно по завершённым обращениям с учётом исправлений; для денег есть отдельный шаблон расчёта пилота в тенге.
Что передать на обсуждение пилота
Не обязательно разрабатывать отдельного агента для каждого нового поля. Универсальная агентная платформа, разрешённые инструменты, шаблоны извлечения и проверки могут переиспользоваться, когда подходят задаче. Настраивать всё равно придётся источник, объекты портала, права, справочники, правила дублей и восстановление после сбоя. Сотрудников нужно обучить проверять доказательства, исправлять поля и разбирать исключения. Переиспользование уменьшает повторную работу, но само по себе не подтверждает готовый коннектор или бесплатную интеграцию.
Опишите один CRM-сценарий для обсуждения с GolemWorkers: какая CRM и режим используются, откуда приходит обращение, какие поля нужны, кто подтверждает запись и что запрещено. Можно начать с синтетического сообщения и заполненной карты. Форма на русском. Следующий разумный шаг — проверить доступ и границы ограниченного пилота, а не обещать автономное ведение всей воронки.
Источники и границы примера
[1] Поля лида Битрикс24: описания, типы и пользовательские поля; конкретную версию проверяют перед реализацией.
[2] Создание задачи tasks.task.add: обязательные поля и связь с CRM.
[3] Поиск совпадений crm.duplicate.findbycomm: типы сущностей и ограничения ответа.
[4] Создание объекта CRM в REST 3.0 и старая страница создания лида: контракты нельзя смешивать.
[5] Доступ к REST API: проверка действующих условий конкретного аккаунта. Продуктовая рамка — B2B-предложение GolemWorkers.