Skip to content

agent.reach.changed ​

When: Whether a call can ring the agent now changed: CONNECTED (an app or browser of theirs is connected), PUSH_ONLY (none connected, a device registered for push), UNREACHABLE (neither: a call to a line they own ends NO_ANSWER at once). See Agents

Extra data: data is { agent_ref, agent_id, reach, previous_reach }; previous_reach null the first time

Example ​

Headers: X-Calloop-Event: agent.reach.changed, X-Calloop-Event-Id, X-Calloop-Signature (verifying).

json
{
  "event_id": "7c0b1e0c-8a45-4c1b-9d4c-0f3a6a2f9b11",
  "event_type": "agent.reach.changed",
  "api_version": "2026-09-25",
  "livemode": true,
  "occurred_at": "2026-09-25T10:05:12.000Z",
  "tenant_ref": "biz-123",
  "data": {
    "agent_ref": "user-7",
    "agent_id": 7,
    "reach": "PUSH_ONLY",
    "previous_reach": "CONNECTED"
  }
}

No data.call: this event is about an agent, not a call. The top-level tenant_ref names the agent's tenant.