Работа с Bitrix 24

Для работы с Bitrix 24 доступна библиотека @2bad/bitrix (opens new window).

Авторизация

Библиотека поддерживает два вида авторизации: OAuth в созданном приложения Bitrix24 и входящие вебхуки. В примерах ниже будет использоваться второй сопособ – входящие вебхуки.

Создание входящего вебхука

Создайте входящий вебхук в Bitrix24 на странице Приложения / Разработчикам / Другое Выберите карточку Входящий вебхук.

На странице настроек вебхука снизу в поле Настройка прав выберите CRM и другие права, которые вам потребуются.

Нажмите Сохранить.

Скопируйте адрес вебхука, он используется в примерах ниже.

Создание сделки в Bitrix при входящем звонке

В ответ на событие входящего звонка создадим сделку в Bitrix24. Название сделки будет содержать номер абонента.

const Bitrix = require('@2bad/bitrix').default;

module.exports = async (args) => {
  const bitrix = Bitrix('https://mycompany.bitrix24.ru/rest/1/224fq120nu3l10ep0mh/');
  const dealName = args.call_args.src_num;
  try {
    const result = await bitrix.deals.create({
      TITLE: dealName
    }, {
      REGISTER_SONET_EVENT: 'Y'
    });
  } catch (e) {
    console.error(e);
  }
};

В конструктор класса Bitrix подается адрес вебхука.

REGISTER_SONET_EVENT - регистрирует сделку в живой ленте и отправляет уведомление ответственному за сделку.

В методе create доступны все поля из документации по API Bitrix24 (opens new window).