WhatsApp is the OAuth resource every WhatsApp activity authenticates through. It authorizes access to a Meta business portfolio and its WhatsApp Business Accounts, and stores the OAuth credentials. The connection signs in with the Meta identity provider.
The resource has two tabs: Configuration and Customized Scopes.
Configuration
| Field | Required | Description |
|---|---|---|
| Name | Required | Name of the resource. |
| Description | Optional | Description of the resource. |
| Environment | Optional | Select the environment to specify the connection targets. Development or Production. Defaults to Development. |
| Enable Client Managed Credentials | Optional | When enabled, this allows you to provide the Client ID and Secret directly in the form. Defaults to off. |
| OAuth Client Id | Optional | The public identifier (Client ID) issued by the OAuth provider. Shown only when Enable Client Managed Credentials is on. |
| OAuth Client Secret | Optional | The confidential secret (Client Secret) issued by the OAuth provider. Shown only when Enable Client Managed Credentials is on. |
| Authenticate | — | The Sign in with Meta button. Starts the authorization flow. |
| Context Tags | Optional | Define the tags that must be provided at runtime to establish a connection. Shown only when the connection is managed per runtime context. |
With Enable Client Managed Credentials on, authenticate the connection before saving. After saving, the Client ID and Client Secret aren't accessible, and if you skip authenticating you'll need to re-enter both.
When you click Sign in with Meta, Meta asks which business portfolio and WhatsApp accounts to share. Select the business portfolio that owns your WhatsApp Business Account, or the activities can't reach it. See Connect WhatsApp.
Customized Scopes
Scopes lists the permissions requested when you sign in.
| Scope | Default | Description |
|---|---|---|
whatsapp_business_management | Selected, required | Manage WhatsApp Business Accounts, phone numbers, templates |
whatsapp_business_messaging | Selected, required | Send and receive WhatsApp messages |
business_management | Selected, required | Access Meta Business Accounts and assets |
catalog_management | Optional | Manage WhatsApp commerce catalogs |
pages_read_engagement | Optional | Read Facebook Page data linked to business accounts |
pages_manage_metadata | Optional | Manage Facebook Page metadata |
The message activities need whatsapp_business_messaging. The template and phone-number
activities need whatsapp_business_management.