Интеграция n8n с Битрикс24 позволяет автоматизировать одну из самых важных частей бизнеса — работу с клиентами. Вы можете автоматически создавать лиды и сделки из любых источников: новых писем на почте, сообщений в Telegram, заявок с сайта или строк в Google Таблице.
В отличие от некоторых других сервисов, в n8n нет отдельного готового узла для Битрикс24. Но интеграция легко настраивается с помощью универсального узла «HTTP Request». Ключом к подключению является специальная ссылка — вебхук (Webhook), которую мы получим в вашем портале Битрикс24.
Часть 1: Подготовительный этап в Битрикс24 — Создание вебхука
Вебхук — это уникальная и секретная ссылка, которая дает n8n право выполнять действия в вашем Битрикс24 от имени определенного пользователя.
- Перейдите в раздел для разработчиков. В левом меню вашего портала Битрикс24 найдите пункт «Приложения» и кликните по нему. В раскрывшемся списке выберите «Разработчикам».
- Найдите создание вебхуков. На открывшейся странице в верхнем меню выберите «Другое», а затем в списке — «Входящий вебхук».
- Настройте права доступа. Откроется окно настройки. Битрикс24 спросит, что именно вы разрешаете делать по этой ссылке. В разделе «Настройка прав» обязательно поставьте галочку напротив «CRM». Это даст n8n возможность создавать лиды, контакты, сделки и т.д.
- Скопируйте ссылку. После выбора прав нажмите кнопку «Сохранить». Система сгенерирует уникальную ссылку в поле «Вебхук для вызова REST API». Она будет выглядеть примерно так: https://ваш-портал.bitrix24.ru/rest/1/abracadabra12345/
- Это и есть ваш ключ! Скопируйте эту ссылку и сохраните в надежном месте. Относитесь к ней как к паролю.
Подготовительный этап завершен. Теперь у нас есть все для настройки n8n.
Часть 2: Настройка сценария в n8n
Давайте создадим практический пример: как только на определенную почту приходит новое письмо, n8n будет автоматически создавать лид в Битрикс24.
Шаг 1: Создание триггера
- Создайте новый рабочий процесс (workflow) в n8n.
- В качестве триггера добавьте узел «IMAP Email» (или любой другой, который вам нужен, например, «Telegram Trigger»). Настройте его на проверку вашего ящика для заявок.
Шаг 2: Добавление и настройка узла «HTTP Request»
- Нажмите на «+» после вашего триггера и добавьте узел «HTTP Request».
- Откройте его настройки и заполните поля следующим образом:
- Method: POST
- URL: В это поле нужно вставить ссылку, которую вы скопировали из Битрикс24, и добавить в конец название метода API, который вы хотите выполнить. Для создания лида это метод crm.lead.add. Итоговая ссылка будет выглядеть так: https://ваш-портал.bitrix24.ru/rest/1/abracadabra12345/crm.lead.add
- Body Content Type: JSON
- Body: В это поле мы передаем данные для создания лида. Нажмите "Add Field" и выберите "Name/Value pair".
- В поле Name введите fields.
- В поле Value нажмите на значок шестеренки и выберите "Add Expression". Вставьте туда следующий JSON-код:
- JSON
{
"TITLE": "Новая заявка с почты: {{$json.subject}}",
"NAME": "{{$json.from.name}}",
"EMAIL": [
{
"VALUE": "{{$json.from.address}}",
"VALUE_TYPE": "WORK"
}
],
"COMMENTS": "{{$json.text}}"
}
Шаг 3: Связываем данные (маппинг)
Теперь самое интересное. В коде выше вы видите конструкции вида {{$json.subject}}. Это выражения n8n, которые подставляют данные из предыдущих узлов.
- Удалите {{$json.subject}} и, не закрывая окно, перетащите на его место поле subject (тема письма) из данных вашего триггера (они будут видны в левой части экрана).
- Проделайте то же самое для полей NAME, EMAIL и COMMENTS, перетащив в них соответствующие данные из входящего письма.
- Нажмите "Execute Node" для проверки.
Если все настроено правильно, в вашем Битрикс24 появится новый лид с данными из тестового письма. Теперь остается только активировать весь сценарий.
Итог
Интеграция n8n с Битрикс24 — это мощнейший инструмент для автоматизации продаж и клиентского сервиса. Процесс всегда одинаков:
- Создать вебхук в Битрикс24 с нужными правами.
- Использовать узел HTTP Request в n8n.
- Сформировать URL, добавив к вебхуку нужный метод API (например, crm.deal.add для сделок или crm.contact.add для контактов).
- Передать данные в поле Body, связав их с вашим триггером.
Освоив этот принцип, вы сможете автоматизировать практически любое действие в вашем CRM-портале.