REST.js: Javascript-активити и Конструктор роботов

REST.js позволяет создавать роботы, используя все возможности JavaScript и REST API Битрикс24.

Два варианта использования REST.js

Javascript-активити, устнавливаемое вместе с приложением

На вкладке "Javascript-активити" можно запустить готовые примеры или свой код, а затем поместить его в параметре активити




У Javascript-активити один опциональный параметр: inputText. Он используется для передачи строковых значений, а для чисел и дат используйте Вставку значения прямо в параметре "Javascript-код"



Конструктор роботов, для создания своих роботов "с нуля"

На вкладке "Конструктор роботов" можно добавлять роботов с любыми входными и выходными параметрами







Преимущество REST.js над php-скриптами, использующими вебхуки

• более безопасно: используется протокол OAuth, а не статический секретный код в вебхуке
  
• моментальное внедрение: роботы доступны сразу после нажания кнопки "Установить" или "Сохранить"
  
• не нужно платить за хостинг: в рамках подписки доступно бесплатно 3000 вызовов робота
  

Примеры роботов

Робот в REST.js аналогичен облачной Javascript-функции. Он может иметь входные и выходные параметры.

Вот примеры роботов:
1. Удаление пробелов

   return inputText.trimStart().trimEnd();

2. Смена ответственного пользователя

   const userId = /* userId первого пользователя */;
   const newResponsibleId = /* userId второго пользователя */;
   
   const deals = bx24.fetchList('crm.deal.list', {
       filter: {
           ASSIGNED_BY_ID: userId
       }
   });
   
   const commands = [];
   for (const deal of deals) {
       commands.push(['crm.deal.update', {
           id: deal.ID,
           fields: { 'ASSIGNED_BY_ID': newResponsibleId }
       }]);
       if (commands.length === 50) {
           bx24.callBatch(commands);
           commands.length = 0; // Очистка массива команд
       }
   }
   
   if (commands.length > 0) {
       bx24.callBatch(commands);
   }

Больше примеров по ссылкам:

• Поиск по регулярному выражению
  
• Удаление пробелов
  
• Поиск сделок
  
• Добавить комментарий в таймлайн сделки
  
• Назначить компанию сделкам
  
• Форматирование имени контакта
  
• Поиск контактов по ответственному
  
• Добавление события календаря
  
• Сделки с незавершенными делами
  

REST.js разработан с тщательной проработкой мер информационной безопасности.


Как использовать REST.js

См. документацию REST.js


Стоимость

Приложение работает только на платных тарифах Битрикс24 с подключённой подпиской Битрикс24 Маркет Плюс.
В рамках подписки доступно 3000 запросов на запуск роботов. Счетчик использования обнуляется 1-го числа каждого месяца
Цена дополнительных запросов - 500 рублей за 3000 запросов. Для приобретения обратитесь в службу поддержки приложения.