Блог Горошко Андрея Bitrix24,PHP Запустить выполнение триггера crm.automation.trigger.execute

Запустить выполнение триггера crm.automation.trigger.execute

При разработке и поддержке проектов на платформе 1С-Битрикс критически важно использовать современные стандарты D7 API. В этом руководстве мы детально изучим тему «Запустить выполнение триггера crm.automation.trigger.execute», разберем архитектурные особенности и предоставим готовые к интеграции примеры кода.

Запустить выполнение триггера crm.automation.trigger.execute

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

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

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

Параметры метода

Название
тип
Описание
CODE
string
Внутренний уникальный (в рамках приложения) идентификатор триггера. Должен соответствовать маске [a-z0-9\.\-_]
OWNER_TYPE_ID
integer
Тип объекта CRM по справочнику crm.enum.ownertype (Например, 1 — лид)

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

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

Примеры кода

  • cURL (Webhook)
    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
  • cURL (OAuth)
    curl -X POST \
    -H "Content-Type: application/json" \
    -H "Accept: application/json" \
    -d '{"CODE":"c5u4m","OWNER_TYPE_ID":2,"OWNER_ID":6,"auth":"**put_access_token_here**"}' \
    https://**put_your_bitrix24_address**/rest/crm.automation.trigger.execute
  • JS
    try
    {
    	const response = await $b24.callMethod(
    		'crm.automation.trigger.execute',
    		{
    			CODE: 'c5u4m',
    			OWNER_TYPE_ID: 2,
    			OWNER_ID: 6
    		}
    	);
    	
    	const result = response.getData().result;
    	if(result.error())
    	{
    		console.error(result.error());
    	}
    	else
    	{
    		console.dir(result);
    	}
    }
    catch(error)
    {
    	console.error('Error:', error);
    }
  • PHP
    try {
        $response = $b24Service
            ->core
            ->call(
                'crm.automation.trigger.execute',
                [
                    'CODE'         => 'c5u4m',
                    'OWNER_TYPE_ID' => 2,
                    'OWNER_ID'     => 6,
                ]
            );
    
        $result = $response
            ->getResponseData()
            ->getResult();
    
        if ($result->error()) {
            error_log($result->error());
        } else {
            echo 'Success: ' . print_r($result->data(), true);
        }
    
    } catch (Throwable $e) {
        error_log($e->getMessage());
        echo 'Error executing automation trigger: ' . $e->getMessage();
    }
  • BX24.js
    BX24.callMethod(
        'crm.automation.trigger.execute',
        {
            CODE: 'c5u4m',
            OWNER_TYPE_ID: 2,
            OWNER_ID: 6
        },
        function(result) 
        {
            if(result.error())
                console.error(result.error());
            else
                console.dir(result.data());
        }
    );
  • PHP CRest
    require_once('crest.php');

    $result = CRest::call(
        'crm.automation.trigger.execute',
        [
            'CODE' => 'c5u4m',
            'OWNER_TYPE_ID' => 2,
            'OWNER_ID' => 6
        ]
    );

    echo '<PRE>';
    print_r($result);
    echo '</PRE>';

Обработка ответа

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."
}

Возможные коды ошибок

КодCообщение об ошибкеОписание
Пустая строкаAccess denied.Пользователь не прошел предварительную проверку прав на доступ к CRM
ACCESS_DENIEDAccess denied! Admin permissions requiredНе пройдена проверка прав на администратора
ACCESS_DENIEDAccess 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 (значение не является положительным)
  • [](./crm-automation-trigger-add)
  • [](./crm-automation-trigger-list)
  • [](./crm-automation-trigger-delete)

💡 Экспертное мнение и рекомендации

Практические рекомендации:

  • При написании кастомных компонентов для «Запустить выполнение триггера crm.automation.trigger.execute» всегда разделяйте бизнес-логику и представление (шаблон).
  • Используйте отладку SQL-запросов через конструкцию $wpdb->last_query или стандартный трекер Битрикса, чтобы контролировать нагрузку.

Похожая задача в бизнесе?

Помогу автоматизировать процессы и внедрить ИИ

Меня зовут Андрей Горошко. Я Full-stack разработчик и эксперт по 1С-Битрикс. Настраиваю CRM Битрикс24, разрабатываю защищенные API и создаю умных ИИ-агентов для автоматизации рутины.

Related Post

Создать группу соцсети sonet_group.createСоздать группу соцсети sonet_group.create

Эффективная интеграция и кастомизация функционала в Битрикс24 часто требует работы на уровне API. Сегодня мы подробно рассмотрим «Создать группу соцсети sonet_group.create». Вы узнаете экспертные методики работы с создать группу и

Получить поля коннектора biconnector.connector.fieldsПолучить поля коннектора biconnector.connector.fields

Оптимизация производительности и безопасности — залог успешного проекта на 1С-Битрикс. Данный материал посвящен практическому применению «Получить поля коннектора biconnector.connector.fields». Мы подготовили подробный разбор принципов работы и развернутые примеры интеграции. Получить

Дополнительные поляДополнительные поля

Эффективная интеграция и кастомизация функционала в Битрикс24 часто требует работы на уровне API. Сегодня мы подробно рассмотрим «Дополнительные поля». Вы узнаете экспертные методики работы с дополнительные поля и научитесь избегать