метод REST scope: crm

crm.automation.trigger.execute

Запустить выполнение триггера

Кто может выполнять: администратор с доступом к CRM в контексте приложения

Описание

Метод запускает выполнение триггера.

Запускать метод можно только в контексте приложения.

Параметры

CODE string обязательный

Внутренний уникальный (в рамках приложения) идентификатор триггера. Должен соответствовать маске [a-z0-9\.\-_]

OWNER_TYPE_ID integer обязательный

Тип объекта CRM по справочнику crm.enum.ownertype (Например, 1 — лид)

Триггеры есть в лидах, сделках, предложениях, счетах и смарт-процессах

OWNER_ID integer обязательный

Идентификатор элемента

Примеры запроса

curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"CODE":"c5u4m","OWNER_TYPE_ID":2,"OWNER_ID":6}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/crm.automation.trigger.execute

Ответ

HTTP-статус: 200

{
    "result":true,
    "time":{
        "start":1718891973.429101,
        "finish":1718891986.721889,
        "duration":13.292788028717041,
        "processing":13.012810945510864,
        "date_start":"2024-06-20T13:59:33+00:00",
        "date_finish":"2024-06-20T13:59:46+00:00"
    }
}

Возвращаемые данные

result boolean

Возвращает true в случае успешного запуска триггера

time time

Информация о времени выполнения запроса

Обработка ошибок

HTTP-статус: 400

{
    "error":"",
    "error_description":"Incorrect parameter OWNER_TYPE_ID."
}
Код Описание Значение
Пустая строка Access denied. Пользователь не прошел предварительную проверку прав на доступ к CRM
ACCESS_DENIED Access denied! Admin permissions required Не пройдена проверка прав на администратора
ACCESS_DENIED Access denied! Application context required Метод вызван вне контекста приложения
Пустая строка Empty trigger code! Пустой параметр CODE
Пустая строка Wrong trigger code! Параметр CODE не удовлетворяет маске [a-z0-9\.\-_]
Пустая строка Trigger with code {$code} is not registered. Не найден триггер приложения
Пустая строка Incorrect parameter OWNER_TYPE_ID. Передан owner_type_id, который не определён в CRM
Пустая строка Incorrect parameter OWNER_ID. Передано некорректное значение параметра owner_id (значение не является положительным)

Что будем искать? Например,Продвижение

Этот сайт использует куки-файлы. Оставаясь на сайте, Вы соглашаетесь на их использование. Для получения дополнительной информации, пожалуйста, ознакомьтесь с политикой в отношении персональных данных.