This document describes the prerequisites and general steps you need to integrate the embedded signup flow into your website or client portal. For the purposes of this guide, we use the acronym WABA to mention WhatsApp Business Accounts.
To begin the integration of the embedded signup flow, you first need to have a Facebook Business Manager and Facebook app set up.
You need a Facebook Business Manager account to manage your line of credit and client's WhatsApp business accounts. For information on creating a business account, see Create a Business Manager. Once you have a Business Manager set up, verify your business.
Business apps are automatically approved for Standard Access for all Permissions and Features available to the Business app type, so you can develop and test your app while you are in this access level.
Standard Access effectively restricts Business apps to only accessing data owned by app users who have a role on the app or Business. Once you are ready to release your app, you need to complete App Review for the following permissions:
whatsapp_business_management (these permissions are required for embedded signup).
Create a System User in your Business Manager by navigating to Business Settings > Users > System Users. Make sure to assign the System User the Financial Editor role. See About Business Manager Roles and Permissions for more information.
Generate a new System User token with the
whatsapp_business_management permissions to use for all your embedded signup-related API calls.
You need to set up a line of credit to send messages with the WhatsApp Business API. This is the line of credit you will share with your client businesses, so make sure you accept the Credit Allocation API terms under Business Settings > Payments in the Business Manager.
For information on sharing your line of credit through the Business Manager rather than through the API, see Share Access to Monthly Invoicing.
Make sure you are running a non-expired version of the WhatsApp Business API client.
To be released, your Facebook app must go through App Review and request Advanced Access to the
whatsapp_business_management permissions. We recommend starting this process as soon as possible. You don't need to wait for embedded signup to be fully implemented to start this process.
After embedding the signup flow, integrate with the API endpoints needed to complete the integration process. To move to the next step, you need to be able to:
Once registration is complete, use the
message_templates endpoint to get pre-approved message templates and namespaces so businesses can start sending messages.
You must use a secured end-point (HTTPS). For more information, see Login Security
Once businesses have completed the signup, you can subscribe to every WhatsApp business account for which you wish to receive Webhooks. You can set up your webhooks to notify you when:
If you want, you can: