{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-agen-for-work/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["Notification","LightboxImage"]},"type":"markdown"},"seo":{"title":"WhatsApp Business integration","siteUrl":"https://developers.frontegg.com/","llmstxt":{"title":"Frontegg Developer Documentation","description":"Authentication, authorization, and user management for Customer Identity, plus Agen for SaaS and Agen for Work. Guides, SDKs, and API references.","sections":[{"title":"Customer Identity (CIAM)","description":"Auth, SSO, SCIM, entitlements, and user management — guides, SDKs, and APIs.","includeFiles":["ciam/**/*.md"],"excludeFiles":[]},{"title":"Agen for SaaS","description":"Agentic access and authorization for SaaS products.","includeFiles":["agen-for-saas/**/*.md"],"excludeFiles":[]},{"title":"Agen for Work","description":"Agentic access and authorization for internal and workforce use.","includeFiles":["agen-for-work/**/*.md"],"excludeFiles":[]},{"title":"Platform","description":"Shared platform overview.","includeFiles":["platform/**/*.md"],"excludeFiles":[]}],"excludeFiles":["internal-docs/**","ciam/guides/env-settings/inject-client-ip.md","CLAUDE.md","**/images/**"],"hide":false}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"whatsapp-business-integration","__idx":0},"children":["WhatsApp Business integration"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Integrating WhatsApp Business with Frontegg lets your application read and manage WhatsApp Business Accounts (WABAs), send and receive messages, manage phone numbers and message templates, and act on behalf of a business on the WhatsApp Business Platform — all through Frontegg's integration layer using Meta OAuth."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The integration is built on top of the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://developers.facebook.com/docs/graph-api"},"children":["Meta Graph API"]}," and the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://developers.facebook.com/docs/whatsapp/cloud-api"},"children":["WhatsApp Business Cloud API"]},". You configure the integration by creating a Meta for Developers app, connecting it to a Meta Business Portfolio, and adding the required permissions."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Notification","attributes":{"title":"Prerequisites","type":"attention"},"children":[{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://developers.facebook.com/"},"children":["Meta for Developers"]}," account with a verified phone number and email."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://business.facebook.com/"},"children":["Meta Business Portfolio"]}," (also called a Business Manager account). If your company already has one, ask your business admin to add you instead of creating a new portfolio."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://www.facebook.com/business/help/2087193751603668"},"children":["WhatsApp Business Account (WABA)"]}," connected to that Business Portfolio, with at least one verified phone number."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Permission to create apps in the Business Portfolio and request data access (typically Admin role)."]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"create-a-meta-app","__idx":1},"children":["Create a Meta app"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"step-1-open-the-meta-for-developers-apps-page","__idx":2},"children":["Step 1: Open the Meta for Developers apps page"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Sign in to the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://developers.facebook.com/apps/"},"children":["Meta for Developers apps page"]}," with your Facebook account. Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Create App"]}," to start the app creation flow."]},{"$$mdtype":"Tag","name":"LightboxImage","attributes":{"isLightbox":true},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/whatsapp-business-1.d7f778c28ebda439d5d8c46c9e54e85aaf3cf4f5a87f167e5c1e1b6e07649eb4.1ce25488.png","alt":"Meta for Developers Apps page with Create App highlighted"},"children":[]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"step-2-add-app-details","__idx":3},"children":["Step 2: Add app details"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Enter an ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["App name"]}," (for example, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Frontegg Integration"]},") and confirm the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["App contact email"]},". Meta uses this email for policy notifications and recovery — set it to an address you check regularly. Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Next"]},"."]},{"$$mdtype":"Tag","name":"LightboxImage","attributes":{"isLightbox":true},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/whatsapp-business-2.1724c738e3960103ddfde4b7c632570e886f4ee90b2bebe19b459b3e34b615d1.1ce25488.png","alt":"Create an app App details step with name filled in and Next highlighted"},"children":[]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"step-3-select-the-whatsapp-use-case","__idx":4},"children":["Step 3: Select the WhatsApp use case"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["On the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Use cases"]}," step, choose ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Connect with customers through WhatsApp"]},". This automatically provisions the WhatsApp product, Facebook Login for Business, and the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["whatsapp_business_management"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["whatsapp_business_messaging"]}," permissions. Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Next"]},"."]},{"$$mdtype":"Tag","name":"Notification","attributes":{"title":"Use cases can't be combined","type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After selecting the WhatsApp use case, other use cases (Facebook Login, Instant Games, etc.) become disabled on the same app. If you need them for a different integration, create a separate app."]}]},{"$$mdtype":"Tag","name":"LightboxImage","attributes":{"isLightbox":true},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/whatsapp-business-3.1838c7dd078e6cddb9bac0b408af9db17c709b8970bf5e83861fc9d7cc3c095d.1ce25488.png","alt":"Use cases step with Connect with customers through WhatsApp highlighted"},"children":[]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"step-4-connect-a-business-portfolio","__idx":5},"children":["Step 4: Connect a Business Portfolio"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["On the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Business"]}," step, choose the Business Portfolio that owns your WABA. If no portfolios are listed, create one in ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://business.facebook.com/overview"},"children":["Meta Business Manager"]}," first, then return to this step."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Next"]}," through the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Requirements"]}," and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Overview"]}," steps, then click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Create app"]},". Meta opens the app dashboard once the app is created."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"copy-the-credentials","__idx":6},"children":["Copy the credentials"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"step-5-find-the-app-id-and-app-secret","__idx":7},"children":["Step 5: Find the App ID and App secret"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the app dashboard, open ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["App settings → Basic"]}," from the left navigation. Copy the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["App ID"]}," — this is your Frontegg ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Client ID"]},". Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Show"]}," next to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["App secret"]}," (Meta asks you to re-enter your Facebook password), then copy the value — this is your Frontegg ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Client Secret"]},"."]},{"$$mdtype":"Tag","name":"Notification","attributes":{"title":"Treat the App secret like a password","type":"attention"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The App secret grants full access to your app. Never commit it to source control or share it outside the Frontegg portal configuration."]}]},{"$$mdtype":"Tag","name":"LightboxImage","attributes":{"isLightbox":true},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/whatsapp-business-4.1a92a080093f80a6b537c377759f6eeee5224c6d8f51bf8b2d5fc416991baf76.1ce25488.png","alt":"App settings Basic page with App ID and App secret fields highlighted"},"children":[]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"configure-the-redirect-url","__idx":8},"children":["Configure the redirect URL"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"step-6-add-the-frontegg-redirect-uri","__idx":9},"children":["Step 6: Add the Frontegg redirect URI"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the left navigation, expand ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Facebook Login for Business"]}," and click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Settings"]},". In the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Valid OAuth Redirect URIs"]}," field, paste your Frontegg redirect URL:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://YOUR_MCP_GATEWAY_URL/integration-callback"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Replace ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["YOUR_MCP_GATEWAY_URL"]}," with the MCP Gateway URL from the Frontegg portal ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Settings → Basic configuration"]}," page. Press ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Enter"]}," to add the URI, then click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Save changes"]}," at the bottom of the page."]},{"$$mdtype":"Tag","name":"LightboxImage","attributes":{"isLightbox":true},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/whatsapp-business-5.c1b3e5f07fac8d1576857eb6a2a784bfae3b5b2ad297f23b9aef32704bb06ad7.1ce25488.png","alt":"Facebook Login for Business Settings page with Valid OAuth Redirect URIs configured"},"children":[]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"configure-permissions","__idx":10},"children":["Configure permissions"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"step-7-add-the-business_management-permission","__idx":11},"children":["Step 7: Add the business_management permission"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the left navigation, click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Use cases"]},", then open the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Connect with customers through WhatsApp"]}," use case and select the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Permissions and features"]}," tab. The WhatsApp use case ships with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["whatsapp_business_management"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["whatsapp_business_messaging"]}," already enabled (status ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Ready for testing"]},"). You need to add ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["business_management"]}," manually — click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Add"]}," in that row."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The integration requires the following permissions:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Permission"},"children":["Permission"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["whatsapp_business_management"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read and manage WhatsApp business assets: WABAs, phone numbers, message templates, QR codes, and webhook subscriptions."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["whatsapp_business_messaging"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Send WhatsApp messages and calls, upload and retrieve media, manage business profile info, and register phone numbers."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["business_management"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read and write with the Business Manager API. Required so Frontegg can resolve the WABA your phone number belongs to."]}]}]}]}]},{"$$mdtype":"Tag","name":"LightboxImage","attributes":{"isLightbox":true},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/whatsapp-business-6.6ae8e62decb35c2ef2342a749b7e6254738f8caaa25809f40f2f2e501df9f5f1.1ce25488.png","alt":"Permissions and features tab with the three required WhatsApp scopes highlighted"},"children":[]}]}]},{"$$mdtype":"Tag","name":"Notification","attributes":{"title":"App Review required for production","type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["whatsapp_business_management"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["whatsapp_business_messaging"]},", and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["business_management"]}," permissions are usable for testing immediately, but Meta requires you to submit the app for ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://developers.facebook.com/docs/app-review/"},"children":["App Review"]}," before they can act on behalf of users outside your development team. App Review needs a Privacy Policy URL, an app icon, and a screencast demonstrating each permission."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"configure-the-frontegg-portal","__idx":12},"children":["Configure the Frontegg portal"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Once you have your ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["App ID (Client ID)"]}," and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["App secret (Client Secret)"]},", enter them in the Frontegg portal:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Open the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Frontegg portal"]}," and navigate to [ENVIRONMENT] → Integrations → WhatsApp Business."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Enter the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Client ID"]}," and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Client Secret"]}," in the corresponding fields."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select the required ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["scopes"]}," (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["whatsapp_business_management"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["whatsapp_business_messaging"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["business_management"]},")."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Save"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When a user authorizes the integration, Meta prompts them to select a WABA and grant the requested permissions."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"additional-resources","__idx":13},"children":["Additional resources"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://developers.facebook.com/docs/whatsapp/cloud-api"},"children":["WhatsApp Business Cloud API documentation"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://developers.facebook.com/docs/whatsapp/business-management-api"},"children":["WhatsApp Business Platform overview"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://developers.facebook.com/docs/permissions"},"children":["Meta Graph API permissions reference"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://developers.facebook.com/docs/app-review/"},"children":["Meta App Review process"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://developers.facebook.com/apps/"},"children":["Meta for Developers apps page"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/agen-for-work/connectors/redirect-url"},"children":["How to get your Redirect URL"]}]}]}]},"headings":[{"value":"WhatsApp Business integration","id":"whatsapp-business-integration","depth":2},{"value":"Create a Meta app","id":"create-a-meta-app","depth":3},{"value":"Step 1: Open the Meta for Developers apps page","id":"step-1-open-the-meta-for-developers-apps-page","depth":4},{"value":"Step 2: Add app details","id":"step-2-add-app-details","depth":4},{"value":"Step 3: Select the WhatsApp use case","id":"step-3-select-the-whatsapp-use-case","depth":4},{"value":"Step 4: Connect a Business Portfolio","id":"step-4-connect-a-business-portfolio","depth":4},{"value":"Copy the credentials","id":"copy-the-credentials","depth":3},{"value":"Step 5: Find the App ID and App secret","id":"step-5-find-the-app-id-and-app-secret","depth":4},{"value":"Configure the redirect URL","id":"configure-the-redirect-url","depth":3},{"value":"Step 6: Add the Frontegg redirect URI","id":"step-6-add-the-frontegg-redirect-uri","depth":4},{"value":"Configure permissions","id":"configure-permissions","depth":3},{"value":"Step 7: Add the business_management permission","id":"step-7-add-the-business_management-permission","depth":4},{"value":"Configure the Frontegg portal","id":"configure-the-frontegg-portal","depth":3},{"value":"Additional resources","id":"additional-resources","depth":3}],"frontmatter":{"category":"Communication","displayName":"WhatsApp Business","seo":{"title":"WhatsApp Business integration"}},"lastModified":"2026-05-29T13:43:28.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/agen-for-work/connectors/marketplace/whatsapp-business","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}