Appearance
Customize the Connect with customers through WhatsApp Use Case
Updated: Apr 16, 2026
This document shows you how to customize the Connect with customers through WhatsApp use case you added to your app during the app creation process in Meta's App Dashboard.
After creating your app with the WhatsApp use case you are redirected to the Customize use case > Connect on WhatsApp page in the dashboard. You can also click the pencil icon Use cases menu item to the left then select the WhatsApp use case Customize button.
The left-side menu lists ways in which you can customize use case settings and permissions to make your app work the way you want it to.
- Permissions and features - View required and optional permissions for this use case and add them to an App Review submission, if applicable.
- Quickstart - Start using the API and learn how to scale your business, improve ROI, and manage your WhatsApp Business account.
- API Setup - Generate access tokens, send and receive messages, and configure webhooks and the WhatsApp SDK.
- Configuration - Configure webhooks and the WhatsApp SDK.
- Resources – View the WhatsApp developer documentation, Meta Blueprint courses, and support resources.
- Tech Provider onboarding – Start scaling the WhatsApp Business Platform for your business.
- Partner Solutions – Create a partner solution.
- Embedded Signup Builder – Integrate Embedded Signup flow into your website or client portal.
Permissions and features
On this page of the dashboard, you will be able to view the required and optional permissions for this use case.
Available permissions
| Permission | Description |
|---|---|
business_management | Optional. You only need this permission if you plan to access your business portfolio programmatically. If you use Meta Business Suite to view your portfolio, this permission is not required. |
email | Optional. You only need this permission if you plan to access your business portfolio programmatically. If you use Meta Business Suite to view your portfolio, this permission is not required. |
public_profile | Required. This permission is required to access the WhatsApp APIs. |
whatsapp_business_manage_events | Optional. You only need this permission if you plan to access the Marketing Messages Lite API with the Conversions API. |
whatsapp_business_management | Required. This permission is required to access the WhatsApp APIs. |
whatsapp_business_messaging | Required. This permission is required to access the WhatsApp APIs. |
View required permissions
The following permissions are required and have been added to your app by default:
public_profilewhatsapp_business_managementwhatsapp_business_messaging
These permissions are required for the WhatsApp use case and can't be removed.
Add optional permissions
Click the Add button next to each optional permission that you want to add.
If your app requires App Review:
- Click the Actions button next to each permission.
- Select +Add to App Review. Only add permissions that your app requires for it to function the way you want it to. Adding unneeded or unused permissions can result in rejection in App Review.
- In the popup window, follow the links to learn more about Access verification and Business verification and App Review then click Continue.
You'll complete the App Review submission process as part of the Tech Provider onboarding flow.
Quickstart
On this page of the dashboard, you'll see a list of the following items:
- Start the API Setup – Get set up on the Cloud API by adding a phone number and sending your first message.
- Scale your business
- Start the process to Become a Tech Provider.
- Agree to the marketing messages terms of service and learn about sending marketing messages to Improve ROI
- WhatsApp Business.
- Account information – Visit the WhatsApp Manager to see alerts, insights, and for your WhatsApp account.
- Message Template – Visit the WhatsApp Manager to create and update message templates and explore samples templates.
- WhatsApp Flows – Visit the WhatsApp Manager to edit and preview your Flows.
- Phone numbers – Visit the WhatsApp Manager to view, add, and manage your phone numbers.
- Configuration
- Webhooks – Configure and manage your webhook callbacks.
- WhatsApp SDK – Follow the link to the GitHub WhatsApp SDK repository.
- Documentation and support
- Need support? – Contact our support team and review open bug reports and support tickets.
- Documentation – Explore the WhatsApp developer documentation to learn how to build on the WhatsApp Business Platform
- Tutorials – Learn about important API features and how to get set up.
API Setup
On this page of the dashboard, you can:
Access Token – Generate short-lived access tokens to test your API calls.
Send and receive messages:
Select From and To phone numbers for the API request.
Send messages using the API or Postman.
Configure webhooks to receive Messages.
Learn about the WhatsApp Business API.
Add and verify a phone number people will see when they chat with you, and add information about your business and WhatsApp Business profile.
Add a payment method in the business manager to start sending business-initiated messages to your customers.
- Improve ROI - Agree to the marketing messages terms of service and learn how to send marketing messages.
Configuration
- Webhooks - Configure and manage your webhook callbacks and add your verify token in the dashboard.
- Permanent token - Visit the developer documentation to learn how to create a permanent token to access the WhatsApp Business API.
- Phone numbers - Manage production and test phone numbers in the WhatsApp Manager.
- Test account - Delete your business: This will unlink your application and delete your business portfolio, test WhatsApp Business Accounts, and phone numbers.
Resources
Find links for the developer documentation and Meta's Blueprint courses as well as resources for contacting support , viewing bug reports, and reviewing your open support tickets.
Tech Provider onboarding
If you are a Tech Provider, you can onboard your clients to the WhatsApp Business API.
On this page of the dashboard, you'll find links to the WhatsApp Embedded Signup developer documentation, Developer Support, and Success Stories as well as steps to complete the Tech Provider onboarding process. This process includes:
Business verification
Click Start verification to verify your business. You'll need the following information:
- Verify business details – Provide your business name, address, phone number, email and website for verification.
- Confirm your connection – Select a way for us to get in touch to confirm your connection to the business.
- Upload documents – You might need to upload accepted documents to confirm these details if your business is not found.
App Review
Once you have completed business verification, you can submit your app for App Review. You'll need to provide the following:
- Review your app settings – Your app will need basic settings such as an app icon, privacy policy, and app category.
- Videos – To pass App Review, you need to submit video evidence of your capabilities to send messages and manage templates.
- Submit for App Review
If you prefer to onboard with a Solution Partner, you can do so by clicking the Onboard with a Solution Partner button at the bottom of the page. You will need to provide your partner's app ID during onboarding to create a partner solution.
Onboard with an existing Solution Partner
After you click the Onboard with a Solution Partner button, the Tech Provider onboarding page will refresh to this flow. The flow is identical to the Tech Provider flow with the additional App Review step to Create a partner solution by entering your partner's app ID to create a partner solution.
To onboard without a partner, you can do so by clicking the Onboard without a partner button at the bottom of the page.
Partner solutions
On this page of the dashboard, you can create a partner solution. Click the Create a partner solution button to start the process or the Learn more button to visit the developer documentation. Once you click the Create a partner solution button the modal will appear for you to enter:
- Solution name - The name for your solution
- Partner app ID - Your partner's app ID. Your partner must then accept this solution request before customers can onboard to this solution. Learn more.
- Permission configuration - Select the permissions.
Click the Send Request button when you are ready to send your partner a request.
Embedded Signup Builder
Getting started with WhatsApp Embedded Signup - Embedded Signup allows Solution Partners to onboard to the WhatsApp Business Platform directly from their website.
Business and app status
In this section you can follow links to learn more about:
App Setup
- Facebook Login for Business Configurations - Facebook Login for Business allows you to create one or more login experiences in the Meta App Dashboard based on the needs of your app. You can specify the access token type, assets, and permissions your app needs, and save it as a configuration. During login, your app users are presented with a configuration that allows them to grant your app access to their business assets. You need to create a login configuration for Embedded Signup.
- Click the Create configuration button to start the process.
- Manage domains - Add your domain to allowlist and enable Login with the JavaScript SDK for your app so that you can start adding Embedded Signup on your website.
- Click the Add allowlist button to add domains.
- App Roles - App roles allow you to control who has permission to edit your app.
- Click Update roles to add and manage app administrators and developers.
Embedded Signup Setup
- JavaScript SDK - Get the JavaScript SDK code that enables you to use Facebook Login.
- Create a System User Access Token - To continue integration with WhatsApp Cloud API, you need to create a system user token.
- Click the Business Settings link to generate a system user access token in the Business Manager.
- Copy the access token and paste it into the System User Access Token field in the Embedded Signup Builder.
- Pre-verified phone numbers - Click the Add phone number button to add a pre-verified phone number to your Embedded Signup Builder.
- Configure a webhook - If you haven't already, configure a webhook to receive messages from your customers.
- Add your Callback URL
- Add your Verify Token
- Click Verify and Save to save your changes and verify your webhook.
- Embedded Signup Pre-fill - If you know details about your customer's business, such as its name and address, you can inject this data into Embedded Signup.
- Click the Edit pre-fill button to add pre-fill data in the modal.
- Click Set prefill to save your changes.
- Copy and paste the JSON code into your Embedded Signup code.
- Session info setup - You can get detailed information about a user as they go through the Embedded Signup user journey.
- Copy and paste the code into your Embedded Signup code.
- Embedded Signup code setup - Sequence of steps to implement the Embedded Signup flow code.
- If you haven't already, add the JavaScript SDK to your website.
- If you haven't already, add the Session info setup code to your website.
- Copy and paste the callback code into your website.
- Copy and paste the set up method to be called on user click to open the Embedded Signup flow.
- Copy and paste the code to add a button to your page to open the Embedded Signup flow.
- Once the flow is complete, your callback function will send the code and IDs to your backend to continue integration. Copy and paste the code to set up the API.
- Embedded Signup Launch - Go through the Embedded Signup flow to share a WhatsApp account and get token for.
- Embedded Signup Dialog - Select an item from each of the following dropdown menus:
- A Login Configuration
- An Embedded Signup Version
- An Info Version, if applicable
- Features
- Feature type, if applicable
- Click Login with Facebook to start the Embedded Signup flow.
- Copy and paste your Meta-hosted Embedded Signup URL into your website.
- The Session Logging Response will return a post-message with the WABA ID and Phone Number IDs.
- Exchange Token - When the user completes the login dialog flow, we will redirect the user to your redirect URL and include a code. You must then exchange this code for an access token by performing a server-to-server call to our servers.
- Copy and paste the authorization code into your website.
- Copy and paste the code to exchange the authorization code for an access token.
Publish
Note: Some use cases require your app to be published.
Required app assets
To publish your app, you need the following assets:
An app icon – Your app's unique icon image; this file must be less than 5 MB, between 512 x 512 and 1024 x 1024 pixels, and in JPEG, GIF or PNG format.
Contact information for a Data Protection Officer, if you are doing business in the European Union.
A Privacy Policy URL for your app
A data deletion URL with instructions or a callback that allows your app user to delete their data from your app.
When you are ready to publish, select Publish in the left side menu.
Review your use cases and requirements.
Click Publish in the lower right corner.
See Also
Visit the following to learn more about the app development process: