Создание компании

Из этой статьи вы узнаете, как создать компанию в Bitrix24 с помощью официальной документации CRM.

SQ: подготовка данных

Шаг 1: Создайте блок “Выполнить SmartQuery” с кодом:

%response% = {}

%response_status% = 0

%req_body% = {
    "FIELDS": {
        "TITLE": "Ромашка",
        "ADDRESS": "ул. Ромашковая, д.7, стр.1"
    }
}

При создании компании вы можете указать множество полей — FIELDS, список и описание которых мы получим ниже.

Для примера заполняются следующие поля:

• TITLE — название компании (обязательное поле, IsRequired = true);

• ADDRESS — адрес компании.

Как узнать доступные поля компании

Перед созданием компании важно определить, какие поля можно и нужно указывать. Для этого:

1. Откройте Postman.

2. Нажмите “Create new request”.

   
3. Установите метод POST.

4. Вставьте ваш URL вебхука:

   https://<Ваш_вебхук>/crm.company.fields

   
5. Отправьте запрос кнопкой “Send”.

   

   Пример фрагмента результата:

   {
       "result": {
           "ID": {
               "type": "integer",
               "isRequired": false,
               "isReadOnly": true,
               "isImmutable": false,
               "isMultiple": false,
               "isDynamic": false,
               "title": "ID"
           },
           "TITLE": {
               "type": "string",
               "isRequired": true,
               "isReadOnly": false,
               "isImmutable": false,
               "isMultiple": false,
               "isDynamic": false,
               "title": "Название компании"
           }
       }
   }

   Ключ type указывает тип данных, который это поле принимает.

   Поле IsRequired = true означает, что оно обязательно к заполнению при создании компании.

   

HTTP: создание компании

Шаг 2: Создайте блок “Отправить HTTP-запрос” с URL:

%BITRIX_CRM_WEBHOOK%/crm.company.add

Оставьте метод POSTбез изменений. Выберите в “Сохранить ответ в” переменную %response% (или ваше название переменной для хранения ответа — ****это должен быть словарь). Выберите в “Сохранить статус ответа в” переменную %response_status% (или ваше название переменной для хранения статуса ответа — это должно быть число). В “Тело запроса” выберите “Текст” и введите:

{{ %req_body% | to_json }}

Добавьте заголовки:

content-type = application/json

accept = application/json

Тестирование

1. Наведите курсор на три точки рядом с блоком “SmartQuery”.

2. В открывшемся меню выберите “Тестировать” → “Запустить”.

3. Перейдите в Bitrix24 → СRM → Клиенты → Компании.

   

   Во вкладке “Компании” появится созданная компания:

   

Готово! Вы успешно настроили создание компании в Bitrix24 через Smartbot.