Last updated
Last updated
The WhatsApp channel allows chatbots and agents to chat with customers via WhatsApp Business Cloud API.
Before starting, you must set up a Meta developer account and a Meta app.
To begin deploying using WhatsApp, navigate to the Chatbots tab and click on Apps. To create a new channel, click on + Create App.
A new window will open. Select WhatsApp, add a name for the channel, and select the default language.
Once the new channel is created, click on the channel you just created and open the Configuration Page tab.
To fill all the fields with the information needed, please follow the next steps in your Meta account:
Enable two-factor authentication for your account
Go to your Security and Login Settings.
Scroll down to Use two-factor authentication and click Edit.
Choose the security method you want to add and follow the on-screen instructions.
Create a Meta App: Go to developers.facebook.com > My Apps > Create App. Select the "Business" type and follow the prompts on your screen
From the App Dashboard, click on the app you would like to connect to WhatsApp. Scroll down to find the "WhatsApp" product and click Set up.
Next, you will see the option to select an existing Business Manager (if you have one) or, if you would like, the onboarding process can create one automatically for you (you can customize your business later if needed). Make a selection and click Continue.
When you click Continue, the onboarding process performs the following actions:
Your App is associated with the Business Manager that you chose, or that was created automatically.
A WhatsApp test phone number is added to your business. You can use this test phone number to explore the WhatsApp Business Platform without registering or migrating a real phone number. Test phone numbers can send unlimited messages to up to 5 recipients (which can be anywhere in the world).
After that, your browser navigates to the Getting Started tab, where you can learn about and experiment with the WhatsApp Business Platform. The Getting Started tab contains tools and information to help you send test messages. It can be used with test phone numbers and any of your own phone numbers that you register.
Copy the App ID and App Secret from the Dashboard of the App you created > Settings > Basic. Paste it on the WhatsApp channel you created on Proto's platform.
Copy the User Access Token from your Business Manager Dashboard you created. Select the business that was connected with your Meta App and WhatsApp Account. If you don't have a System User, click on the Add button to add an ADMIN system user to your Business Account.
We recommend using the ADMIN role in the System User for your production deployment. See About Business Manager Roles and Permissions for more information.
Now you are ready to generate your token. In the system user main screen, check if the Meta App you created is listed under Assigned Assets. If not please select Add Assets and add the app for system users. Click Generate Token and select your Meta App. After selecting the app, you see a list of available permissions. Select whatsapp_business_management, whatsapp_business_messaging, and business_management. Click Generate Token. Paste the generated token on the User Access Token field on Proto's platform.
Once you have a phone number that is ready to be used, connect your phone number to your WhatsApp account.
Go to Business Manager and select your business.
Click the 三 3 lines in the top left corner.
Go to the Engage customers section.
Click WhatsApp Manager.
Select the WhatsApp Business account that you want to set up a phone number for.
Navigate to the left-most menu and click Phone Numbers.
Click Add Phone Number.
In the Business profile section, enter your WhatsApp Business display name and the category of your business. Your customers will see the display name when they receive messages from you. Then, click Next.
Enter the phone number for your business and choose how you'd like to verify your number. Then, click Next.
Enter the verification code.
Add the new phone number to your phone number list. The certificate for this phone number will be provided based on your current account status:
If your business isn’t verified, your display name is ready and the certificate is available for download immediately.
If your business is verified, your phone number will be pending review. Once it’s approved, you’ll see a View button. You can click it to see the available certificate for the phone number.
Please refer to the documentation here if you would like to apply for an Official Business Account (with a green checkmark beside the displayed) for your phone number.
Copy the Phone Number ID from your App Manager > WhatsApp > Getting Started and paste it on the Phone Number ID in Proto's platform.
Display name review will no longer be needed to get started on the WhatsApp Business Platform. However, if you look to increase messaging limits, you have to complete your business verification. Display name review will be initiated after the business verification is completed. Businesses should still follow the display name best practices when adding a new phone number.
If you want to use a number that is already being used in the WhatsApp customer or business app, you will have to fully migrate that number to the business platform. Once the number is migrated, you will lose access to the WhatsApp customer or business app. See Migrate App Phone Number to Business Platform for more information.
Meta has a set of rules regarding numbers that can be used in the platform. Learn more.
Configure a Webhook.
Go to your App Dashboard.
In your App Dashboard, find the WhatsApp product and click Configuration. Then, find the webhooks section and click Edit. After the click, a dialogue appears on your screen and asks you for two items:
Callback URL: Please copy the Webhook URL from Proto's platform WhatsApp channel > Webhook tab and paste it into this field.
Verify Token: Please copy the Channel Secret from Proto's platform WhatsApp channel > Settings tab and paste it into this field.
After adding the information, click Verify and Save.
Back in the App Dashboard, click WhatsApp > Configuration in the left-side panel. Under Webhooks, click Manage. A dialogue box will open with all the objects you can get notified about. To receive messages from your users, click Subscribe for messages.
In your App Dashboard, find the Webhook product, Subscribe to the messages webhook.
After following all the steps below, click on the toggle button to enable the channel.
Opt-In
Businesses are required to obtain opt-in before sending proactive business-initiated messages to customers outside the 24-hour window. Businesses can obtain opt-in in a multitude of ways, both on and off WhatsApp. Opt-in methods such as via your website, interactive voice response (IVR) flows or in a WhatsApp thread are acceptable. See Get Opt-In for WhatsApp for more information.
Businesses are charged per conversation by Meta (Proto is not responsible for the charges of the messages sent), which includes all messages delivered in a 24-hour session. The first 1,000 conversations each month are free. If you want to send more than 1,000 conversations, you need to add a credit card to your Meta Business account.
To set up a payment method, go to App Dashboard > WhatsApp > Configuration. Under Phone Numbers, click Manage Phone Numbers. This leads you to your Business Manager account, where you can click Add Payment Method to add your credit card.
For more information, see Add a Credit Card to Your WhatsApp Business Platform Account
Business Initiated Messages
To send more business-initiated messages, you need to use message templates. WhatsApp message templates are specific message formats that businesses use to send out notifications or customer care messages to people who have opted into notifications.
Before sending a message template, you need to create one or you can use one of Meta's pre-approved templates. Check this guide to learn how to send message templates.
Incoming messages are unlimited, but there are limits for outgoing messages. See Messaging Limits for more information on messaging tiers.
