Skip to content
Connectora Connectora Docs

Meta WhatsApp setup

Overview

Connectora uses Meta's Cloud API. By default, each organization brings its own Meta Developer App (bring_your_own_meta_app). You configure App ID + App Secret on WhatsApp Setup, register Connectora's org webhook on that app, then connect a WABA and phone number.

A platform super admin can switch an org to Connectora's shared Meta app when needed. Most teams stay on the BYO path.

WhatsApp connection flow
Connect flow in WhatsApp Setup

Checklist

  1. Meta Business Manager access for the brand
  2. A Meta Developer App with WhatsApp product enabled
  3. A WhatsApp Business phone number you can verify
  4. Connectora organization admin role
  5. After connect: sync templates and send a test inbound message

Bring your own Meta app (default)

New organizations have BYO Meta enabled. On WhatsApp Setup:

  1. Open Your Meta Developer App
  2. Save Meta App ID and App Secret
  3. Copy:
    • Webhook callback URL — org-scoped, for example /webhooks/whatsapp/{organization_id}
    • Verify token — paste into Meta webhook settings
  4. In Meta → WhatsApp → Configuration, subscribe to messages

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

Connect the WABA

After Meta app credentials are saved:

  1. Paste WABA ID, Phone number ID, display phone number
  2. Paste a Cloud API access token (required on first 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 your Meta app so inbound messages reach the org webhook.

Embedded signup

Where available, Connect with Meta can bootstrap WABA linkage for the active Meta app mode. 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