Skip to content

agent.availability.changed ​

When: An agent's reported availability changed: ON_CALL while a call holds them, else their shift (AVAILABLE, OFFLINE)

Extra data: data is { agent_ref, agent_id, availability, reason? }; reason: auto_offline_missed_calls when the auto-offline policy took the agent offline

Example ​

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

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

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

Calloop — the call engine behind your product.