How to Onboard WhatsApp Business Account
Introduction

Comm100 allows you to respond to messages sent by your customers through integration with the WhatsApp Business account. You must first set up your business assets on the WhatsApp Business Platform before you can configure and start using WhatsApp Cloud API from Comm100. 

Note: You must ensure to verify WhatsApp Business Manager account beforehand while creating app on Meta. To learn how to verify your business account, see this article.  
The setup consists of the following steps:
  1. Create App on Meta for Developers
  2. Associate a Business Manager Account 
  3. Generate a Permanent Token
  4. Set Up a Webhook
Step 1: Create App on Meta for Developers

To create an app, follow these steps: 

  1. Register as a Meta Developer.
  2. (Optional): Enable two-factor authentication for your account.
  3. Go to developers.facebook.com > Apps > Create App.
    kb-whatsapp-01.png
  4. On the Select an app type page, choose an app type as Business. Your app type determines which products and APIs are available to your app.
  5. Click Next.
    kb-whatsapp-02.png
  6. In the Display Name field, enter the name of your app.
  7. In the App Contact Email field, enter an email address where Meta can send you any important developer notifications.
  8. Select or create a WhatsApp Business Manager account from the drop-down list.
  9. Click Create App.
    kb-whatsapp-03.pngOnce completed, your app is loaded in the App Dashboard.
Step 2: Associate a Business Manager Account
Note:  If you have selected a WhatsApp Business Manager account while creating the app, skip this step. Refer to Step 1: Create App on Meta for Developers for details.

In this step, you associate a Business Manager account with WhatsApp. To associate a Business Manager account with WhatsApp, follow these steps: 

  1. On the developers.facebook.com, go to the App Dashboard page and select your app from the drop-down list.
  2. Click Add Products.
  3. Scroll down to find the WhatsApp product and click Set up.
    kb-whatsapp-04.png
  4. On WhatsApp’s Getting Started page, scroll down to step #5 to add your phone number.
  5. Click Add phone number.
    kb-whatsapp-05.png
    The Create a WhatsApp Business profile pop-up appears.
  6. Provide your WhatsApp Business profile display name, Time zone, and Category.
    Note: Your profile information will be visible to people on WhatsApp.
  7. Click Next.
    kb-whatsapp-06.png
  8. Add a valid phone number for your WhatsApp.
  9. Select a verification option – Text message or Phone call, and click Next.
    kb-whatsapp-07.png
    A One Time Password verification process takes place. 
  10. On successful verification, the phone number appears in the From drop-down list of Step #1: Select phone number.
    kb-whatsapp-08.png
  11. Locate the Phone number ID for your WhatsApp phone number. Copy and save the Phone number ID locally and proceed to Step 3: Generate a Permanent Token.
Step 3: Generate a Permanent Token

To generate a permanent token, follow these steps:

  1. Go to business.facebook.com and click the hamburger menu > All tools > Business settings.
    kb-whatsapp-09.png
  2. On the Business settings page, navigate to Users > System users and click Add to create a system user.
    Note: Creating a system user is an optional step. If you already have one, you do not have to create it. Else, you must create it.
    kb-whatsapp-10.png
  3. Create a System Username and select System User Role as Admin.
  4. Click Create System User.
    kb-whatsapp-10a.png
    The system admin user appears on the list.
  5. Select the system admin user and click Add Assets.
    Add Assets.png
  6. Check the App you created on the Step 1 and click Save Changes.
    Select App.png
  7. For the same system admin user, click Generate New Token.
    kb-whatsapp-11.png
  8. Select an app from the drop-down list you created in Step 1: Create App on Meta for Developers.
    kb-whatsapp-12.png
  9. From the Available permissions section, select business_management, whatsapp_business_messaging and whatsapp_business_management.
    kb-whatsapp-13.png
  10. Click Generate Token.
  11. An Access Token (Token) is generated. Copy and save the access token locally and click OK.
    kb-whatsapp-14.png
  12. Next, go to Comm100 Control Panel: Ticketing & Messaging > Channels > WhatsApp, and do the following:
    • Provide the Phone ID and Token you saved locally in the WhatsApp channel account.
    • Copy the Callback URL and Verify token from the Comm100’s WhatsApp channel account and proceed to Step 4: Set Up a Webhook.
      kb-whatsapp-15.png
Step 4: Set Up a Webhook

Webhooks are user-defined HTTP callbacks that are triggered by specific events. You get a notification (HTTP request) sent to a setup URL whenever a trigger event occurs. 

To set up your Webhook, follow these steps:

  1. Go to developer.facebook.com and select the app from the drop-down list you created in Step1: Create App on Meta for Developers.
  2. Navigate to Products > WhatsApp > Configuration.
  3. Click Edit.
  4. On the Edit webhook’s callback URL pop-up, provide the Callback URL and Verify token you saved locally from the Comm100 Control Panel: WhatsApp channel account.
  5. Click Verify and save.
    kb-whatsapp-16.png
    On successfully configuring the Webhook settings, the Manage button is enabled.
  6. Click Manage and subscribe to the Webhook fields. You need to subscribe messages and message_template_status_update fields.
    kb-whatsapp-17.png
  7. Next, go to the Comm100 Control Panel and click Save & Test to test your WhatsApp channel connection with Comm100 Ticketing & Messaging. 

To learn more on WhatsApp channel configuration on Comm100 Control Panel, see this article.