Как подключить ИИ к Битрикс24: данные, права и первый безопасный сценарий

Выберите объект и событие

В Битрикс24 есть разные сущности CRM и разные события. «Пусть ИИ работает с CRM» не указывает, что читать и что менять. Запишите точную цепочку: новое сообщение из канала → поиск существующего контакта → извлечение темы и телефона → черновик элемента CRM → проверка менеджером. На схеме отметьте, где появится ошибка и кто её увидит.

Возьмите 20 недавних заявок, в том числе неполные и повторные. Сверьте поля: имя, канал, телефон, продукт, город, комментарий, ответственный. Если сотрудники сейчас по-разному заполняют одну колонку, интеграция закрепит хаос. Сначала договоритесь о значении каждого поля и обязательных данных.

Права и технический доступ

Используйте отдельный технический доступ с минимальными правами к нужным объектам. Не передавайте интеграции права администратора ради экономии времени. Ключ или webhook-адрес не должен попадать в публичный код сайта, письма и журналы ошибок. Назначьте владельца доступа и способ его отзыва.

В официальной документации Битрикс24 для `crm.item.add` описаны тип объекта, поля и обработка ошибок. Разработчику нужно сверить конкретные поля с вашим порталом: пользовательские поля и стадии могут отличаться. Не копируйте пример запроса из документации как готовую схему вашей CRM.

Как избежать дублей

Перед созданием карточки проверяйте внешний идентификатор сообщения, номер телефона в согласованном формате и уже открытые обращения. Если клиент пишет из Telegram, потом с сайта, это может быть один человек с двумя каналами. Но автоматически объединять записи лишь по похожему имени опасно: разные клиенты могут быть тёзками.

Практическое правило: интеграция предлагает совпадение с указанием основания, а человек подтверждает сомнительный случай. Для технического повтора события храните идентификатор операции: повторная доставка не должна создать вторую заявку. Разделите ошибки связи и ошибки смысла — это разные задачи для исправления.

Минимальный пилот на одном процессе

Пилот можно ограничить входящими обращениями об одной услуге. ИИ читает текст, выделяет продукт и срочность, предлагает ответственного и готовит краткое резюме. Менеджер видит исходный текст рядом с предложенными полями и исправляет их перед сохранением. Сравните время на обработку и число исправлений с обычной работой на похожих заявках.

После сохранения карточки нужно проверить уведомление менеджеру. Успешный API-ответ ещё не означает, что нужный человек увидел задачу и связался с клиентом. Пройдите путь до первого реального действия, а не до зелёного статуса интеграции.

Ошибки, которые заметны только после запуска

Частая проблема — пользовательские поля меняют название или правила заполнения, а интеграция продолжает отправлять прежнюю структуру. Другая — менеджер переносит сделку на новую стадию, а автоматизация снова возвращает её назад. Зафиксируйте, какие поля ИИ может создавать, какие только предлагать и какие вообще не трогает.

Собирайте журнал с идентификатором события, итогом записи, кодом ошибки и временем. Личные данные в журнале ограничивайте. Еженедельно проверяйте выборку карточек, где ИИ ошибся, где менеджер исправил поле и где заявка зависла без ответственного. Это поможет решить, расширять ли сценарий.

Когда интеграция не решит проблему

Если заявки уже попадают в Битрикс24, но менеджеры не открывают задачи, ИИ не заменит управление отделом. Если неверны сами правила назначения, автоматический маршрутизатор ускорит ошибку. В таком случае сначала исправьте процесс и только потом поручайте машине его повторять.

Что передать разработчику до доступа к CRM

Подготовьте не только список полей, но и десять обезличенных примеров со спорными случаями: повторный клиент, два товара в одном сообщении, пропущенный телефон, вопрос без намерения купить. Для каждого укажите желаемый результат в Битрикс24 и кто его проверит. Это уменьшает риск, что подрядчик настроит интеграцию на идеальной демонстрационной заявке, а реальные обращения начнут создавать пустые сделки.

Зафиксируйте, что происходит при отключении интеграции: исходный канал продолжает принимать сообщения, а команда видит очередь необработанных обращений. План восстановления нужен до запуска, особенно если заявки приходят вечером и в выходные.

Пограничный случай: два контакта у одной компании

Секретарь оставил общий телефон, а закупщик написал с личного номера. Автоматическое объединение по названию компании может оказаться верным, но может смешать разные проекты. Система показывает менеджеру возможную связь и основания: совпадает организация, продукт, период обращения. Менеджер подтверждает или отклоняет объединение. Важно сохранять историю обоих каналов и не раскрывать одному контакту данные другого без соответствующего права.

Что спросить у владельца портала

Какая сущность считается новой заявкой, кто назначается ответственным, какие поля обязательны и какие стадии уже используются командой? Есть ли тестовый контур, где можно создать карточки без уведомления реальных сотрудников? Что происходит с задачей, если ответственный отсутствует? Эти вопросы кажутся организационными, но определяют работу интеграции. Без ответов разработчик может технически успешно создавать карточки, которые отдел продаж не видит.

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