WhatsApp Cloud

Published August 18, 2023

Create a Facebook page before connecting WhatsApp. Then you need to connect this page to your business account via Instagram.

For WhatsApp, you need to use a separate business account without linking to other apps. The bot will not respond if the page linked to the WhatsApp app is also used for bots on Instagram and Facebook.

1. Follow the link: https://developers.facebook.com/, then go to My Apps. This section is displayed if you have a developer account in Meta. If you haven’t created it yet, go to Get Started.

Meta homepage with the "My Apps" link highlighted in the top navigation

2. If you don't have a developer account, Meta will offer you to create one. If the developer account was created earlier, these steps will be skipped. To register a developer account, enter your confirmation email address.

3. After confirming your account, select Developer and complete registration.

4. Click Create App.

Empty Apps page with the "Create App" button highlighted

5. Select Other and click Next.

Create an app page with "Other" selected and the "Next" button highlighted

6. Select the app type: Business and click Next.

Create an App page with the "Business" app type selected

7. Add the application name — it can be the name of your company or any other name, leave an email address to contact. Then click on the Create app button.

App details form with an app name entered and the "Create app" button highlighted

8. Click Set up to the WhatsApp app icon.

App dashboard with the WhatsApp "Set up" button highlighted among product cards

9. If you create a business account in WhatsApp for the first time, Meta will offer you to create it automatically. If you already have business accounts, Meta will offer you to select an existing business account or create a new one. Select the appropriate option and click Continue. Or just click Continue if you don't have a choice, as in our example.

WhatsApp Business Platform API dialog with the "Continue" button highlighted

10. Go to the API Setup tab on the left panel.

WhatsApp Quickstart page with the "API Setup" menu item highlighted

11. Copy Temporary Access Token from Meta and paste it into the API Token field in Botmother WhatsApp Cloud settings.

  • Copy the Phone number ID from Meta to the Phone id field in Botmother WhatsApp Cloud settings.
  • Copy the phone number from the Meta Test number field in the Phone number issued by Facebook field in Botmother WhatsApp Cloud settings and remove extra spaces.
  • Save your changes in Botmother.
  • Go back to Meta and select the recipient number in the To field. This can be your own phone number or any other number. In the next step, a test message will be sent to this number in WhatsApp.
  • Click Send Message to Meta.

Meta API Setup page with "Send message" highlighted beside Botmother WhatsApp Cloud settings

After sending a message from Meta, a test message with the text should come to the number that you specified in the To field in WhatsApp: Hello World.

Welcome and congratulations! This message demonstrates your ability to send a WhatsApp message notification from the Cloud API, hosted by Meta. Thank you for taking the time to test with us.

12. Go to Configuration.

WhatsApp API Setup page with the "Configuration" menu item highlighted

13. Click Edit.

WhatsApp Configuration page with the "Edit" button highlighted in the Webhook section

14. In the Callback URL (Meta) field, insert Webhook from the Botmother settings, and in Verify token (Meta), insert Marker from the Botmother settings. Then click Verify and save.

Edit webhook dialog with "Verify and save" highlighted, beside Botmother Webhook and Marker fields

15. Next to Webhook Fields, click Manage.

WhatsApp Configuration page with the "Manage" button highlighted next to Webhook fields

16. Check all the items and click Done.

Webhook fields dialog with all Subscribe boxes checked and the "Done" button highlighted

If all the boxes are checked, after clicking Done, the page will look like this.

WhatsApp Configuration page listing the selected webhook fields under the Webhook section

Open WhatsApp Messenger and write /start in the same dialogue with the bot that previously received the Hello World test message. If all the steps are completed correctly, Start Screen should come in response.

We have just created and tested a temporary token, in other words, a temporary token for WhatsApp that will work for the next 24 hours.

Let's start creating a permanent token.

1. Click on developers.facebook.com and go to My apps.

Meta homepage with the "My Apps" link highlighted in the top navigation bar

2. Go to your company settings.

Apps list showing the WA app with the "Test Business" link highlighted

3. Go to the System users tab and add the user.

Business settings "System users" page with the "Add" button highlighted

4. Then click Add assets.

System user page with the "Add assets" button highlighted

5. In the window that opens, select Apps and check the checkbox next to your app name. Then activate the Manage app switch and save the changes.

Assign Assets dialog with "Apps" selected, WA app checked and "Manage app" on

6. Click Done to continue.

Assets Added dialog confirming one app was added, with "Done" highlighted

7. Click Generate new token.

System user page with the "Generate new token" button highlighted

8. Select your app from the drop-down list.

Generate token dialog with the "Select an app" dropdown open, showing WA

9. Select Never so the token does not need to be updated.

Generate token dialog with "Never" selected under Token expiration

10. Scroll down the page and select the following items:

  • business_management
  • whatsapp_business_management
  • whatsapp_business_messaging

11. Scroll to the bottom of the page and click Generate Token.

Permissions list with business_management, whatsapp_business_messaging and whatsapp_business_management checked, "Generate token" highlighted

12. Copy the Generate token from the Meta settings to the Botmother Settings API Token field. It is also recommended to save the token in a safe place, since it is not saved in Meta, and in Botmother settings it is displayed as dots.

Generate token dialog with an arrow to the Botmother WhatsApp Cloud API Token field

To the beginning ↑