Для AI-агентов: markdown этой страницы — /docs-content/calls/log/list.md индекс документации — /llms.txt

Список звонков

Пара курсора lastId и lastStatusTime берётся из последней записи. Передавайте statusTime без изменения; это ATOM со смещением часового пояса.

GET /v1/calls/log

Bitrix24: call.CallLog.list | Scope: call | Auth: X-Api-Key

Параметры

Parameter Type Required Description
status string / string[] no initiated, answered, declined, missed; case-insensitive
excludeStatus string no One status to subtract
type string no incoming / outgoing; STATUS takes precedence; other scalar values follow Bitrix24 behavior
search string no Search term
count integer no Default 50, positive; clamped to 100
lastId integer no Last row id, or 0 for the first page
lastStatusTime string no Unchanged last row statusTime, used with lastId

Для нескольких статусов передавайте status[]=missed&status[]=answered или повторяйте параметр: status=missed&status=answered. В MCP-инструменте manage_call_log используйте action: "list", query: { "status": ["missed", "answered"], "count": 50 }. Массив должен содержать хотя бы одну строку; остальные параметры query остаются строками или числами.

Поля ответа

data.calls[]: id, sourceType, sourceCallId, status, statusTime, type, isUnseen; optional callData: phoneNumber, duration, displayName, userId, chatId, title, avatar, color, userCount, dialogId, chatType. data.missedCounter: integer. Credentials in strings are redacted.

JSON 
{
  "success": true,
  "data": {
    "calls": [],
    "missedCounter": 0
  }
}

Примеры

Terminal 
curl --globoff -X GET "https://vibecode.bitrix24.tech/v1/calls/log?status[]=missed&status[]=answered&count=50" -H "X-Api-Key: vibe_api_DUMMY_personal"
Terminal 
curl --globoff -X GET "https://vibecode.bitrix24.tech/v1/calls/log?status[]=missed&status[]=answered&count=50" -H "X-Api-Key: vibe_app_DUMMY_oauth" -H "Authorization: Bearer DUMMY_SESSION"
javascript 
const response = await fetch("https://vibecode.bitrix24.tech/v1/calls/log?status[]=missed&status[]=answered&count=50", {
  method: "GET", headers: { "X-Api-Key": "vibe_api_DUMMY_personal" }
});
const result = await response.json();
javascript 
const response = await fetch("https://vibecode.bitrix24.tech/v1/calls/log?status[]=missed&status[]=answered&count=50", {
  method: "GET", headers: { "X-Api-Key": "vibe_app_DUMMY_oauth", "Authorization": "Bearer DUMMY_SESSION" }
});
const result = await response.json();

Ошибки

HTTP Code Meaning
400 INVALID_PARAMS / INVALID_FILTER_VALUE Invalid input; no Bitrix24 call
401 TOKEN_MISSING / INVALID_API_KEY Missing tokens or unusable key
403 SCOPE_DENIED / BITRIX_ACCESS_DENIED Missing scope, portal permission refusal, or forbidden write
422 BITRIX_ERROR Portal business refusal or unsuccessful operation
429 BITRIX_RATE_LIMIT Portal rate limit
502 / 503 BITRIX_ERROR Invalid response, unavailable portal or timeout

400: invalid input.

JSON 
{"success":false,"error":{"code":"INVALID_PARAMS","message":"Invalid parameter"}}

Смотрите также