Для разработчиков

Новый статус сотрудника

PUT/users/{user_id}/status
user_status:write

Ставит статус другому сотруднику — например, «в отпуске» на время отсутствия. Доступно владельцу пространства и администратору, боту метод недоступен даже с выданным скоупом.

Этим же методом сотруднику включают режим «Нет на месте» флагом is_away и задают текст away_message, который увидят при попытке к нему обратиться.

Статус видят все, кто видит сотрудника в пространстве. Перезаписываются только переданные поля, поэтому продлить чужой статус можно одним expires_at.

Срок, названный словами, — это expires_at, а не часть подписи, и считается он в часовом поясе того сотрудника, которому ставят статус.

Эмодзи и подпись обязательны, только когда статуса ещё нет. Эмодзи должен быть ровно один, без текста вокруг, а подпись — не длиннее 50 символов.

Свой статус ставят методом PUTНовый свой статус — он доступен всем ролям и ботам.

Параметры пути

user_id
integer, (int32)
*
Идентификатор пользователя
Пример:12

Тело запроса

application/json
status
object
*
emoji
string
Emoji символ статуса. Обязателен, если статуса ещё нет.
Пример:🎮
title
string
Текст статуса. Обязателен, если статуса ещё нет.
Пример:Очень занят
Длина:
<= 50 символов
expires_at
string, (date-time)
Срок жизни статуса (ISO-8601). Смещение вида +03:00 учитывается, время без смещения считается UTC.
Пример:2024-04-08T10:00:00.000Z
is_away
boolean
Режим «Нет на месте»
Пример:true
away_message
string
Текст сообщения при режиме «Нет на месте». Отображается в профиле и при личных сообщениях/упоминаниях.
Пример:Вернусь после 15:00
Длина:
<= 1024 символов

Ответ

200OK
The request has succeeded.
data
object
*
Статус пользователя
emoji
string
*
Emoji символ статуса
Пример:🎮
title
string
*
Текст статуса
Пример:Очень занят
Длина:
<= 50 символов
expires_at
nullablestring, (date-time)
*
Срок жизни статуса (ISO-8601, UTC+0) в формате YYYY-MM-DDThh:mm:ss.sssZ. null, если срок не задан — такой статус не сбрасывается автоматически.
Пример:2024-04-08T10:00:00.000Z
is_away
boolean
*
Режим «Нет на месте»
Пример:false
away_message
nullableobject
*
Сообщение при режиме «Нет на месте». Отображается в профиле пользователя, а также при отправке ему личного сообщения или упоминании в чате. null, если текст не задан.
text
string
*
Текст сообщения
Пример:Я в отпуске до 15 апреля. По срочным вопросам обращайтесь к @ivanov.
Длина:
<= 1024 символов
Новый статус сотрудника
pachca users update-status 12 \  --emoji=🎮 \  --title='Очень занят' \  --expires-at=2024-04-08T10:00:00.000Z \  --is-away \  --away-message='Вернусь после 15:00' \  --json \  --token YOUR_ACCESS_TOKEN
Ответ 200
{  "data": {    "emoji": "🎮",    "title": "Очень занят",    "expires_at": "2024-04-08T10:00:00.000Z",    "is_away": false,    "away_message": {      "text": "Я в отпуске до 15 апреля. По срочным вопросам обращайтесь к @ivanov."    }  }}