# bizproc.activity.log

URL: https://chugunov.pro/api-bitrix24/bizproc/bizproc-activity/bizproc-activity-log/
Проверено на Битрикс24 REST API, обновлено 11.09.2026 (ревизия источника fb39d6c).
Источник: официальная документация Битрикс24 (bitrix-tools/b24-rest-docs, лицензия MIT, © Bitrix). Справочник независимый, официальной документацией не является.

Записать информацию в журнал бизнес-процесса
Scope: `bizproc`
Кто может выполнять метод: любой пользователь

## Описание

Метод `bizproc.activity.log` записывает информацию в журнал бизнес-процесса. Запись событий в журнал должна быть включена в шаблоне бизнес-процесса.

## Параметры

- `EVENT_TOKEN` `string` — обязательный. Уникальный ключ, необходимый для отправки события бизнес-процессу.
  Токен поступает на обработчик действия приложения, когда бизнес-процесс доходит до выполнения этого действия.
  Запись в журнал возможна, если при регистрации или обновлении действия в [bizproc.activity.add](https://chugunov.pro/api-bitrix24/bizproc/bizproc-activity/bizproc-activity-add/) или [bizproc.activity.update](https://chugunov.pro/api-bitrix24/bizproc/bizproc-activity/bizproc-activity-update/) параметр `USE_SUBSCRIPTION` задан со значением `'Y'`
- `LOG_MESSAGE` `string` — обязательный. Сообщение для записи в лог

## Ответ

HTTP-статус: 200

```json
{
    "result": true,
    "time": {
        "start": 1738152146.805903,
        "finish": 1738152146.844209,
        "duration": 0.03830695152282715,
        "processing": 0.0035429000854492188,
        "date_start": "2025-01-29T15:02:26+03:00",
        "date_finish": "2025-01-29T15:02:26+03:00",
        "operating_reset_at": 1738152746,
        "operating": 0
    }
}
```

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

- `result` `boolean`. Возвращает `true`, если запись в журнал добавлена успешно
- `time` `time`. Информация о времени выполнения запроса

## Ошибки

HTTP-статус: 400

```json
{
    "error": "ERROR_EMPTY_LOG_MESSAGE",
    "error_description": "Empty log message!"
}
```

- `ERROR_EMPTY_LOG_MESSAGE` — Empty log message!. Не указан текст записи в журнал
- `ACCESS_DENIED` — Access denied!. Невалидный или устаревший `EVENT_TOKEN`
- `Зависит от ошибки бизнес-процесса` — Зависит от ошибки бизнес-процесса. Ошибка, которая возвращается из выполнения бизнес-процесса

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

### cURL (Webhook)

```bash
curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"event_token":"55c1dc1c3f0d75.78875596|A51601_82584_96831_81132|hsyUws1j4XiwqPqN45eH66CcQtEvpUIP.47dd5d888e8e549d2c984713e12a4268e6e87d0208ca1f093ba1075e77f92e90","log_message":"Please wait for answer!"}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/bizproc.activity.log
```

### cURL (OAuth)

```bash
curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"event_token":"55c1dc1c3f0d75.78875596|A51601_82584_96831_81132|hsyUws1j4XiwqPqN45eH66CcQtEvpUIP.47dd5d888e8e549d2c984713e12a4268e6e87d0208ca1f093ba1075e77f92e90","log_message":"Please wait for answer!","auth":"**put_access_token_here**"}' \
https://**put_your_bitrix24_address**/rest/bizproc.activity.log
```

### JS

```js
try
{
	const response = await $b24.callMethod(
		'bizproc.activity.log',
		{
			event_token: '55c1dc1c3f0d75.78875596|A51601_82584_96831_81132|hsyUws1j4XiwqPqN45eH66CcQtEvpUIP.47dd5d888e8e549d2c984713e12a4268e6e87d0208ca1f093ba1075e77f92e90',
			log_message: 'Please wait for answer!'
		}
	);
	
	const result = response.getData().result;
	alert("Success: " + result);
}
catch( error )
{
	alert("Error: " + error);
}
```

### Python

```python
from b24pysdk.errors import BitrixAPIError, BitrixSDKException

try:
    bitrix_response = client.bizproc.activity.log(
        event_token="55c1dc1c3f0d75.78875596|A51601_82584_96831_81132|hsyUws1j4XiwqPqN45eH66CcQtEvpUIP.47dd5d888e8e549d2c984713e12a4268e6e87d0208ca1f093ba1075e77f92e90",
        log_message="Please wait for answer!",
    ).response
    result = bitrix_response.result
    print(result)
except BitrixAPIError as error:
    print(
        "Ошибка Bitrix API",
        f"error: {error.error}",
        f"error_description: {error.error_description}",
        sep="\n",
    )
except BitrixSDKException as error:
    print(f"Ошибка Bitrix SDK: {error.message}")
except Exception as error:
    print(f"Непредвиденная ошибка: {error}")
```

### PHP

```php
try {
    $eventToken = 'your_event_token'; // Replace with actual event token
    $message = 'Your log message'; // Replace with actual message

    $result = $serviceBuilder
        ->getBizProcScope()
        ->activity()
        ->log($eventToken, $message);

    if ($result->isSuccess()) {
        print($result->getCoreResponse()->getResponseData()->getResult()[0]);
    } else {
        print('Log entry failed.');
    }
} catch (Throwable $e) {
    print('Error: ' . $e->getMessage());
}
```

### BX24.js

```js
BX24.callMethod(
    'bizproc.activity.log',
    {
        event_token: '55c1dc1c3f0d75.78875596|A51601_82584_96831_81132|hsyUws1j4XiwqPqN45eH66CcQtEvpUIP.47dd5d888e8e549d2c984713e12a4268e6e87d0208ca1f093ba1075e77f92e90',
        log_message: 'Please wait for answer!'
    },
    function(result) {
        if(result.error())
            alert("Error: " + result.error());
        else
            alert("Success: " + result.data());
    }
);
```

### PHP CRest

```php
require_once('crest.php');

$result = CRest::call(
    'bizproc.activity.log',
    [
        'event_token' => '55c1dc1c3f0d75.78875596|A51601_82584_96831_81132|hsyUws1j4XiwqPqN45eH66CcQtEvpUIP.47dd5d888e8e549d2c984713e12a4268e6e87d0208ca1f093ba1075e77f92e90',
        'log_message' => 'Please wait for answer!'
    ]
);

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

### Go

```go
// client и ctx уже созданы — см. раздел «SDK для Go»
res, err := client.Core().Call(ctx, "bizproc.activity.log", b24.Params{
	"EVENT_TOKEN": "55c1dc1c3f0d75.78875596|A51601_82584_96831_81132|hsyUws1j4XiwqPqN45eH66CcQtEvpUIP.47dd5d888e8e549d2c984713e12a4268e6e87d0208ca1f093ba1075e77f92e90",
	"LOG_MESSAGE": "Please wait for answer!",
})
if err != nil {
	return fmt.Errorf("bizproc.activity.log: %w", err)
}

var ok bool
if err := json.Unmarshal(res.Result, &ok); err != nil {
	return fmt.Errorf("разбор ответа: %w", err)
}
fmt.Println("выполнено:", ok)
```

Оригинал в официальной документации: https://apidocs.bitrix24.ru/api-reference/bizproc/bizproc-activity/bizproc-activity-log.html
