whatsapp_diagnose

WhatsApp · macOS · Windows

Effect: read (strongest supported action). Status: gated.

Gated means the tool requires an installed app, a connected account, permission, or runtime availability. Check those requirements on the listed platform before using it.

macOS

Purpose

WhatsApp health check (wacli doctor): which account is linked (number), last sync time, store lock, message/chat counts, a `link_state` verdict — not_linked (the user must scan a QR) · linked_idle (linked, no socket open right now; wacli reconnects on demand, nothing to do; the summary says whether a send has confirmed the link or only the record on this Mac has) · linked_locked (another process holds this account's store lock right now, named when the doctor says who: not idle, retry shortly) · linked_live · linked_session_lost (the last send was refused as not authenticated: the user must re-link) — and `sync_running` / `sync_started_at` / `sync_last_completed_at` / `sync_last_result` for the background job whatsapp_sync starts (#1453). Read `link_state` and `requires_user_action`, NOT `connected`: a linked session spends most of its time with `connected: false`, which on its own says nothing about whether sends work — a session WhatsApp refuses by version looks identical. Treating it as an outage tells the user to re-link a healthy link (#2138).

Required inputs

No required inputs are declared in this platform's schema. Optional selectors and runtime requirements may still apply.

Permissions and confirmation

No explicit confirmation parameter is exposed in this snapshot. This does not grant permission to act: obtain user authorization before any real action.

Use only the apps, accounts and resources authorized by the user on this platform. Consult this tool's platform-specific description for its connection and permission requirements; this catalog does not assert additional OAuth scopes or OS entitlements.

Full input schema — macOS

{
  "properties": {
    "account": {
      "description": "Which linked WhatsApp account to use: its label or id from whatsapp_list_accounts. Leave it out to use the default account.",
      "type": "string"
    }
  },
  "type": "object"
}

Documentation example

Do not execute this example. These concrete inputs refer to a fictional demonstration dataset. Resolve real handles and obtain user authorization before any real call.

{}

Windows

Purpose

WhatsApp health check (wacli doctor): which account is linked (number), last sync time, store lock, message/chat counts, a `link_state` verdict — not_linked (the user must scan a QR) · linked_idle (linked, no socket open right now; wacli reconnects on demand, nothing to do) · linked_live · linked_session_lost (the last send was refused as not authenticated: the user must re-link) — and `sync_running` / `sync_started_at` / `sync_last_completed_at` / `sync_last_result` for the background job whatsapp_sync starts (#1453). Read `link_state` and `requires_user_action`, NOT `connected`: a linked session spends most of its time with `connected: false`, which on its own says nothing about whether sends work — a session WhatsApp refuses by version looks identical. Treating it as an outage tells the user to re-link a healthy link (#2138).

Required inputs

No required inputs are declared in this platform's schema. Optional selectors and runtime requirements may still apply.

Permissions and confirmation

No explicit confirmation parameter is exposed in this snapshot. This does not grant permission to act: obtain user authorization before any real action.

Use only the apps, accounts and resources authorized by the user on this platform. Consult this tool's platform-specific description for its connection and permission requirements; this catalog does not assert additional OAuth scopes or OS entitlements.

Full input schema — Windows

{
  "properties": {
    "account": {
      "description": "Which linked WhatsApp account to use: its label or id from whatsapp_list_accounts. Leave it out to use the default account.",
      "type": "string"
    }
  },
  "type": "object"
}

Documentation example

Do not execute this example. These concrete inputs refer to a fictional demonstration dataset. Resolve real handles and obtain user authorization before any real call.

{}