Profile Intelligence and Presence Signals

Enrich runtime messaging with contact/group context and near-real-time availability snapshots.

Lookup Endpoints

  • GET /devices/{device_id}/profile?jid={jid}&preview={true|false} - contact or group profile.
  • GET /devices/{device_id}/groups - joined groups summary.
  • GET /devices/{device_id}/presence?jid={jid} - presence status snapshot.

Behavior and Freshness Notes

  • /profile auto-detects contact vs group JID.
  • Presence response includes freshness indicators such as updated_at, age_seconds, and stale.
  • These endpoints require a connected device; for internal flow, auth is handled server-side.