For AI agents: markdown of this page — /docs-content-en/bots/events/user-events.md documentation index — /llms.txt
User events (ONIMV2*)
The common first step is the subscription: POST /v1/chats/events/subscribe (scope im, not imbot). Without an active subscription Bitrix24 does not register user events.
After that, events are fetched in one of two ways:
- Together with bot events — pass
withUserEvents=trueto bot polling. Bot events (ONIMBOTV2*) and user events (ONIMV2*) arrive in the sameeventsarray. - As a separate poll on behalf of the user —
GET /v1/chats/events. Does not require a registered bot; suitable for agents acting on behalf of a user.
Event list
| Event | Description |
|---|---|
ONIMV2MESSAGEADD |
New message in a subscribed chat |
ONIMV2MESSAGEUPDATE |
Message edited |
ONIMV2MESSAGEDELETE |
Message deleted |
ONIMV2JOINCHAT |
A participant joined the chat |
ONIMV2REACTIONCHANGE |
Reaction changed |
Known specifics
Separate scope: subscribing and unsubscribing require the im scope, not imbot.