Bitrix24 Bot Platform

Parameters

Called method and response

JavaScript

B24.callMethod(
  'im.dialog.users.list',
  {
    DIALOG_ID: 'chat74',
    SKIP_EXTERNAL: 'Y'
  },
  res => {
    if (res.error())
    {
      console.error(result.error().ex);
    }
    else
    {
      console.log(res.data())
    }
  }
)

Response example

[
  {
    "id": 1019,
    "active": true,
    "name": "alexa shasha",
    "first_name": "alexa",
    "last_name": "shasha",
    "work_position": "",
    "color": "#df532d",
    "avatar": "",
    "gender": "M",
    "birthday": "",
    "extranet": false,
    "network": false,
    "bot": false,
    "connector": false,
    "external_auth_id": "default",
    "status": "online",
    "idle": false,
    "last_activity_date": "2021-10-30T11:24:12+02:00",
    "mobile_last_date": "2021-10-20T13:02:33+02:00",
    "absent": false,
    "departments": [
      1
    ],
    "phones": false
  },
  {
    "id": 1,
    "active": true,
    "name": "John Smith",
    "first_name": "John",
    "last_name": "Smith",
    "work_position": "",
    "color": "#df532d",
    "avatar": "",
    "gender": "M",
    "birthday": "",
    "extranet": false,
    "network": false,
    "bot": false,
    "connector": false,
    "external_auth_id": "default",
    "status": "online",
    "idle": false,
    "last_activity_date": "2021-10-30T13:36:34+02:00",
    "mobile_last_date": "2021-10-27T16:39:26+02:00",
    "absent": false,
    "departments": [
      1
    ],
    "phones": false
  }
]

Key description:

• id – user ID
• active – active user status (not dismissed)
• name – user first and last name
• first_name – user name
• last_name – user last name
• work_position – position
• color – user color in hex format
• avatar – avatar link (empty indicates that avatar is not specified)
• gender – user gender
• birthday – user birthday in DD-MM format, if empty – not specified
• extranet – extranet user attribute (true/false)
• network – Bitrix24.Network user attribute (true/false)
• bot – bot attribute (true/false)
• connector – Open Channels user attribute (true/false)
• external_auth_id – external authorization code
• status – selected user status
• idle – idle date when user is not using his/her PC, in ATOM format (if not specified, false)
• last_activity_date – date of the last user action, in ATOM format
• mobile_last_date – date of the last action inside mobile app, in ATOM format (if not specified, false)
• departments – department IDs
• absent – date, to which the user has a leave of absence, in ATOM format (if not specified, false)
• phones – array with phone numbers:
  • work_phone – work phone
  • personal_mobile – mobile phone
  • personal_phone – personal phone

Examples of response on errors

{
  "error":"DIALOG_ID_EMPTY",
  "error_description":"Dialog ID can\u0027t be empty"
}

Key description:

• error – error code
• error_description – error brief description

Possible error codes