Как подключить Битрикс24 к n8n с помощью коннектора BitBot
Для передачи данных в n8n используется инструмент "Произвольный API", который не ожидает ответа от n8n.
Соответственно, чтобы бот написал ответ в чат битрикс24 в n8n нужно будет использовать исходящий вебхук с методом "imbot.message.add"
Подготовка на стороне n8n
- В n8n создайте ноду "Входящий вебхук"
- Установите HTTP Method - POST
- Скопируйте Webhook URL - Test URL
- Нажмите кнопку "Listen for test event"
На стороне Битрикс24 сначала добавьте коннектор с вашим адресом:
- Установите приложение BitBot на свой портал
- Откройте приложение и перейдите в раздел "Коннекторы"
- Нажмите кнопку "Добавить"
- В поле "Провайдер" выберите "Произвольный API"
- В поле "URL" вставьте адрес Webhook URL из n8n
- В поле "Key" введите произвольное значение, оно нужно для заполнения формы
- Нажмите "Сохранить" и перейдите в раздел "Чат-боты"
Теперь создайте чат-бота
- Поле "Имя" (name) - заполните произвольно
- Тип бота (Bot type) - например, "Супервизор"
- Битрикс24 - выберите нужный вам портал
- В поле "Коннектор" (Connector) выберите созданный только что коннектор с адресом n8n
- Нажмите "Сохранить"
Тестирование чат-бота
- Перейдите в раздел "Мессенджер" в битрикс24 https://b24-XXX.bitrix24.kz/online/
- В строке "Поиск" введите имя вашего бота, например, Bitbot
- Введите текст сообщения и отправьте его
Если вcё сделано правильно, то в поле "Output" в n8n вы уведите входящий массив данных
Входящий массив данных в событии ONIMBOTMESSAGEADD содержит все необходимые данные, включая токены и адрес портала, для выполнения любых действий на стороне Битркис24 и последующего ответа в чат, если потребуется
[
{
"headers": {
"host": "gulin.app.n8n.cloud",
"user-agent": "Bitrix24 Webhook Engine",
"content-length": "4735",
"accept-encoding": "gzip, br",
"cdn-loop": "cloudflare; loops=1; subreqs=1",
"cf-connecting-ip": "195.208.184.200",
"cf-ew-via": "15",
"cf-ipcountry": "RU",
"cf-ray": "9e3ed82a196c3a50-HEL",
"cf-visitor": "{\"scheme\":\"https\"}",
"cf-worker": "n8n.cloud",
"content-type": "application/x-www-form-urlencoded",
"x-forwarded-for": "195.208.184.200, 172.64.223.63",
"x-forwarded-host": "gulin.app.n8n.cloud",
"x-forwarded-port": "443",
"x-forwarded-proto": "https",
"x-forwarded-server": "traefik-prod-users-gwc-82-75c849957f-j9zhk",
"x-is-trusted": "yes",
"x-real-ip": "195.208.184.200"
},
"params": {},
"query": {},
"body": {
"event": "ONIMBOTMESSAGEADD",
"event_handler_id": "70",
"data[BOT][22][access_token]": "bf27c969007f15dc0082660a00000016201c071d6c6fbbf01925c1c948b1dd07a63797",
"data[BOT][22][expires]": "1774790591",
"data[BOT][22][expires_in]": "3600",
"data[BOT][22][scope]": "crm,task,entity,im,user_basic,calendar,log,disk,bizproc,imbot,documentgenerator,booking,socialnetwork,lists,department,user.userfield,sonet_group,imopenlines,messageservice,pull,im.import",
"data[BOT][22][domain]": "b24-hyauuu.bitrix24.kz",
"data[BOT][22][server_endpoint]": "https://oauth.bitrix24.tech/rest/",
"data[BOT][22][status]": "F",
"data[BOT][22][client_endpoint]": "https://b24-hyauuu.bitrix24.kz/rest/",
"data[BOT][22][member_id]": "2bbfde87ebb9981ab2a39259adf36165",
"data[BOT][22][refresh_token]": "afa6f069007f15dc0082660a00000016201c077848cb9e3b812b200a38f0935b416eb0",
"data[BOT][22][user_id]": "22",
"data[BOT][22][client_id]": "app.694168c360b812.97065760",
"data[BOT][22][application_token]": "22c2ae274b847907f51a0bfb29fabe9a",
"data[BOT][22][AUTH][access_token]": "bf27c969007f15dc0082660a00000016201c071d6c6fbbf01925c1c948b1dd07a63797",
"data[BOT][22][AUTH][expires]": "1774790591",
"data[BOT][22][AUTH][expires_in]": "3600",
"data[BOT][22][AUTH][scope]": "crm,task,entity,im,user_basic,calendar,log,disk,bizproc,imbot,documentgenerator,booking,socialnetwork,lists,department,user.userfield,sonet_group,imopenlines,messageservice,pull,im.import",
"data[BOT][22][AUTH][domain]": "b24-hyauuu.bitrix24.kz",
"data[BOT][22][AUTH][server_endpoint]": "https://oauth.bitrix24.tech/rest/",
"data[BOT][22][AUTH][status]": "F",
"data[BOT][22][AUTH][client_endpoint]": "https://b24-hyauuu.bitrix24.kz/rest/",
"data[BOT][22][AUTH][member_id]": "2bbfde87ebb9981ab2a39259adf36165",
"data[BOT][22][AUTH][refresh_token]": "afa6f069007f15dc0082660a00000016201c077848cb9e3b812b200a38f0935b416eb0",
"data[BOT][22][AUTH][user_id]": "22",
"data[BOT][22][AUTH][client_id]": "app.694168c360b812.97065760",
"data[BOT][22][AUTH][application_token]": "22c2ae274b847907f51a0bfb29fabe9a",
"data[BOT][22][BOT_ID]": "22",
"data[BOT][22][BOT_CODE]": "bitbot_28",
"data[PARAMS][MESSAGE]": "Текст сообщения",
"data[PARAMS][TEMPLATE_ID]": "0caeed69-41d4-43a9-9393-4aa50d2db7d6",
"data[PARAMS][MESSAGE_TYPE]": "P",
"data[PARAMS][FROM_USER_ID]": "1",
"data[PARAMS][DIALOG_ID]": "1",
"data[PARAMS][TO_CHAT_ID]": "20",
"data[PARAMS][AUTHOR_ID]": "1",
"data[PARAMS][SYSTEM]": "N",
"data[PARAMS][TO_USER_ID]": "22",
"data[PARAMS][PUSH]": "Y",
"data[PARAMS][PUSH_IMPORTANT]": "N",
"data[PARAMS][RECENT_SKIP_AUTHOR]": "N",
"data[PARAMS][CONVERT]": "N",
"data[PARAMS][SKIP_COMMAND]": "N",
"data[PARAMS][SKIP_COUNTER_INCREMENTS]": "N",
"data[PARAMS][SILENT_CONNECTOR]": "N",
"data[PARAMS][SKIP_CONNECTOR]": "N",
"data[PARAMS][IMPORTANT_CONNECTOR]": "N",
"data[PARAMS][NO_SESSION_OL]": "N",
"data[PARAMS][FAKE_RELATION]": "0",
"data[PARAMS][SKIP_URL_INDEX]": "N",
"data[PARAMS][COMMAND_CONTEXT]": "TEXTAREA",
"data[PARAMS][CHAT_USER_COUNT]": "2",
"data[PARAMS][PLATFORM_CONTEXT]": "web",
"data[PARAMS][MESSAGE_ID]": "98",
"data[PARAMS][CHAT_TYPE]": "P",
"data[PARAMS][LANGUAGE]": "ru",
"data[USER][ID]": "1",
"data[USER][NAME]": "xagix44287@inupup.com",
"data[USER][FIRST_NAME]": "xagix44287@inupup.com",
"data[USER][LAST_NAME]": "",
"data[USER][GENDER]": "M",
"data[USER][IS_BOT]": "N",
"data[USER][IS_CONNECTOR]": "N",
"data[USER][IS_NETWORK]": "N",
"data[USER][IS_EXTRANET]": "N",
"ts": "1774786991",
"auth[access_token]": "bf27c969007f15dc0082660a0000000100000760d07a0f4f9c98275bbde095e85edc84",
"auth[expires]": "1774790591",
"auth[expires_in]": "3600",
"auth[scope]": "crm,task,entity,im,user_basic,calendar,log,disk,bizproc,imbot,documentgenerator,booking,socialnetwork,lists,department,user.userfield,sonet_group,imopenlines,messageservice,pull,im.import",
"auth[domain]": "b24-hyauuu.bitrix24.kz",
"auth[server_endpoint]": "https://oauth.bitrix24.tech/rest/",
"auth[status]": "F",
"auth[client_endpoint]": "https://b24-hyauuu.bitrix24.kz/rest/",
"auth[member_id]": "2bbfde87ebb9981ab2a39259adf36165",
"auth[user_id]": "1",
"auth[refresh_token]": "afa6f069007f15dc0082660a00000001000007eb5bc5dde3b0001423945ed53be1f4e7",
"auth[application_token]": "22c2ae274b847907f51a0bfb29fabe9a"
},
"webhookUrl": "https://gulin.app.n8n.cloud/webhook-test/5a6d7de0-6df6-4fc4-847b-5fb20d32ab61",
"executionMode": "test"
}
]Шаблон эхо-бота на базе n8n для коннектора BitBot
После публикации в n8n используйте Webhook URL - Production URL из настроек входящего вебхука n8n
- Скачайте архив с json bitbot-echo
- Распакуйте архив и импортируйте его в n8n
- Опубликуйте и создайте бота в битрикс с Production URL
{
"name": "bitbot - echo",
"nodes": [
{
"parameters": {
"httpMethod": "POST",
"path": "b75c9d02-b323-4d22-b455-eae37775ec20",
"options": {}
},
"type": "n8n-nodes-base.webhook",
"typeVersion": 2.1,
"position": [
0,
0
],
"id": "c245ed63-1cca-4368-9ff0-85e4a100f356",
"name": "Webhook",
"webhookId": "b75c9d02-b323-4d22-b455-eae37775ec20"
},
{
"parameters": {
"method": "POST",
"url": "={{ $('Webhook').item.json.body['auth[client_endpoint]'] }}/imbot.message.add",
"sendBody": true,
"bodyParameters": {
"parameters": [
{
"name": "BOT_ID",
"value": "={{ $json.body['data[PARAMS][TO_USER_ID]'] }}"
},
{
"name": "DIALOG_ID",
"value": "={{ $('Webhook').item.json.body['data[PARAMS][DIALOG_ID]'] }}"
},
{
"name": "MESSAGE",
"value": "={{ $json.body['data[PARAMS][MESSAGE]'] }}"
},
{
"name": "auth",
"value": "={{ $json.body['auth[access_token]'] }}"
}
]
},
"options": {}
},
"type": "n8n-nodes-base.httpRequest",
"typeVersion": 4.4,
"position": [
432,
-16
],
"id": "e8d5dddd-cbfd-4177-ad13-40bdb977d654",
"name": "HTTP Request"
},
{
"parameters": {
"conditions": {
"options": {
"caseSensitive": true,
"leftValue": "",
"typeValidation": "strict",
"version": 3
},
"conditions": [
{
"id": "f48de798-f130-41fa-8bb7-d5372960f44d",
"leftValue": "={{ $json.body.event }}",
"rightValue": "ONIMBOTMESSAGEADD",
"operator": {
"type": "string",
"operation": "equals"
}
}
],
"combinator": "and"
},
"options": {}
},
"type": "n8n-nodes-base.if",
"typeVersion": 2.3,
"position": [
208,
0
],
"id": "df49d114-0cd1-4733-a79c-b0b80417cea4",
"name": "If"
}
],
"pinData": {},
"connections": {
"Webhook": {
"main": [
[
{
"node": "If",
"type": "main",
"index": 0
}
]
]
},
"If": {
"main": [
[
{
"node": "HTTP Request",
"type": "main",
"index": 0
}
]
]
}
},
"active": true,
"settings": {
"executionOrder": "v1",
"binaryMode": "separate"
},
"versionId": "8410439f-44ee-4b56-bf73-a7492411890c",
"meta": {
"templateCredsSetupCompleted": true,
"instanceId": "91c773dbc7eeac0673f50a5c47a443eddfff15213443b28cddb65e94fae5eb7b"
},
"id": "obRmiSY1pctdZRD0",
"tags": []
}Обновлено: 29.03.2026 20:00