Events and recovery
Combine live notifications with durable account and chat logs.
The API separates notification from durable content:
GET /v1/streams/eventsdelivers live account events over SSE.GET /v1/event_logpages the same account sequence for bounded recovery.GET /v1/chats/{chat}/eventsreturns the detailed, gapless journal for one chat.
An account event identifies a chat and a seq_from–seq_to range. Fetch that
range from the chat journal to read the content. Do not treat every event as a
reply trigger: one customer message may also produce a window-opened event,
and an outbound message may later produce delivered and read events.
Cursor rules
Section titled “Cursor rules”- Persist the SSE
idand send it back asLast-Event-IDafter reconnecting. - The event-log cursor is opaque; pass
next_cursorback unchanged. - A chat cursor is the last gapless numeric
seqyou processed. - Keep all three cursor domains separate.
- A cursor older than retained account history returns
410 cursor_expired. - Ignore unknown event kinds so newly added kinds remain backward compatible.
Webhooks carry the same stable event identity as the stream. Deduplicate the two sinks by event ID if you consume both.