💬

WhatsApp (Cloud API)

whatsapp_cloudchannel

disabled

Meta WhatsApp Cloud API. Requires Meta Business verification + WABA.

Setup checklist

3 of 7 done

✓

Create a Meta Business account

Required to operate WhatsApp Business API. Verification can take 2–7 business days.

✓

Set up a WhatsApp Business Account (WABA)

Inside Meta Business Manager → WhatsApp Accounts → Create.

✓

Add a phone number to your WABA

The number must not already be active on WhatsApp; SMS/voice verification required.

Create a Meta Developer App with WhatsApp product

developers.facebook.com → My Apps → Create App → Business → add WhatsApp.

Generate a System User permanent access token

Business Settings → System Users → Create → grant whatsapp_business_messaging + whatsapp_business_management scopes.

Configure webhook URL

Point Meta to https://<your-install>/api/webhooks/whatsapp with your verify token below.

Submit message templates for approval

Required for non-session messages. Approval takes minutes-to-days. Manage in Message Templates master.

All credentials are encrypted at rest. Mask shown above; real values stored via secret manager reference.

Phone number ID*

WhatsApp Business Account ID*

Permanent access token*

System User token with whatsapp_business_messaging scope.

Webhook verify token*

You set this; Meta echoes it back on verification.

Default locale*

Verify credentials with a real call to the provider.

Sends a test request with the current configuration. Doesn't enable the module — preview only.

Every config change recorded with diff.

Timestamp	Actor	Change
2026-05-23 11:42	Jagdish H.	config_update: smtp_host changed
2026-05-22 09:18	Jagdish H.	module.enable
2026-05-22 09:14	Jagdish H.	config_create: initial setup

⚠ 5 required fields empty