[{"data":1,"prerenderedAt":775},["ShallowReactive",2],{"blog-\u002Fblog\u002Frest-api-bitrix24-vebhuki":3},{"id":4,"title":5,"body":6,"category":764,"date":765,"description":766,"extension":767,"meta":768,"navigation":769,"path":770,"readingTime":771,"seo":772,"stem":773,"__hash__":774},"blog\u002Fblog\u002Frest-api-bitrix24-vebhuki.md","Вебхуки и REST API Битрикс24: что можно автоматизировать без разработчика",{"type":7,"value":8,"toc":733},"minimark",[9,13,18,34,37,44,50,53,57,83,90,93,97,273,283,287,292,298,301,305,311,319,323,326,330,336,340,350,354,357,361,371,375,378,384,390,396,402,408,414,417,421,513,516,520,564,568,582,588,594,600,606,612,616,642,645,649,653,656,660,663,667,673,677,680,684,694,698,704,708,711],[10,11,12],"p",{},"Вебхук в Битрикс24 - это персональная ссылка, по которой внешняя программа обращается к вашему порталу и выполняет действия: создаёт сделку, читает список контактов, ставит задачу. Создаётся он за две минуты в разделе для разработчиков, кода писать не нужно. Дальше этой ссылкой пользуются сервисы автоматизации, таблицы, сайт или скрипт. Без разработчика реально закрыть заметный пласт задач: приём заявок с сайта, выгрузку данных в таблицу, уведомления, простой обмен с внешними сервисами. Всё, что сложнее регулярного обмена и обработки ошибок, всё-таки требует программиста.",[14,15,17],"h2",{"id":16},"что-такое-rest-api-и-вебхук-простыми-словами","Что такое REST API и вебхук простыми словами",[10,19,20,21,25,26,29,30,33],{},"REST API - это набор адресов, по которым можно попросить Битрикс24 что-то сделать. Каждый адрес соответствует методу: ",[22,23,24],"code",{},"crm.deal.add"," создаёт сделку, ",[22,27,28],{},"crm.contact.list"," возвращает список контактов, ",[22,31,32],{},"tasks.task.add"," создаёт задачу. Запрос отправляется обычным HTTP-обращением, ответ приходит в формате JSON.",[10,35,36],{},"Вебхук бывает двух видов, и их постоянно путают.",[10,38,39,43],{},[40,41,42],"strong",{},"Входящий вебхук"," - ссылка, по которой внешняя система обращается к Битрикс24. Вы даёте эту ссылку сервису, и он создаёт или читает данные на вашем портале.",[10,45,46,49],{},[40,47,48],{},"Исходящий вебхук"," - наоборот. Битрикс24 сам отправляет данные на указанный вами адрес, когда происходит событие: создана сделка, изменена стадия, добавлен контакт.",[10,51,52],{},"Для большинства задач без разработчика нужен входящий вебхук. Исходящий требует, чтобы на другой стороне что-то принимало запрос, а это уже либо сервис автоматизации, либо своя программа.",[14,54,56],{"id":55},"как-создать-вебхук-пошагово","Как создать вебхук: пошагово",[58,59,60,64,67,70,73,80],"ol",{},[61,62,63],"li",{},"Откройте раздел для разработчиков. В большинстве порталов путь такой: левое меню, «Приложения», затем «Разработчикам». В части конфигураций пункт называется «Ресурсы разработчика».",[61,65,66],{},"Выберите создание входящего вебхука.",[61,68,69],{},"Задайте описание, чтобы через полгода понимать, кому эта ссылка выдана: «Выгрузка сделок в таблицу», «Формы с сайта».",[61,71,72],{},"Отметьте права доступа. Выдавайте только нужные: CRM, задачи, пользователи, диск. Не ставьте все галочки подряд.",[61,74,75,76,79],{},"Сохраните. Портал покажет готовую ссылку вида ",[22,77,78],{},"https:\u002F\u002Fваш-портал.bitrix24.ru\u002Frest\u002F1\u002Fтокен\u002F",".",[61,81,82],{},"Скопируйте ссылку и сохраните её в надёжном месте. Она равносильна паролю от данных портала в пределах выданных прав.",[10,84,85,86,89],{},"Проверить работу можно прямо в браузере: добавьте к ссылке метод, например ",[22,87,88],{},"profile",", и откройте адрес. Если вернулся JSON с вашим профилем, вебхук работает.",[10,91,92],{},"Важный нюанс: вебхук работает от имени того сотрудника, который его создал, и видит ровно то, что видит этот сотрудник. Создавайте вебхуки от учётной записи с нужным уровнем доступа, а не от личного аккаунта сотрудника, который может уволиться.",[14,94,96],{"id":95},"методы-которые-нужны-чаще-всего","Методы, которые нужны чаще всего",[98,99,100,116],"table",{},[101,102,103],"thead",{},[104,105,106,110,113],"tr",{},[107,108,109],"th",{},"Задача",[107,111,112],{},"Метод",[107,114,115],{},"Что делает",[117,118,119,132,145,158,171,184,196,208,221,234,247,260],"tbody",{},[104,120,121,125,129],{},[122,123,124],"td",{},"Создать сделку",[122,126,127],{},[22,128,24],{},[122,130,131],{},"Добавляет сделку с полями",[104,133,134,137,142],{},[122,135,136],{},"Получить список сделок",[122,138,139],{},[22,140,141],{},"crm.deal.list",[122,143,144],{},"Возвращает сделки с фильтром",[104,146,147,150,155],{},[122,148,149],{},"Обновить сделку",[122,151,152],{},[22,153,154],{},"crm.deal.update",[122,156,157],{},"Меняет поля существующей сделки",[104,159,160,163,168],{},[122,161,162],{},"Создать лид",[122,164,165],{},[22,166,167],{},"crm.lead.add",[122,169,170],{},"Добавляет лид",[104,172,173,176,181],{},[122,174,175],{},"Создать контакт",[122,177,178],{},[22,179,180],{},"crm.contact.add",[122,182,183],{},"Добавляет контакт",[104,185,186,189,193],{},[122,187,188],{},"Найти контакт",[122,190,191],{},[22,192,28],{},[122,194,195],{},"Поиск по телефону, почте, полям",[104,197,198,201,205],{},[122,199,200],{},"Создать задачу",[122,202,203],{},[22,204,32],{},[122,206,207],{},"Ставит задачу с ответственным и сроком",[104,209,210,213,218],{},[122,211,212],{},"Список пользователей",[122,214,215],{},[22,216,217],{},"user.get",[122,219,220],{},"Возвращает сотрудников портала",[104,222,223,226,231],{},[122,224,225],{},"Отправить сообщение в чат",[122,227,228],{},[22,229,230],{},"im.message.add",[122,232,233],{},"Пишет в чат или пользователю",[104,235,236,239,244],{},[122,237,238],{},"Элемент смарт-процесса",[122,240,241],{},[22,242,243],{},"crm.item.add",[122,245,246],{},"Создаёт элемент своего типа",[104,248,249,252,257],{},[122,250,251],{},"Список полей объекта",[122,253,254],{},[22,255,256],{},"crm.deal.fields",[122,258,259],{},"Показывает все поля и их коды",[104,261,262,265,270],{},[122,263,264],{},"Пакетный запрос",[122,266,267],{},[22,268,269],{},"batch",[122,271,272],{},"До 50 команд в одном обращении",[10,274,275,276,278,279,282],{},"Метод получения списка полей заслуживает отдельного внимания. Прежде чем что-то создавать через API, вызовите ",[22,277,256],{}," или аналогичный метод для нужной сущности. Вы увидите реальные коды полей, включая пользовательские вида ",[22,280,281],{},"UF_CRM_...",". Без этого вы будете угадывать названия и получать ошибки.",[14,284,286],{"id":285},"что-реально-сделать-без-разработчика","Что реально сделать без разработчика",[288,289,291],"h3",{"id":290},"_1-приём-заявок-с-сайта-в-crm","1. Приём заявок с сайта в CRM",[10,293,294,295,297],{},"Если на сайте своя форма, её можно связать с Битрикс24 без интеграции. Данные формы отправляются на вебхук с методом ",[22,296,167],{},", и заявка появляется в CRM с источником и UTM-метками. На большинстве конструкторов сайтов и в сервисах автоматизации это настраивается визуально, без кода.",[10,299,300],{},"Что учесть: заполняйте поле источника, иначе через месяц вы не поймёте, откуда пришли лиды.",[288,302,304],{"id":303},"_2-выгрузка-данных-в-google-таблицы","2. Выгрузка данных в Google Таблицы",[10,306,307,308,310],{},"Классическая задача: руководителю нужен свой отчёт, которого нет в стандартной аналитике. Через сервис автоматизации или скрипт таблицы вызывается ",[22,309,141],{}," с фильтром по датам, данные ложатся в лист, дальше строится сводная таблица и график.",[10,312,313,314,79],{},"Такой отчёт обновляется по расписанию и не требует программиста. Подходы к отчётности мы разбирали в статье ",[315,316,318],"a",{"href":317},"\u002Fblog\u002Fotchety-i-analitika-v-bitrix24","Отчёты и аналитика в Битрикс24",[288,320,322],{"id":321},"_3-уведомления-во-внешние-каналы","3. Уведомления во внешние каналы",[10,324,325],{},"Сделка перешла в важную стадию, нужно уведомить руководителя в Telegram. Настраивается исходящим вебхуком на событие изменения сделки, который отправляет данные в сервис автоматизации, а тот пишет в Telegram.",[288,327,329],{"id":328},"_4-массовое-обновление-данных","4. Массовое обновление данных",[10,331,332,333,335],{},"Нужно проставить источник у 2000 старых лидов или перенести значение из одного поля в другое. Через пакетный метод ",[22,334,269],{}," это делается скриптом на 20 строк или через сервис автоматизации с обходом списка. Ручная правка заняла бы неделю.",[288,337,339],{"id":338},"_5-импорт-базы-из-таблицы","5. Импорт базы из таблицы",[10,341,342,343,346,347,349],{},"Список из 5000 контрагентов в Excel превращается в контакты и компании CRM через последовательные вызовы ",[22,344,345],{},"crm.company.add"," и ",[22,348,180],{},". Плюс сравнение с существующими записями, чтобы не создать дубли.",[288,351,353],{"id":352},"_6-синхронизация-с-простым-внешним-сервисом","6. Синхронизация с простым внешним сервисом",[10,355,356],{},"Если у второй системы есть открытый API, связку часто удаётся собрать в сервисе автоматизации без кода: событие в Битрикс24, преобразование данных, вызов метода второй системы. Так подключают сервисы рассылок, планировщики, формы, платёжные ссылки.",[288,358,360],{"id":359},"_7-автоматическое-создание-задач-по-расписанию","7. Автоматическое создание задач по расписанию",[10,362,363,364,366,367,79],{},"Скрипт по расписанию вызывает ",[22,365,32],{}," и создаёт задачи по сложным правилам, которых нет в штатных регулярных задачах: например, задача создаётся только в последний рабочий день месяца. Про работу с задачами есть отдельный материал: ",[315,368,370],{"href":369},"\u002Fblog\u002Fupravlenie-zadachami-bitrix24","Управление задачами в Битрикс24",[14,372,374],{"id":373},"где-заканчиваются-возможности-без-программиста","Где заканчиваются возможности без программиста",[10,376,377],{},"Честная граница выглядит так. Одиночные операции и простые обмены собираются без кода. Дальше начинаются вещи, которые требуют инженерного подхода.",[10,379,380,383],{},[40,381,382],{},"Обработка ошибок."," Что делать, если внешний сервис недоступен, а сделку уже создали? Как повторить неудачный запрос? Как не создать дубль при повторе? Без этой логики интеграция работает до первого сбоя.",[10,385,386,389],{},[40,387,388],{},"Лимиты API."," У портала есть ограничения на частоту запросов. При превышении запросы отклоняются. Нужны очереди, паузы и пакетные запросы.",[10,391,392,395],{},[40,393,394],{},"Большие объёмы."," Выгрузить 200 000 сделок одним запросом нельзя. Нужна постраничная обработка с учётом смещения и корректной работой при изменении данных во время выгрузки.",[10,397,398,401],{},[40,399,400],{},"Двусторонний обмен."," Запись изменили и в Битрикс24, и во внешней системе. Чья версия побеждает? Без явного правила данные разъезжаются.",[10,403,404,407],{},[40,405,406],{},"Сложное сопоставление."," Разные справочники, форматы номеров, единицы измерения, валюты. Это отдельная работа, которую нельзя сделать галочками.",[10,409,410,413],{},[40,411,412],{},"Безопасность и аудит."," Кто и когда пользовался вебхуком, что менялось, как отозвать доступ при увольнении.",[10,415,416],{},"Если задача попадает хотя бы в два пункта из списка, дешевле сразу отдать её разработчику, чем чинить самодельную связку каждую неделю.",[14,418,420],{"id":419},"вебхук-или-приложение-что-выбрать","Вебхук или приложение: что выбрать",[98,422,423,436],{},[101,424,425],{},[104,426,427,430,433],{},[107,428,429],{},"Критерий",[107,431,432],{},"Вебхук",[107,434,435],{},"Локальное приложение",[117,437,438,449,460,471,482,493,502],{},[104,439,440,443,446],{},[122,441,442],{},"Скорость запуска",[122,444,445],{},"Минуты",[122,447,448],{},"Часы или дни",[104,450,451,454,457],{},[122,452,453],{},"Кто настраивает",[122,455,456],{},"Администратор портала",[122,458,459],{},"Разработчик",[104,461,462,465,468],{},[122,463,464],{},"Права",[122,466,467],{},"Фиксированы при создании",[122,469,470],{},"Гибкие, через OAuth",[104,472,473,476,479],{},[122,474,475],{},"От чьего имени работает",[122,477,478],{},"Создателя вебхука",[122,480,481],{},"Приложения",[104,483,484,487,490],{},[122,485,486],{},"Подходит для тиража",[122,488,489],{},"Нет",[122,491,492],{},"Да",[104,494,495,498,500],{},[122,496,497],{},"Свой интерфейс внутри портала",[122,499,489],{},[122,501,492],{},[104,503,504,507,510],{},[122,505,506],{},"Отзыв доступа",[122,508,509],{},"Удалить вебхук",[122,511,512],{},"Удалить приложение",[10,514,515],{},"Вебхук - инструмент для одной конкретной связки на одном портале. Приложение нужно, когда решение тиражируется на нескольких клиентов, требует собственного интерфейса внутри Битрикс24 или должно работать не от имени конкретного сотрудника.",[14,517,519],{"id":518},"безопасность-правила-которые-нельзя-нарушать","Безопасность: правила, которые нельзя нарушать",[58,521,522,528,534,540,546,552,558],{},[61,523,524,527],{},[40,525,526],{},"Вебхук равен паролю."," Кто угодно с этой ссылкой получит доступ к данным в пределах выданных прав. Не отправляйте её в общих чатах и не храните в открытых документах.",[61,529,530,533],{},[40,531,532],{},"Минимальные права."," Нужно создавать сделки - выдайте права только на CRM. Не отмечайте все скоупы «на всякий случай».",[61,535,536,539],{},[40,537,538],{},"Отдельный вебхук на каждую интеграцию."," Тогда при компрометации или отключении сервиса вы отзываете один доступ, а не ломаете всё сразу.",[61,541,542,545],{},[40,543,544],{},"Не встраивайте вебхук в код фронтенда."," Ссылка в JavaScript на сайте видна любому посетителю. Запросы должны идти с сервера.",[61,547,548,551],{},[40,549,550],{},"Ревизия раз в квартал."," Откройте список вебхуков и удалите те, назначение которых никто не помнит.",[61,553,554,557],{},[40,555,556],{},"Служебная учётная запись."," Создавайте вебхуки от специально заведённого пользователя, а не от личного аккаунта сотрудника.",[61,559,560,563],{},[40,561,562],{},"Логи."," Если связку делает подрядчик, требуйте логирование запросов и ошибок. Без логов диагностика сбоя превращается в гадание.",[14,565,567],{"id":566},"типичные-ошибки","Типичные ошибки",[10,569,570,573,574,577,578,581],{},[40,571,572],{},"Угаданные коды полей."," Пользовательские поля имеют коды вида ",[22,575,576],{},"UF_CRM_1712345678",", а не человеческие названия. Всегда получайте список полей методом ",[22,579,580],{},"fields"," перед разработкой.",[10,583,584,587],{},[40,585,586],{},"Игнорирование ответа."," Скрипт отправил запрос и не проверил результат. Битрикс24 вернул ошибку, никто не заметил, данные не создались.",[10,589,590,593],{},[40,591,592],{},"Отсутствие проверки дублей."," Каждая отправка формы создаёт новый контакт. Через месяц в базе три записи на одного клиента. Перед созданием ищите существующего клиента по телефону или почте.",[10,595,596,599],{},[40,597,598],{},"Синхронный вызов в критичном месте."," Сайт ждёт ответа от Битрикс24 перед показом страницы «спасибо». Портал отвечает медленно, посетитель видит ошибку. Отправляйте запрос асинхронно.",[10,601,602,605],{},[40,603,604],{},"Вебхук уволившегося сотрудника."," Учётную запись отключили, интеграция встала, причину искали два дня.",[10,607,608,611],{},[40,609,610],{},"Нет разделения тестового и боевого."," Проверка скрипта на живом портале создаёт мусорные сделки, которые потом портят отчётность.",[14,613,615],{"id":614},"с-чего-начать-если-вы-не-программист","С чего начать, если вы не программист",[58,617,618,621,627,633,636,639],{},[61,619,620],{},"Создайте вебхук с правами только на чтение CRM.",[61,622,623,624,626],{},"Откройте в браузере адрес вебхука с методом ",[22,625,141],{}," и посмотрите на структуру ответа.",[61,628,629,630,632],{},"Вызовите ",[22,631,256],{}," и выпишите коды полей, которые вам нужны.",[61,634,635],{},"Соберите первую простую связку: выгрузку сделок в таблицу по расписанию.",[61,637,638],{},"Убедитесь, что данные совпадают с тем, что видно в интерфейсе.",[61,640,641],{},"Только после этого переходите к записи данных в портал, и сначала на тестовых записях.",[10,643,644],{},"Такой порядок исключает главный риск новичка: испортить боевые данные экспериментальным скриптом.",[14,646,648],{"id":647},"частые-вопросы","Частые вопросы",[288,650,652],{"id":651},"чем-вебхук-отличается-от-приложения","Чем вебхук отличается от приложения?",[10,654,655],{},"Вебхук - это простая ссылка с фиксированным набором прав, привязанная к одному порталу и одному пользователю. Приложение авторизуется по протоколу OAuth, может иметь свой интерфейс внутри Битрикс24 и устанавливаться на разные порталы. Для одной интеграции внутри своей компании хватает вебхука, для тиражируемого решения нужно приложение.",[288,657,659],{"id":658},"нужен-ли-платный-тариф-для-работы-с-rest-api","Нужен ли платный тариф для работы с REST API?",[10,661,662],{},"REST API доступен на коммерческих тарифах Битрикс24, набор доступных методов и лимиты зависят от плана. На бесплатном тарифе возможности ограничены. Проверьте условия своего тарифа в настройках портала перед проектированием интеграции.",[288,664,666],{"id":665},"есть-ли-ограничения-на-количество-запросов","Есть ли ограничения на количество запросов?",[10,668,669,670,672],{},"Да, портал ограничивает частоту обращений к API, и при превышении запросы отклоняются с ошибкой. Для массовых операций используйте пакетный метод ",[22,671,269],{},", который объединяет до 50 команд в одном обращении, и делайте паузы между пакетами.",[288,674,676],{"id":675},"можно-ли-через-api-изменить-интерфейс-битрикс24","Можно ли через API изменить интерфейс Битрикс24?",[10,678,679],{},"Через вебхуки нет, они работают только с данными. Собственные вкладки, кнопки и встроенные страницы делаются через приложения с использованием клиентской библиотеки Битрикс24. Это уже задача для разработчика.",[288,681,683],{"id":682},"как-понять-какой-метод-мне-нужен","Как понять, какой метод мне нужен?",[10,685,686,687,690,691,693],{},"Откройте официальную документацию REST API Битрикс24 и найдите раздел по нужной сущности: CRM, задачи, пользователи, диск. Названия методов строятся логично: сущность плюс действие, например ",[22,688,689],{},"crm.company.update",". Список полей всегда узнавайте методом ",[22,692,580],{}," у той же сущности.",[288,695,697],{"id":696},"что-делать-если-интеграция-сломалась","Что делать, если интеграция сломалась?",[10,699,700,701,703],{},"Первым делом проверьте, жив ли вебхук: откройте его с методом ",[22,702,88],{}," в браузере. Если ответ есть, смотрите логи со стороны внешнего сервиса и текст ошибки в ответе API. Самые частые причины: отключённый пользователь-владелец вебхука, изменённые права, переименованные или удалённые поля.",[14,705,707],{"id":706},"что-дальше","Что дальше",[10,709,710],{},"Вебхуки закрывают простые задачи и дают быстрый результат без бюджета на разработку. Как только появляется регулярный обмен, большие объёмы или несколько систем, нужна нормальная интеграция с обработкой ошибок и мониторингом.",[10,712,713,714,718,719,346,723,727,728,732],{},"Мы в Aventra делаем и то, и другое: от простой связки на вебхуках до собственных приложений и обменов с 1С, складом и отраслевыми системами. Смотрите услуги по ",[315,715,717],{"href":716},"\u002Fservices\u002Fintegrations","интеграциям",", ",[315,720,722],{"href":721},"\u002Fservices\u002Fapp-development","разработке приложений и внутренних систем",[315,724,726],{"href":725},"\u002Fservices\u002Fautomation","автоматизации процессов",". Если вы только планируете доработку, полезно заранее понимать структуру бюджета: об этом статья ",[315,729,731],{"href":730},"\u002Fblog\u002Fskolko-stoit-dorabotka-bitrix24","Сколько стоит доработка Битрикс24",". Напишите нам, оценим задачу бесплатно.",{"title":734,"searchDepth":735,"depth":735,"links":736},"",3,[737,739,740,741,750,751,752,753,754,755,763],{"id":16,"depth":738,"text":17},2,{"id":55,"depth":738,"text":56},{"id":95,"depth":738,"text":96},{"id":285,"depth":738,"text":286,"children":742},[743,744,745,746,747,748,749],{"id":290,"depth":735,"text":291},{"id":303,"depth":735,"text":304},{"id":321,"depth":735,"text":322},{"id":328,"depth":735,"text":329},{"id":338,"depth":735,"text":339},{"id":352,"depth":735,"text":353},{"id":359,"depth":735,"text":360},{"id":373,"depth":738,"text":374},{"id":419,"depth":738,"text":420},{"id":518,"depth":738,"text":519},{"id":566,"depth":738,"text":567},{"id":614,"depth":738,"text":615},{"id":647,"depth":738,"text":648,"children":756},[757,758,759,760,761,762],{"id":651,"depth":735,"text":652},{"id":658,"depth":735,"text":659},{"id":665,"depth":735,"text":666},{"id":675,"depth":735,"text":676},{"id":682,"depth":735,"text":683},{"id":696,"depth":735,"text":697},{"id":706,"depth":738,"text":707},"Разработка","2026-07-14","Как создать вебхук в Битрикс24, какие методы REST API нужны чаще всего и какие задачи закрываются без программиста. Примеры, ограничения, безопасность и типичные ошибки.","md",{},true,"\u002Fblog\u002Frest-api-bitrix24-vebhuki","12 мин",{"title":5,"description":766},"blog\u002Frest-api-bitrix24-vebhuki","tIjL_BBmxyNS3tmbLHujPjD1DlPxmrzlkK71HBlsXXk",1787075660913]