Docs

Reference

message.status_changed — Outgoing message status changed

An outgoing message was read (read — one event per read mark), failed to send (failed) or could not be confirmed (unverified).

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

An outgoing message was read (read — one event per read mark), failed to send (failed) or could not be confirmed (unverified).

Since web 1.7.0, worker —.

Name Value
Code message.status_changed
Group Messages
Status Subscribable
Scope needed to receive it messages.read
Tied to one account Yes
Only the connection that caused it receives it No
Filters that apply chat_types, exclude_sent_by, exclude_connection_ids, exclude_own_connection, conversation_ids, conversation_tags
Fields dropped in thin content mode message.text, message.reply_to.text, message.quote_text, conversation.title, conversation.topic.title
Fields written by outside people (untrusted) conversation.title

JSON Schema

https://tlg.builera.app/schemas/events/message.status_changed/2.json

Sample payload (exactly what webhooks.test sends)

{
  "specversion": "1.0",
  "id": "evt_01JDOCSSAMPLE",
  "source": "https://tlg.builera.app/ws/07c2e5e1-c42f-4212-851b-c55b6dd7989d",
  "type": "message.status_changed",
  "time": "2026-10-21T13:45:00.123Z",
  "datacontenttype": "application/json",
  "dataschema": "https://tlg.builera.app/schemas/events/message.status_changed/2.json",
  "platform": "telegram",
  "workspaceid": "07c2e5e1-c42f-4212-851b-c55b6dd7989d",
  "accountid": "1a7d2c40-5b1e-4e7a-9d3f-6c2b8e1f0a11",
  "seq": "000000000000000",
  "schemaversion": "2",
  "correlationid": null,
  "causationid": null,
  "test": true,
  "replay": false,
  "data": {
    "status": "read",
    "read_up_to_tg_message_id": 8813,
    "message": null,
    "conversation": {
      "id": "9f2e4b6a-1c3d-4e5f-8a9b-0c1d2e3f4a5b",
      "chat_type": "direct",
      "title": "Nguyễn Văn A",
      "peer_tg_id": "456789",
      "topic": null,
      "assignee_id": null,
      "tags": [
        "vip"
      ],
      "campaign_id": null,
      "lock": null
    },
    "account": {
      "id": "1a7d2c40-5b1e-4e7a-9d3f-6c2b8e1f0a11",
      "label": "Sale 1",
      "username": "sale_demo_1",
      "tg_user_id": "100200300"
    },
    "links": {
      "app": "https://tlg.builera.app/w/07c2e5e1-c42f-4212-851b-c55b6dd7989d/inbox?c=9f2e4b6a-1c3d-4e5f-8a9b-0c1d2e3f4a5b"
    },
    "untrusted_fields": [
      "conversation.title"
    ]
  }
}
Was this page helpful?

Last checked: 10/24/2026 · build 2.0