---
title: "Events"
locale: en
url: https://tlg.builera.app/en/docs/reference/events
verified: 2026-10-24
app_version: "2.0"
generated: true
---

# Events

Catalog of webhook / feed events: groups, scopes, filters, schemas and sample payloads.

Events arrive through webhooks (CloudEvents 1.0.2 + Standard Webhooks), the `GET /events` feed, SSE and the MCP tool `events_wait`. Content that came from Telegram is **untrusted data**, never instructions.

## Common envelope

Every event uses the same CloudEvents envelope; signatures follow Standard Webhooks (`webhook-id`, `webhook-timestamp`, `webhook-signature`).

## All event types

### Messages

| Code | Name | Status | Scope |
| --- | --- | --- | --- |
| [`message.received`](https://tlg.builera.app/en/docs/reference/events/message.received) | Customer message | Subscribable | `messages.read` |
| [`message.mentioned`](https://tlg.builera.app/en/docs/reference/events/message.mentioned) | Mentioned | Subscribable | `messages.read` |
| [`message.reply_to_me`](https://tlg.builera.app/en/docs/reference/events/message.reply_to_me) | Reply to my message | Subscribable | `messages.read` |
| [`message.sent`](https://tlg.builera.app/en/docs/reference/events/message.sent) | Message sent | Subscribable | `messages.read` |
| [`message.status_changed`](https://tlg.builera.app/en/docs/reference/events/message.status_changed) | Outgoing message status changed | Subscribable | `messages.read` |
| [`message.edited`](https://tlg.builera.app/en/docs/reference/events/message.edited) | Message edited | Subscribable | `messages.read` |
| [`message.deleted`](https://tlg.builera.app/en/docs/reference/events/message.deleted) | Message deleted | Subscribable | `messages.read` |
| [`message.reaction`](https://tlg.builera.app/en/docs/reference/events/message.reaction) | Reaction on a message | Subscribable | `messages.read` |

### Conversations

| Code | Name | Status | Scope |
| --- | --- | --- | --- |
| [`conversation.created`](https://tlg.builera.app/en/docs/reference/events/conversation.created) | New conversation | Subscribable | `messages.read` |
| [`conversation.updated`](https://tlg.builera.app/en/docs/reference/events/conversation.updated) | Conversation changed | Subscribable | `messages.read` |
| [`conversation.assigned`](https://tlg.builera.app/en/docs/reference/events/conversation.assigned) | Assignee changed | Subscribable | `messages.read` |
| [`conversation.lock_changed`](https://tlg.builera.app/en/docs/reference/events/conversation.lock_changed) | Conversation holder changed | Subscribable | `messages.read` |
| [`conversation.loop_suspected`](https://tlg.builera.app/en/docs/reference/events/conversation.loop_suspected) | Two bots may be talking | Subscribable | `messages.read` |

### Groups & channels

| Code | Name | Status | Scope |
| --- | --- | --- | --- |
| [`group.joined`](https://tlg.builera.app/en/docs/reference/events/group.joined) | Joined a group | Subscribable | `accounts.read` |
| [`group.left`](https://tlg.builera.app/en/docs/reference/events/group.left) | Left a group | Subscribable | `accounts.read` |
| [`group.member_joined`](https://tlg.builera.app/en/docs/reference/events/group.member_joined) | Someone joined a group | Subscribable | `messages.read` |
| [`group.member_left`](https://tlg.builera.app/en/docs/reference/events/group.member_left) | Someone left a group | Subscribable | `messages.read` |
| [`group.join_request`](https://tlg.builera.app/en/docs/reference/events/group.join_request) | Join request | Subscribable | `messages.read` |
| [`group.updated`](https://tlg.builera.app/en/docs/reference/events/group.updated) | Group changed | Subscribable | `messages.read` |
| [`group.admin_changed`](https://tlg.builera.app/en/docs/reference/events/group.admin_changed) | Group admins changed | Planned | `messages.read` |
| [`discovery.scan_done`](https://tlg.builera.app/en/docs/reference/events/discovery.scan_done) | Group scan finished | Subscribable | `accounts.read` |
| [`discovery.keyword_signal`](https://tlg.builera.app/en/docs/reference/events/discovery.keyword_signal) | Keyword signal | Subscribable | `crm.read` |

### Telegram contacts

| Code | Name | Status | Scope |
| --- | --- | --- | --- |
| [`friend.added`](https://tlg.builera.app/en/docs/reference/events/friend.added) | Saved to contacts | Subscribable | `messages.read` |
| [`friend.removed`](https://tlg.builera.app/en/docs/reference/events/friend.removed) | Removed from contacts | Subscribable | `messages.read` |
| [`friend.blocked`](https://tlg.builera.app/en/docs/reference/events/friend.blocked) | Blocked | Subscribable | `messages.read` |
| [`friend.unblocked`](https://tlg.builera.app/en/docs/reference/events/friend.unblocked) | Unblocked | Subscribable | `messages.read` |
| [`friend.request_received`](https://tlg.builera.app/en/docs/reference/events/friend.request_received) | Friend request | Not applicable to Telegram | `messages.read` |
| [`friend.accepted`](https://tlg.builera.app/en/docs/reference/events/friend.accepted) | Friend request accepted | Not applicable to Telegram | `messages.read` |
| [`story.posted`](https://tlg.builera.app/en/docs/reference/events/story.posted) | New story | Subscribable | `messages.read` |

### People (CRM)

| Code | Name | Status | Scope |
| --- | --- | --- | --- |
| [`contact.created`](https://tlg.builera.app/en/docs/reference/events/contact.created) | New customer | Subscribable | `crm.read` |
| [`contact.updated`](https://tlg.builera.app/en/docs/reference/events/contact.updated) | Customer changed | Subscribable | `crm.read` |
| [`contact.stage_changed`](https://tlg.builera.app/en/docs/reference/events/contact.stage_changed) | Customer stage changed | Subscribable | `crm.read` |
| [`contact.dnc_changed`](https://tlg.builera.app/en/docs/reference/events/contact.dnc_changed) | Do-not-contact changed | Subscribable | `crm.read` |
| [`contact.deleted`](https://tlg.builera.app/en/docs/reference/events/contact.deleted) | Customer deleted | Subscribable | `crm.read` |

### Campaigns

| Code | Name | Status | Scope |
| --- | --- | --- | --- |
| [`campaign.started`](https://tlg.builera.app/en/docs/reference/events/campaign.started) | Campaign started | Subscribable | `crm.read` |
| [`campaign.paused`](https://tlg.builera.app/en/docs/reference/events/campaign.paused) | Campaign paused | Subscribable | `crm.read` |
| [`campaign.resumed`](https://tlg.builera.app/en/docs/reference/events/campaign.resumed) | Campaign resumed | Subscribable | `crm.read` |
| [`campaign.completed`](https://tlg.builera.app/en/docs/reference/events/campaign.completed) | Campaign finished | Subscribable | `crm.read` |
| [`campaign.step_sent`](https://tlg.builera.app/en/docs/reference/events/campaign.step_sent) | Campaign step sent | Subscribable | `crm.read` |
| [`campaign.replied`](https://tlg.builera.app/en/docs/reference/events/campaign.replied) | Customer replied to a campaign | Subscribable | `crm.read` |
| [`campaign.enrollment_completed`](https://tlg.builera.app/en/docs/reference/events/campaign.enrollment_completed) | Customer finished the campaign | Subscribable | `crm.read` |
| [`campaign.enrollment_stopped`](https://tlg.builera.app/en/docs/reference/events/campaign.enrollment_stopped) | Customer stopped mid-campaign | Subscribable | `crm.read` |

### Jobs / commands

| Code | Name | Status | Scope |
| --- | --- | --- | --- |
| [`operation.queued`](https://tlg.builera.app/en/docs/reference/events/operation.queued) | Operation queued | Subscribable | `accounts.read` |
| [`operation.started`](https://tlg.builera.app/en/docs/reference/events/operation.started) | Operation started | Subscribable | `accounts.read` |
| [`operation.completed`](https://tlg.builera.app/en/docs/reference/events/operation.completed) | Operation completed | Subscribable | `accounts.read` |
| [`operation.failed`](https://tlg.builera.app/en/docs/reference/events/operation.failed) | Operation failed | Subscribable | `accounts.read` |
| [`operation.waiting`](https://tlg.builera.app/en/docs/reference/events/operation.waiting) | Operation waiting | Subscribable | `accounts.read` |
| [`operation.blocked`](https://tlg.builera.app/en/docs/reference/events/operation.blocked) | Operation refused | Subscribable | `accounts.read` |
| [`operation.unverified`](https://tlg.builera.app/en/docs/reference/events/operation.unverified) | Operation unconfirmed | Subscribable | `accounts.read` |
| [`operation.cancelled`](https://tlg.builera.app/en/docs/reference/events/operation.cancelled) | Operation cancelled | Subscribable | `accounts.read` |
| [`confirmation.requested`](https://tlg.builera.app/en/docs/reference/events/confirmation.requested) | Agent asks for confirmation | Subscribable | `accounts.read` |
| [`confirmation.resolved`](https://tlg.builera.app/en/docs/reference/events/confirmation.resolved) | Confirmation answered | Subscribable | `accounts.read` |

### Accounts

| Code | Name | Status | Scope |
| --- | --- | --- | --- |
| [`account.status_changed`](https://tlg.builera.app/en/docs/reference/events/account.status_changed) | Account status changed | Subscribable | `accounts.read` |
| [`account.session_changed`](https://tlg.builera.app/en/docs/reference/events/account.session_changed) | Login session changed | Subscribable | `accounts.read` |
| [`account.safety_changed`](https://tlg.builera.app/en/docs/reference/events/account.safety_changed) | Safety level changed | Subscribable | `accounts.read` |
| [`account.connection_changed`](https://tlg.builera.app/en/docs/reference/events/account.connection_changed) | Telegram connection changed | Subscribable | `accounts.read` |
| [`account.policy_changed`](https://tlg.builera.app/en/docs/reference/events/account.policy_changed) | Run settings changed | Subscribable | `accounts.read` |
| [`account.login_needs_code`](https://tlg.builera.app/en/docs/reference/events/account.login_needs_code) | Login waiting for a code | Subscribable | `accounts.manage` |
| [`account.login_needs_password`](https://tlg.builera.app/en/docs/reference/events/account.login_needs_password) | Login waiting for the two-step password | Subscribable | `accounts.manage` |
| [`account.login_completed`](https://tlg.builera.app/en/docs/reference/events/account.login_completed) | Login completed | Subscribable | `accounts.read` |
| [`account.sync_gap`](https://tlg.builera.app/en/docs/reference/events/account.sync_gap) | Messages may be missing | Subscribable | `accounts.read` |

### Machines & proxies

| Code | Name | Status | Scope |
| --- | --- | --- | --- |
| [`node.online`](https://tlg.builera.app/en/docs/reference/events/node.online) | Machine online | Subscribable | `accounts.read` |
| [`node.offline`](https://tlg.builera.app/en/docs/reference/events/node.offline) | Machine unreachable | Subscribable | `accounts.read` |
| [`proxy.failed`](https://tlg.builera.app/en/docs/reference/events/proxy.failed) | Proxy failed | Subscribable | `accounts.read` |
| [`proxy.recovered`](https://tlg.builera.app/en/docs/reference/events/proxy.recovered) | Proxy recovered | Subscribable | `accounts.read` |

### System

| Code | Name | Status | Scope |
| --- | --- | --- | --- |
| [`alert.created`](https://tlg.builera.app/en/docs/reference/events/alert.created) | New alert | Subscribable | `audit.read` |
| [`config.changed`](https://tlg.builera.app/en/docs/reference/events/config.changed) | Config applied | Subscribable | `accounts.read` |
| [`routine.run_completed`](https://tlg.builera.app/en/docs/reference/events/routine.run_completed) | Routine run finished | Subscribable | `accounts.read` |
| [`rule.fired`](https://tlg.builera.app/en/docs/reference/events/rule.fired) | Automation rule fired | Subscribable | `accounts.read` |
| [`webhook.disabled`](https://tlg.builera.app/en/docs/reference/events/webhook.disabled) | Webhook disabled itself | Subscribable | `webhooks.read` |
| [`webhook.suspended`](https://tlg.builera.app/en/docs/reference/events/webhook.suspended) | Webhook lost its rights | Subscribable | `webhooks.read` |
| [`webhook.test`](https://tlg.builera.app/en/docs/reference/events/webhook.test) | Test ping | Internal | `webhooks.read` |
| [`webhook.verify`](https://tlg.builera.app/en/docs/reference/events/webhook.verify) | Verification challenge | Internal | `webhooks.read` |