Интеграция с CRM

Поддерживаемые CRM-системы

На данный момент aiWarmUp поддерживает интеграцию с Bitrix24. Интеграция позволяет как читать данные из CRM, так и записывать обогащённые лиды обратно.

Настройка подключения

Для работы с CRM необходимо создать подключение:

1. Перейдите в раздел настроек CRM-подключений.
2. Нажмите “Добавить подключение”.
3. Выберите тип CRM (Bitrix24).
4. Укажите адрес вашего портала Bitrix24 и авторизационные данные (вебхук-токен).
5. Проверьте подключение и сохраните.

Подключение хранится в зашифрованном виде. Один аккаунт может иметь несколько подключений к разным порталам Bitrix24.

CRM Search — поиск в CRM

Процессор CRM Search позволяет искать существующие записи в вашей CRM-системе. Это полезно для проверки дубликатов, получения актуальных данных или поиска сущностей по определённым критериям.

Типы сущностей

CRM Search поддерживает поиск по следующим типам сущностей:

Тип	Описание
lead	Лиды
deal	Сделки
company	Компании
contact	Контакты
requisite	Реквизиты

Условия поиска

Для каждого типа сущности можно задать условия поиска по любым полям. Доступные операторы:

• equals — точное совпадение
• not_equals — не равно
• in — значение из списка
• not_in — значение не из списка
• is_null — поле пустое
• is_not_null — поле заполнено

В значениях условий можно использовать переменные: {{search.inn}}, {{enrichment.companyName}}.

Связанные сущности

CRM Search поддерживает поиск с учётом связанных сущностей. Например, можно найти все сделки, у которых есть связанная компания с определённым ИНН.

Доступные типы связей:

• has — сущность имеет связанную запись, удовлетворяющую условиям.
• not_has — сущность не имеет связанной записи с заданными условиями.

Допустимые связи между сущностями:

• Сделка: компания, контакт
• Лид: компания, контакт
• Компания: сделка, контакт, реквизит, лид
• Контакт: сделка, компания, реквизит, лид
• Реквизит: компания, контакт

Формат результатов

Результат поиска можно настроить:

• count_only — только количество найденных записей.
• first_row — первая найденная запись.
• all_rows — все найденные записи (каждая как отдельный DataPacket).
• limit_rows — ограниченное количество записей.

Расширение справочных полей

По умолчанию система автоматически расширяет справочные поля: вместо числового ID статуса, категории или ответственного пользователя в результатах появится читаемое текстовое название. Для каждого такого поля создаётся дополнительное поле с суффиксом Label.

CRM Update — запись в CRM

Процессор CRM Update позволяет создавать, обновлять или выполнять upsert (создание или обновление) записей в CRM на основе обработанных данных.

Типы операций

Операция	Описание
create	Всегда создаёт новую запись
update	Обновляет существующую запись по условиям поиска
upsert	Ищет запись по условиям; если находит — обновляет, если нет — создаёт новую

Условия поиска (Lookup)

Для операций update и upsert необходимо задать условия поиска существующей записи. Обычно это уникальный идентификатор — ИНН, email или внешний ID.

Маппинг полей

Маппинг определяет, какие данные записать в какие поля CRM-сущности. В значениях используются переменные шаблонов:

Название: {{search.companyName}}
ИНН: {{search.inn}}
Телефон: {{enrichment.phone}}
Источник: "aiWarmUp Pipeline"

Связанные сущности

При записи в CRM можно одновременно создавать или обновлять связанные сущности. Например, при создании компании можно сразу создать для неё контакт и реквизит.

Поддерживается до 3 уровней вложенности связанных сущностей и до 3 связанных сущностей на каждом уровне.

Для каждой связанной сущности отдельно задаются:

• Тип сущности (компания, контакт, сделка и т.д.)
• Тип операции (create, update, upsert)
• Условия поиска (для update/upsert)
• Маппинг полей

Комментарии в Timeline

При создании или обновлении сущности можно автоматически добавить комментарий в Timeline (историю) записи. В тексте комментария поддерживаются переменные шаблонов.

Поведение при ошибках

Настраивается поведение в нештатных ситуациях:

• Запись не найдена (при update): пропустить, создать ошибку или создать новую запись.
• Найдено несколько записей: обновить первую, обновить все (до 10) или пропустить.

Практический пример

Типичная цепочка работы с CRM:

search --> enrichment --> gptFilter --> crmUpdate

1. search — находит компании по критериям.
2. enrichment — обогащает данные: ИНН, контакты, финансы.
3. gptFilter — ИИ оценивает релевантность и генерирует персонализированное обращение.
4. crmUpdate — создаёт лид в Bitrix24 с заполненными полями и комментарием.

Конфигурация CRM Update в этом случае:

• Тип сущности: lead
• Операция: upsert
• Условие поиска: ИНН equals {{enrichment.inn}}
• Маппинг полей: название, ИНН, телефон, email, источник
• Связанная сущность: контакт (upsert по email)
• Комментарий: персонализированное обращение от gptFilter

Следующие шаги

• Переменные шаблонов — как ссылаться на данные при маппинге полей CRM
• Связывание процессоров — как встроить CRM-процессоры в цепочку обработки