Onboarding clients

Connect a client's WhatsApp account

Clients connect securely through Meta's Embedded Signup — you never handle their credentials.

Every partner has a unique public link at /connect/{your-slug}. Share it with a client by email, chat or a button on your own site. When they open it, they see your brand name and a Connect WhatsApp button.

What happens during signup

  1. 1

    Meta Embedded Signup opens

    The client authenticates with Facebook and selects (or creates) their WhatsApp Business Account and phone number.
  2. 2

    Authorization is exchanged

    On completion, the platform exchanges a one-time code for a long-lived access token, which is stored encrypted. The token never leaves the server.
  3. 3

    The client appears in your dashboard

    A Client and its Connection (WABA + number) are created under your account, and the WABA is subscribed to webhooks so status updates flow in.

What you can see afterwards

For each onboarded client: the WABA, phone number(s) with quality rating and status, every template with its approval state, and message delivery stats (sent / delivered / read / failed with reasons).

Multiple numbers & re-connection

A client can have several connections (numbers). Re-running the connect flow for an existing number updates its token and details rather than creating a duplicate.

Self-hosting note

If you deploy your own instance, the platform's OAuth callback URL must be whitelisted in the Meta app settings. The Genuka-hosted version is configured for you.