channels

WhatsApp readiness

Check WABA connection, template, test send, reply and webhook readiness.

Run this before live pilots and after Meta account changes.

Overall status is "ready", "needs_attention" (warnings only) or "blocked" (at least one failing check).

Each check reports status "ok", "warn" or "fail" with keys channel_connected, channel_credentials, approved_templates, recent_outbound and recent_inbound.

action_url and each channel's settings_url are in-dashboard deep links: the account area is /settings, a specific number is /settings/whatsapp/{wabaId} (falling back to /settings when no WABA id is known), templates live at /templates, a pilot send at /whatsapp/campaigns/new and inbound proof at /conversations.

Pass ?channel_id= to scope the snapshot to a single WhatsApp channel; an unknown id returns 404 not_found.

Gate launch automation on status === "ready" (or accept needs_attention if warnings are acceptable).

get/api/v1/channels/whatsapp/readiness

Request

Base URL: https://app.blueticked.com
URL: https://app.blueticked.com/api/v1/channels/whatsapp/readiness
Auth: HTTP bearer

Response

Success

status'ready' | 'needs_attention' | 'blocked' required

request_idstring required

Example response

{
  "checks": [
    {
      "key": "channel_connected",
      "label": "WhatsApp channel connected",
      "message": "1 connected WhatsApp channel found.",
      "action_url": "/settings"
    }
  ],
  "summary": {
    "connected_channels": 1,
    "pending_templates": 1
  },
  "channels": [
    {
      "id": "1891a644-c71d-4a79-b679-6db1db14e065",
      "display_name": "Main number",
      "identifier": "+27210000000",
      "status": "connected",
      "connected_at": "2026-07-01T08:00:00Z",
      "settings_url": "/settings/whatsapp/1234567890"
    }
  ],
  "request_id": "req_b2e3d610e10f1b07468721ee98f0e1d2"
}

Changes

No recorded changes to this operation across all 1 revision of this API.