Настройка связки Bitrix24 (Открытые линии) + n8n + Чат-бот

1. Общее описание задачи

Требуется настроить корректную двустороннюю передачу сообщений между Открытыми линиями Битрикс24 и n8n через вебхуки (или локальное приложение).

Цель: При обращении клиента в любой канал Открытых линий (WhatsApp, Telegram, Jivo, Онлайн-чат и т.д.), сообщение должно улетать в n8n, обрабатываться там (ИИ/логика), и ответ должен возвращаться клиенту в тот же диалог Битрикс24 от имени бота. Также бот должен уметь искать товары в каталоге и отправлять карточку/ссылку клиенту.

2. Что уже есть

CMS/CRM: Битрикс24 (коробочная версия). Интернет-магазин детской одежды на 1С-Битрикс (БУС) или Битрикс24.

Сервер: n8n развернут на собственном сервере.

Текущий статус n8n:

Настроены воркфлоу для обработки текста, аудио и фото.

В Telegram (напрямую) всё работает отлично.

Проблема: При попытке подключить Открытые линии Битрикс24 через исходящие вебхуки, сообщения либо не приходят, либо ответ не доставляется, либо теряется контекст диалога.

3. Технические требования к исполнителю

А. Настройка транспорта (Bitrix24 <-> n8n)

Реализовать подписку на события Открытых линий (обычно это событие OnImBotMessageAdd или настройка специального коннектора).

Настроить фильтрацию: бот должен реагировать только на сообщения клиентов, игнорируя системные уведомления и свои собственные сообщения (защита от зацикливания).

Обеспечить передачу ID чата и ID пользователя в n8n для сохранения контекста беседы.

Настроить отправку ответа из n8n обратно в Битрикс24 (метод imbot.message.add или аналогичный актуальный).

Б. Функционал поиска товаров

В n8n настроить ветку сценария: если интент клиента «Поиск товара», n8n должен делать запрос к сайту.

Метод поиска:

Вариант А (API): Использовать REST API Битрикса для поиска товара по названию/артикулу.

Вариант Б (SQL/XML): Если API недоступен, предложить вариант подключения к базе данных или выгрузке.

Формат ответа: Бот должен присылать клиенту Название товара + Цену + Ссылку на товар (и, желательно, фото, если Битрикс позволяет передавать медиа в этот канал).

4. Критерии приемки работы (DoD)

Тест диалога: Я пишу в чат на сайте (виджет Битрикс24) «Привет, нужна куртка». Сообщение уходит в n8n -> ИИ генерирует ответ -> Ответ появляется в виджете.

Тест товара: Я пишу «Есть красная шапка?». Бот находит товар на сайте и присылает ссылку на него в чат.

Стабильность: При одновременном написании 2-3 сообщений бот не падает и отвечает каждому в его ветке.