Коллеги, приветствую. На связи Юрий Павлюк и команда DU Digital for Sales. Мы разрабатываем полезные приложения для Bitrix24 и, разумеется, интегрируем BX24 в ваши бизнесы. В этом видео расскажу о непростом, уже продвинутом приложении. Обычно мы делаем простые решения, но это — инструмент для тех, кто хочет полноценно работать с REST-методами Bitrix24 прямо в роботах и бизнес-процессах.
Если вы когда-то заходили в эпидокс Битрикса, то знаете, что методов там огромное количество — на вскидку около тысячи. И каждый из них с нюансами. Мы сами туда ходим регулярно, потому что задачи бывают самые разные, а REST — мощная штука, позволяющая делать тонкую автоматизацию, но запускать методы без удобного инструмента непросто. Именно для этого и создано наше приложение.
Приложение состоит по сути из трёх полей. Первое — сам REST-метод. С чем работаем, к чему обращаемся, что хотим получить. Например, я хочу получить выборку сотрудников, значит ставлю user.get. Второе — фильтр. Здесь я указываю критерии. Например, «найди мне пользователя, у которого email равен вот этому значению». Это значение я подставляю из предыдущего шага бизнес-процесса. Всё в цепочке работает идеально. Ну и третье поле — JSON Patch. Здесь я прописываю, какие данные хочу забрать из результата. Например, айдишник, имя, фамилию и содержимое пользовательского поля с Telegram-аккаунтом. На выходе получаю четыре отдельных значения, с которыми могу дальше работать. Можно выводить до 10 переменных — этого более чем достаточно.
Если вы когда-то заходили в эпидокс Битрикса, то знаете, что методов там огромное количество — на вскидку около тысячи. И каждый из них с нюансами. Мы сами туда ходим регулярно, потому что задачи бывают самые разные, а REST — мощная штука, позволяющая делать тонкую автоматизацию, но запускать методы без удобного инструмента непросто. Именно для этого и создано наше приложение.
Приложение состоит по сути из трёх полей. Первое — сам REST-метод. С чем работаем, к чему обращаемся, что хотим получить. Например, я хочу получить выборку сотрудников, значит ставлю user.get. Второе — фильтр. Здесь я указываю критерии. Например, «найди мне пользователя, у которого email равен вот этому значению». Это значение я подставляю из предыдущего шага бизнес-процесса. Всё в цепочке работает идеально. Ну и третье поле — JSON Patch. Здесь я прописываю, какие данные хочу забрать из результата. Например, айдишник, имя, фамилию и содержимое пользовательского поля с Telegram-аккаунтом. На выходе получаю четыре отдельных значения, с которыми могу дальше работать. Можно выводить до 10 переменных — этого более чем достаточно.
Дальше эти данные я использую, чтобы отправить человеку уведомление в Telegram через другое наше приложение. В групповом чате на 45 человек тегаю конкретного сотрудника и пишу, что вот обнаружена ошибка в карточке компании. Всё работает именно благодаря тому, что REST-метод вернул мне нужные значения.
Другой пример. Я знаю ID сотрудника и хочу найти в конкретном смарт-процессе все карточки, которые принадлежат этому сотруднику и не находятся в финальных стадиях. То есть по-простому: «покажи все открытые элементы такого-то смарта у такого-то человека». Выбираю crm.item.list, задаю фильтр, и потом в JSON-результате забираю нужные ID. Их может быть несколько, поэтому использую массив. Затем могу вывести эти ID в комментарий или обработать итератором — как угодно.
Кстати, про комментарии. Очень полезно иногда выводить весь результат целиком. Особенно когда вы не знаете структуру данных. В REST-ответе может быть вложенность, разные названия полей, капслок в ID, вложенные массивы. Всё это легко увидеть, если один раз вывести весь JSON в комментарий, скопировать и показать нашему другу — копайлоту. Я так и делаю. Копайлот подсказывает, где ошибка: лишняя запятая, неправильное поле, не тот уровень вложенности. В 90% случаев это решает проблему. В оставшихся 10% я делаю лайфхак: копирую всю страницу метода из эпидокса, отправляю копайлоту со словами «изучи, пожалуйста, как работает этот метод», и затем задаю ему вопросы. Работает безотказно.
Другой пример. Я знаю ID сотрудника и хочу найти в конкретном смарт-процессе все карточки, которые принадлежат этому сотруднику и не находятся в финальных стадиях. То есть по-простому: «покажи все открытые элементы такого-то смарта у такого-то человека». Выбираю crm.item.list, задаю фильтр, и потом в JSON-результате забираю нужные ID. Их может быть несколько, поэтому использую массив. Затем могу вывести эти ID в комментарий или обработать итератором — как угодно.
Кстати, про комментарии. Очень полезно иногда выводить весь результат целиком. Особенно когда вы не знаете структуру данных. В REST-ответе может быть вложенность, разные названия полей, капслок в ID, вложенные массивы. Всё это легко увидеть, если один раз вывести весь JSON в комментарий, скопировать и показать нашему другу — копайлоту. Я так и делаю. Копайлот подсказывает, где ошибка: лишняя запятая, неправильное поле, не тот уровень вложенности. В 90% случаев это решает проблему. В оставшихся 10% я делаю лайфхак: копирую всю страницу метода из эпидокса, отправляю копайлоту со словами «изучи, пожалуйста, как работает этот метод», и затем задаю ему вопросы. Работает безотказно.
Теперь важные нюансы. Первое — от чьего имени запускается робот или бизнес-процесс. Очень частая проблема. Если вы запускаете от пользователя с ID 1, а этот человек уже уволен, ничего работать не будет. И мы все будем думать, что JSON неверный. Поэтому ставьте либо текущего администратора, либо технического пользователя с полными правами.
Второе — период ожидания. Многие пропускают это поле. Но если вы проходите по базе, где, например, 250 тысяч контактов, это занимает время. Чтобы автоматизация не падала, поставьте минимум 10 минут — и всё пройдет спокойно.
Третье — если вы меняете сущность в роботе, обязательно переключайте поле, потому что встройка может подхватить старые настройки. Кликнули мимо, вернулись, выбрали заново — и всё работает корректно.
Второе — период ожидания. Многие пропускают это поле. Но если вы проходите по базе, где, например, 250 тысяч контактов, это занимает время. Чтобы автоматизация не падала, поставьте минимум 10 минут — и всё пройдет спокойно.
Третье — если вы меняете сущность в роботе, обязательно переключайте поле, потому что встройка может подхватить старые настройки. Кликнули мимо, вернулись, выбрали заново — и всё работает корректно.
Дополнительно — приложение отлично подходит не только для точечных операций, но и для массовых сценариев. Можно ставить условия, фильтровать сделки по сумме, по датам, по продуктам, искать конкретных сотрудников, собирать статистику. Например: «сколько открытых сделок с бюджетом выше 15 тысяч у менеджера Петрова?» С REST-методами это решается в два клика, а штатными средствами — сложно или невозможно.
И, конечно, JSON Patch. С ним тоже сталкиваются трудности, но вместе с копайлотом это решаемо. Он прекрасно понимает вложенные структуры и подсказывает правильный синтаксис. А если не понимает — мы его обучаем.
Коллеги, на этом всё. Мы прошлись по трём основным полям приложения, посмотрели, как использовать результаты — и в роботах, и в бизнес-процессах. Это промежуточный инструмент, который выдаёт данные, а дальше вы с ними делаете что угодно. Я показал все типовые приёмы и лайфхаки, которыми мы пользуемся сами.
Я желаю вам успехов. С вами был Юрий Павлюк, команда Digital for Sales. Сегодня говорили о приложении REST для работы с REST-методами BX24 и JSON. Магия работает везде — в роботах, процессах, сценариях, автоматизациях. До встречи в новых видео. Пока.
И, конечно, JSON Patch. С ним тоже сталкиваются трудности, но вместе с копайлотом это решаемо. Он прекрасно понимает вложенные структуры и подсказывает правильный синтаксис. А если не понимает — мы его обучаем.
Коллеги, на этом всё. Мы прошлись по трём основным полям приложения, посмотрели, как использовать результаты — и в роботах, и в бизнес-процессах. Это промежуточный инструмент, который выдаёт данные, а дальше вы с ними делаете что угодно. Я показал все типовые приёмы и лайфхаки, которыми мы пользуемся сами.
Я желаю вам успехов. С вами был Юрий Павлюк, команда Digital for Sales. Сегодня говорили о приложении REST для работы с REST-методами BX24 и JSON. Магия работает везде — в роботах, процессах, сценариях, автоматизациях. До встречи в новых видео. Пока.
Лендинг приложения: https://restapi.digitalforsales.ru
