IntegrationsWhatsApp Business

WhatsApp Business

Novex sends WhatsApp messages — registration confirmations, reminders, magic links, sponsor updates — through your tenant’s own Meta WhatsApp Business account. You connect once, submit templates for approval, and Novex handles the outbound flow.

How the connection works

Novex maintains one Meta Developer App at developers.facebook.com. Each tenant grants their WABA (WhatsApp Business Account) as an asset to that app. The webhook URL is platform-wide and signed with Novex’s app secret — no per-tenant webhook config needed on your side.

One-time setup

  1. Verify your business with Meta. This is a one-time interaction with Meta’s Business Verification UI; allow 1-3 business days.
  2. Create or attach a WABA in your Meta Business Manager. The phone number must be a SMS-verified or voice-verified business number.
  3. In Novex, go to Settings → Integrations → WhatsApp.
  4. Click Connect WABA. The flow opens Meta’s “Embedded Signup” overlay — sign in with the Facebook account that owns the WABA, pick which numbers to grant Novex access to, and confirm.
  5. The connection lands in Novex with status ACTIVE. You can disconnect at any time from the same page.

Submit message templates

Meta requires every outbound non-conversational message to be a pre-approved template. Novex’s template editor:

  1. Pick a category: UTILITY / MARKETING / AUTHENTICATION.
  2. Pick a language (English / Arabic / both — submit two separate templates).
  3. Compose the body with placeholders: {{1}} {{2}} etc.
  4. Add a header (text or media), optional footer, optional buttons.
  5. Submit to Meta. Approval typically takes minutes for UTILITY and AUTHENTICATION; up to 24 h for MARKETING.

Once approved, the template appears in Novex with status APPROVED and is available in send flows.

Send a campaign

  1. Pick the audience: event registrants, sponsor contacts, or marketing contacts.
  2. Pick an approved template.
  3. Fill the placeholders ({{1}} = first name, {{2}} = event name, etc.).
  4. Schedule for now or a future time.
  5. Send.

Novex queues each message via BullMQ and rate-limits to stay under Meta’s per-WABA throughput cap (Meta classifies you in tiers 250 → 1k → 10k → 100k → unlimited based on quality + opt-ins).

Quality and opt-outs

  • Every contact has a per-list opt-out flag. The campaign send-loop skips opted-out recipients silently — they’re not even queued.
  • Inbound replies hit the platform webhook and surface in the recipient’s contact record in Novex.
  • If Meta lowers your quality rating (red flag in the WhatsApp Manager UI), Novex flags it on the Integrations dashboard so you can throttle back voluntarily.

Troubleshooting

  • “Number not connected” — Re-run the embedded-signup flow. Often a number was added to the WABA after the initial grant; the asset list needs a refresh.
  • Template stuck PENDING — Meta is slow on first submissions from a new account. Wait 1-24 h before resubmitting; resubmits don’t accelerate review.
  • Webhook events not arriving — Confirm the WABA appears in Settings → Integrations → WhatsApp → Granted assets. If it’s missing, the asset grant lapsed; redo the embedded signup.

Next

ZATCA (KSA)Command Center