Skip to content
Connectora Connectora Docs

Meta WhatsApp setup

Overview

Connectora uses Meta's Cloud API.

Default for new organizations: Connectora's shared platform Meta app and Connect with Meta (Embedded Signup) on WhatsApp Setup. Merchants do not paste a Meta App ID/Secret for the standard path.

Optional: A platform super admin enables bring-your-own Meta (bring_your_own_meta_app) in God Mode when the customer must use their own Meta Developer App.

WhatsApp Setup default platform Meta app flow
Default connect flow — Connectora platform app + Connect with Meta

Checklist

  1. Meta Business Manager access for the brand
  2. A WhatsApp Business phone number you can verify
  3. Connectora permission to manage WhatsApp Setup
  4. After connect: sync templates and send a test inbound message

Platform Meta app (default)

New organizations use the platform Meta app. On WhatsApp Setup:

  1. Confirm the badge says Connectora platform app
  2. Use step Connect with Meta (fastest) → Connect WhatsApp, or paste Cloud API credentials manually
  3. Register the shared webhook path /webhooks/whatsapp (callback URL + verify token from the page)
  4. Subscribe the WhatsApp product to messages in Meta

Bring your own Meta app (opt-in)

Enable in God Mode

God Mode Meta BYO toggle on organization detail
Super admin enables Own Meta app (BYO) for one organization

Configure on WhatsApp Setup

When BYO is enabled:

WhatsApp Setup BYO credentials and org-scoped webhook
BYO mode — App ID/Secret and organization-scoped webhook
  1. Open Your Meta Developer App on WhatsApp Setup
  2. Save Meta App ID and App Secret
  3. Copy the webhook callback URL and verify token into Meta → WhatsApp → Configuration
  4. Subscribe to messages

Connectora uses your App ID/Secret for token exchange and webhook signature verification.

Connect the WABA

After Meta mode is set (platform default or BYO credentials):

  1. Prefer Connect with Meta when available, or paste WABA ID, Phone number ID, display phone number
  2. Paste a Cloud API access token (required on first manual connect; leave blank on later saves to keep the existing token)
  3. Optionally configure catalog id and catalog greeting
  4. Save connection

When credentials are valid, status shows Connected. Connectora also attempts to subscribe the WABA to the active Meta app so inbound messages reach the correct webhook.

Embedded signup

Connect with Meta bootstraps WABA linkage for the active Meta app mode when Embedded Signup is configured on the platform. You can always finish or repair the connection with manual Cloud API fields.

After connect

  1. Sync templates under Templates
  2. Send a WhatsApp message from the connected phone to yourself and confirm it appears in Inbox
  3. Send a template reply from inbox outside the 24h window to verify outbound delivery