Untuk ejen AI: markdown halaman ini — /docs-content-en/calls/log/chat.md indeks dokumentasi — /llms.txt
Artikel dokumentasi kini tersedia dalam bahasa Inggeris.
Chat with a user
May create a private chat. Even GET requires a writable key; READONLY receives 403 before Bitrix24. userId is an employee ID from GET /v1/users.
GET /v1/calls/log/chat?userId=77
Bitrix24: call.CallLog.getChat | Scope: call | Auth: X-Api-Key
Response fields
data.chatId
{
"success": true,
"data": {
"chatId": 4093
}
}
Examples
curl -X GET "https://vibecode.bitrix24.com/v1/calls/log/chat?userId=77" -H "X-Api-Key: vibe_api_DUMMY_personal"
curl -X GET "https://vibecode.bitrix24.com/v1/calls/log/chat?userId=77" -H "X-Api-Key: vibe_app_DUMMY_oauth" -H "Authorization: Bearer DUMMY_SESSION"
const response = await fetch("https://vibecode.bitrix24.com/v1/calls/log/chat?userId=77", {
method: "GET", headers: { "X-Api-Key": "vibe_api_DUMMY_personal" }
});
const result = await response.json();
const response = await fetch("https://vibecode.bitrix24.com/v1/calls/log/chat?userId=77", {
method: "GET", headers: { "X-Api-Key": "vibe_app_DUMMY_oauth", "Authorization": "Bearer DUMMY_SESSION" }
});
const result = await response.json();
Errors
| HTTP | Code | Meaning |
|---|---|---|
| 400 | INVALID_PARAMS | Invalid input; no Bitrix24 call |
| 401 | TOKEN_MISSING / INVALID_API_KEY | Missing tokens or unusable key |
| 403 | SCOPE_DENIED / BITRIX_ACCESS_DENIED / WRITE_BLOCKED_READONLY_KEY | 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.
{"success":false,"error":{"code":"INVALID_PARAMS","message":"Invalid parameter"}}