Fires when the session window for conversational messaging ends, typically because the configured TTL elapsed without a qualifying renewal.

Payload

{
  "id": "evt_xxxxx",
  "event": "conversation.ended",
  "timestamp": "2026-03-29T09:05:00Z",
  "data": {
    "agent_id": "ag_live_xxxx",
    "with": "+4917612345678",
    "ended_at": "2026-03-29T09:05:00Z",
    "reason": "ttl_expired"
  }
}
agent_id
string
RCS agent whose session with this user ended.
with
string
User phone number in E.164 format.
ended_at
string
ISO 8601 time when the session closed.
reason
string
Why the session ended — for example ttl_expired.