Docs

Reference

Events

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

View MarkdownThis page is generated from the source code on every release.

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 Customer message Subscribable messages.read
message.mentioned Mentioned Subscribable messages.read
message.reply_to_me Reply to my message Subscribable messages.read
message.sent Message sent Subscribable messages.read
message.status_changed Outgoing message status changed Subscribable messages.read
message.edited Message edited Subscribable messages.read
message.deleted Message deleted Subscribable messages.read
message.reaction Reaction on a message Subscribable messages.read

Conversations

Code Name Status Scope
conversation.created New conversation Subscribable messages.read
conversation.updated Conversation changed Subscribable messages.read
conversation.assigned Assignee changed Subscribable messages.read
conversation.lock_changed Conversation holder changed Subscribable messages.read
conversation.loop_suspected Two bots may be talking Subscribable messages.read

Groups & channels

Code Name Status Scope
group.joined Joined a group Subscribable accounts.read
group.left Left a group Subscribable accounts.read
group.member_joined Someone joined a group Subscribable messages.read
group.member_left Someone left a group Subscribable messages.read
group.join_request Join request Subscribable messages.read
group.updated Group changed Subscribable messages.read
group.admin_changed Group admins changed Planned messages.read
discovery.scan_done Group scan finished Subscribable accounts.read
discovery.keyword_signal Keyword signal Subscribable crm.read

Telegram contacts

Code Name Status Scope
friend.added Saved to contacts Subscribable messages.read
friend.removed Removed from contacts Subscribable messages.read
friend.blocked Blocked Subscribable messages.read
friend.unblocked Unblocked Subscribable messages.read
friend.request_received Friend request Not applicable to Telegram messages.read
friend.accepted Friend request accepted Not applicable to Telegram messages.read
story.posted New story Subscribable messages.read

People (CRM)

Code Name Status Scope
contact.created New customer Subscribable crm.read
contact.updated Customer changed Subscribable crm.read
contact.stage_changed Customer stage changed Subscribable crm.read
contact.dnc_changed Do-not-contact changed Subscribable crm.read
contact.deleted Customer deleted Subscribable crm.read

Campaigns

Code Name Status Scope
campaign.started Campaign started Subscribable crm.read
campaign.paused Campaign paused Subscribable crm.read
campaign.resumed Campaign resumed Subscribable crm.read
campaign.completed Campaign finished Subscribable crm.read
campaign.step_sent Campaign step sent Subscribable crm.read
campaign.replied Customer replied to a campaign Subscribable crm.read
campaign.enrollment_completed Customer finished the campaign Subscribable crm.read
campaign.enrollment_stopped Customer stopped mid-campaign Subscribable crm.read

Jobs / commands

Code Name Status Scope
operation.queued Operation queued Subscribable accounts.read
operation.started Operation started Subscribable accounts.read
operation.completed Operation completed Subscribable accounts.read
operation.failed Operation failed Subscribable accounts.read
operation.waiting Operation waiting Subscribable accounts.read
operation.blocked Operation refused Subscribable accounts.read
operation.unverified Operation unconfirmed Subscribable accounts.read
operation.cancelled Operation cancelled Subscribable accounts.read
confirmation.requested Agent asks for confirmation Subscribable accounts.read
confirmation.resolved Confirmation answered Subscribable accounts.read

Accounts

Code Name Status Scope
account.status_changed Account status changed Subscribable accounts.read
account.session_changed Login session changed Subscribable accounts.read
account.safety_changed Safety level changed Subscribable accounts.read
account.connection_changed Telegram connection changed Subscribable accounts.read
account.policy_changed Run settings changed Subscribable accounts.read
account.login_needs_code Login waiting for a code Subscribable accounts.manage
account.login_needs_password Login waiting for the two-step password Subscribable accounts.manage
account.login_completed Login completed Subscribable accounts.read
account.sync_gap Messages may be missing Subscribable accounts.read

Machines & proxies

Code Name Status Scope
node.online Machine online Subscribable accounts.read
node.offline Machine unreachable Subscribable accounts.read
proxy.failed Proxy failed Subscribable accounts.read
proxy.recovered Proxy recovered Subscribable accounts.read

System

Code Name Status Scope
alert.created New alert Subscribable audit.read
config.changed Config applied Subscribable accounts.read
routine.run_completed Routine run finished Subscribable accounts.read
rule.fired Automation rule fired Subscribable accounts.read
webhook.disabled Webhook disabled itself Subscribable webhooks.read
webhook.suspended Webhook lost its rights Subscribable webhooks.read
webhook.test Test ping Internal webhooks.read
webhook.verify Verification challenge Internal webhooks.read