1
0
mirror of https://github.com/Bayselonarrend/OpenIntegrations.git synced 2025-04-17 12:06:34 +02:00
Vitaly the Alpaca (bot) 19912a210c Main build (Jenkins)
2024-10-08 20:15:58 +03:00

65 lines
1.6 KiB
Markdown

---
sidebar_position: 18
---
# Set user status
Sets the status (online) of the current user
`Function SetUserStatus(Val URL, Val Status, Val Token = "") Export`
| Parameter | CLI option | Type | Description |
|-|-|-|-|
| URL | --url | String | URL of webhook or a Bitrix24 domain, when token used |
| Status | --status | String, Number | Status value: online, dnd, away |
| Token | --token | String | Access token, when app auth method used |
Returns: Map Of KeyAndValue - serialized JSON of answer from Bitrix24 API
<br/>
:::tip
Method at API documentation: [im.user.status.set](https://dev.1c-bitrix.ru/learning/course/index.php?COURSE_ID=93&LESSON_ID=11499)
:::
<br/>
```bsl title="Code example"
URL = "https://b24-ar17wx.bitrix24.by/rest/1/1o2...";
Status = "dnd";
Result = OPI_Bitrix24.SetUserStatus(URL, Status);
URL = "b24-ar17wx.bitrix24.by";
Token = "37d1fe66006e9f06006b12e400000001000...";
Status = "away";
Result = OPI_Bitrix24.SetUserStatus(URL, Status, Token);
```
```sh title="CLI command example"
oint bitrix24 SetUserStatus --url "b24-ar17wx.bitrix24.by" --status "away" --token "fe3fa966006e9f06006b12e400000001000..."
```
```json title="Result"
{
"result": true,
"time": {
"start": 1728329154.21302,
"finish": 1728329154.24874,
"duration": 0.0357239246368408,
"processing": 0.00669217109680176,
"date_start": "2024-10-07T22:25:54+03:00",
"date_finish": "2024-10-07T22:25:54+03:00",
"operating_reset_at": 1728329754,
"operating": 0
}
}
```