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

Из этой статьи вы узнаете, как создать компанию в 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”.

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

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

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

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

Last updated