Connect WhatsApp

New Connectora organizations use Connectora's platform Meta app by default. On WhatsApp Setup, start with Connect with Meta (Embedded Signup) to link a WhatsApp Business Account (WABA).

Bring-your-own Meta Developer App (BYO) is not the default signup path. A platform super admin enables it per organization in God Mode → Organizations when a customer must use their own Meta app.

Before you start

1. Access to Meta Business Manager for the brand you are connecting
2. A WhatsApp Business phone number you can verify
3. Connectora WhatsApp admin (or manage) permission on WhatsApp Setup

Default path: Connect with Meta

1. Open WhatsApp Setup

In the admin sidebar, open WhatsApp Setup. The header badge should read Connectora platform app.

2. Connect with Meta

1. Open step Connect with Meta (fastest)
2. Click Connect WhatsApp (Meta Embedded Signup)
3. Complete the Meta popup (business portfolio, WABA, phone)
4. Confirm the page badge / hero shows Connected

Prefer to paste Cloud API fields yourself? Skip Embedded Signup and fill WABA ID, Phone number ID, and access token further down the page, then Save connection.

3. Register the webhook (platform)

On the platform Meta app path, the callback URL is the shared webhook:

https://<api-host>/webhooks/whatsapp

Copy Callback URL and Verify token from WhatsApp Setup into Meta → WhatsApp → Configuration, and subscribe to messages.

4. Sync templates

Open Templates and run Sync from Meta so approved templates appear for inbox sends and broadcasts.

Bring your own Meta app (God Mode opt-in)

Use BYO only when compliance or Meta packaging requires the merchant's own Developer App.

Enable BYO (super admin)

1. Sign in as a platform super admin
2. Open God Mode → Organizations → the tenant
3. Under Meta BYO, enable Own Meta app (BYO) and save App ID / secret if prompted

Merchant steps after BYO is on

WhatsApp Setup badge switches to Your Meta app. The Connect with Meta step may still appear when Embedded Signup is configured; BYO always requires your App ID / Secret and an org-scoped webhook.

1. Save Meta App ID and App Secret under Your Meta Developer App
2. Register the webhook callback URL and verify token in Meta → WhatsApp → Configuration
   Path shape: /webhooks/whatsapp/{organization_id}
3. Subscribe to messages
4. Connect the WABA (Embedded Signup and/or manual Cloud API credentials) and Save connection

Common issues

• Connect with Meta missing — Embedded Signup must be enabled on the platform Meta app (META_EMBEDDED_SIGNUP_CONFIG_ID); confirm the org badge is Connectora platform app (not BYO)
• Webhook verification fails (BYO) — paste the exact org-scoped URL and verify token from WhatsApp Setup; App Secret must match the Meta app that owns the webhook
• No inbound messages (platform) — shared /webhooks/whatsapp; platform Meta env configured; BYO disabled
• Phone not appearing — finish business verification in Meta Business Manager
• Templates missing — sync templates after the WABA is connected
• Token expired — paste a new access token in WhatsApp Setup; you do not need to re-enter WABA IDs

Deep dive: Meta WhatsApp setup · Troubleshooting