n8n и Битрикс24: прочитать учебные сделки через API
Подключение Битрикс24 к n8n через HTTP Request: вебхук, crm.item.list, фильтр учебных сделок и проверка ответа.
Перед тем как автоматически обрабатывать сделки Битрикс24, проверь простое чтение из CRM. Соберём в n8n ручной запрос, который вернёт только две учебные сделки и два поля. В рабочем процессе это первый этап перед сводкой; ни изменения стадий, ни отправки сообщений в примере нет.
1. Подготовь учебные сделки и доступ
Нужны n8n и тестовый портал Битрикс24 с доступным REST API. Попроси администратора подтвердить возможность интеграции на вашем плане и права пользователя. В отдельной тестовой среде создай вручную две сделки с одинаковым названием «Учебная заявка APC». Не добавляй контакты клиентов. Запиши их реальные ID из CRM — они понадобятся для проверки.
Для локальной интеграции используем входящий вебхук Битрикс24. Он даёт внешней системе возможность вызвать API от имени пользователя. Это не Webhook Trigger в n8n: сейчас n8n сам отправляет запрос в CRM.
По официальной инструкции Битрикс24, создай входящий вебхук в разделе ресурсов разработчика, выдай область CRM и проверь права его владельца. По возможности используй пользователя с чтением нужных тестовых объектов. Секретный URL считай паролем.
2. Собери Manual Trigger и HTTP Request
Создай новый workflow: Manual Trigger → HTTP Request. В HTTP Request задай POST. В URL укажи адрес вызова метода crm.item.list, сформированный на основе своего входящего вебхука. Скопируй адрес из инструмента проверки методов Битрикс24, убедившись, что выбран именно этот метод.
При авторизации через секрет в URL поле Authentication в n8n оставь None: доступ уже закодирован в адресе. Это не означает, что запрос публичный. Не публикуй workflow с таким URL и не показывай его в записи экрана; для постоянной интеграции согласуй хранение секрета и права доступа с администратором.
Включи Send Body, выбери JSON и вставь тело:
{
"entityTypeId": 2,
"select": ["id", "title"],
"filter": {"=title": "Учебная заявка APC"},
"order": {"id": "ASC"},
"start": 0
}Число 2 означает сделки. select ограничивает поля, а filter — набор объектов. Метод crm.item.list описан в универсальном API CRM. Для этого сценария не нужны методы создания, обновления или удаления.
3. Выполни запрос и сверь ID
Запусти workflow вручную. В ответе найди result.items: это список найденных объектов. Если в тестовой среде существуют ровно две доступные владельцу вебхука сделки с указанным названием, ожидаются две записи с их ID и заголовками.
Не копируй случайные числа из чужого примера. Сравни вернувшиеся ID с теми, которые ты записал в CRM. Затем проверь, что в настройках по-прежнему указан метод чтения и что запрос не содержит телефон, email или другие ненужные поля.
| Проверка | Ожидание для упражнения |
|---|---|
| Метод | crm.item.list |
| Тип объекта | Сделки, entityTypeId 2 |
| Отбор | Только точное учебное название |
| Результат | Два известных ID при выполнении исходных условий |
| Поля | id и title согласно запросу |
Это ожидаемый результат по подготовленным данным. Подключение к порталу в рамках статьи не выполнялось, поэтому реальный ответ сервера здесь не приводится.
4. Разбери пустой ответ и ошибки
Пустой список не всегда означает, что сделок нет. Метод учитывает права чтения пользователя. Проверь точность названия, тип CRM-объекта, портал и права владельца вебхука. Не расширяй фильтр на все сделки, пока не понял причину расхождения.
Если сервер вернул error или error_description, остановись и сохрани текст без секретного URL. Ошибки доступа, недоступность REST по условиям аккаунта и неверный адрес требуют разных исправлений. Повторять тот же запрос каждую секунду не поможет.
В большом наборе может появиться next: для следующей страницы его значение передают как start. Одну страницу нельзя считать полной выгрузкой. В нашем упражнении всего две записи; автоматическую пагинацию добавляют отдельным этапом.
5. Подготовь данные для следующего шага
Когда чтение проверено, можно передать массив в Split Out, чтобы работать с каждой сделкой отдельно. Сначала используй учебные данные. Не подключай ИИ к полным карточкам клиентов без необходимости и согласованных правил обработки.
Моя рекомендация: принимать интеграцию по известным ID и явному фильтру. Зелёный статус узла подтверждает выполнение запроса, но не то, что ты получил нужные сделки.
Для другой CRM есть пример чтения лидов amoCRM. На курсе по агентам разбираем сборку автоматизаций с проверяемыми результатами. Инструкция сверена с документацией; тело JSON проверено синтаксически, реальный запрос к Битрикс24 не отправлялся.
Собери своего ИИ-агента и проверь результат
«AI Agents: от vibe coding к AI-команде»: desktop agents, MCP, skills, evals и harness. Отдельные воркшопы — от подключения инструментов до контроля качества.
7 практических воркшопов · записи · вопросы автору в чате
Посмотреть программу курса ↗