Business Agent

Get agent setup status

One read that says where the merchant is: whether the number is eligible, whether the Meta Business Agent terms are accepted, whether an agent exists, whether it is on, and its settings. manualSteps lists what Zernio can verify is still pending (accepting the terms in WhatsApp Manager); unverifiedSteps lists what Meta exposes no state for (the payment method in Billing Hub). Never fails for those pre-setup states; it reports them as flags.

get/v1/accounts/{accountId}/business-agent

Path parameters

accountIdstring required

WhatsApp social account id (the number must be managed through the Cloud API).

Response

Setup status

eligibleboolean nullable required

Whether the number can run the agent; null when the terms are not accepted yet (Meta refuses the check).

termsAcceptedboolean required

False when Meta rejects calls because the merchant has not accepted the terms in WhatsApp Manager.

onboardedboolean required

An agent exists on the number (onboard was called).

enabledboolean required

The agent answers live conversations.

agentIdstring nullable required

Example response

{
  "settings": {
    "channel": "whatsapp"
  }
}

Changes