yada.ai documentation
  • 🥳Welcome
  • 🛠️Quick Start
    • What Is Yada?
    • Creating an account
    • Connect to PMS, OTA, and other channels
    • Chat Widget
    • Train and Manage Bots & AI
  • PMS Integrations
    • Hostaway
    • Guesty
    • Hostfully
    • Tokeet
    • Mews
  • Flows
  • Chat Widget
    • Configuring the chat widget
    • Adding AI to the chat widget
    • Installing Chat Widget on Guesty
    • Installing Chat Widget on Hostaway
    • Installing Chat Widget on Wordpress
    • Basic KB Template
    • Advanced KB Template
  • AI
    • Listing Bot
      • Basic Knowledge Base Template
      • Advanced Knowledge Base Template
        • Activate Responding Status
      • Hotel Knowledge Base Template
      • Train Bot with Previous Conversations
    • Training and Re Training the AI
    • How to structure a knowledge base
    • Boosting a Listing
    • Settings & Configuration
      • AI Accuracy
      • AI Relevance
    • RankAI
    • Buy Time
    • Installing the chat widget on your direct booking site
      • Inquiry Abandonment Flow
    • AI Versions
  • Messaging Channels
    • WhatsApp (Twilio)
    • WhatsApp
    • Instagram DM
    • Facebook
  • Platform Overview
    • Dashboard
    • Inbox
    • Listings
    • CRM
    • Settings
  • Powerups
    • Slack
      • Connecting a Listing with a specific slack channel
  • RankAI
  • Extension
    • Installation & Authentication
    • AirBnB
    • Guesty
    • Hostaway
    • Hostfully
  • Buy Time
  • Workflows
    • Inquiry Winback
  • Bug Fix Tutorials
    • Stuck on Old Version
Powered by GitBook
On this page
  • Step 1 - Verify your Business with Facebook
  • Step 2 - Create a WhatsApp Business App
  • Step 3 - Configure the Developer App
  • Step 4 - Generating WhatsApp Access Token
  • Video Tutorial
  • Step 5 - Connect WhatsApp to Yada
  • Step 6 - Connect the WhatsApp Webhook to Yada
  1. Messaging Channels

WhatsApp

PreviousWhatsApp (Twilio)NextInstagram DM

Last updated 1 year ago

Here's a step-by-step guide on how to integrate Yada with WhatsApp in five simple steps. We've tied as much as possible to take this otherwise confusing process and create a sequence of steps which can be easily followed to integrate Yada with WhatsApp

The Yada <> WhatsApp integration only works with WhatsApp for Business

This guide assumes you haven't done anything yet to set up a whatsapp for business account. If you've already done some of this, please feel free to skip to the most relevant section.

Step 1 - Verify your Business with Facebook

In order to connect your WhatsApp to yada, your business needs to be verified on Facebook. Detailed instructions on how to do that are available on . You will be required to provide additional information about your business and wait for the verification to be completed.

Step 2 - Create a WhatsApp Business App

While your business is being verified you can go ahead and start setting up the rest of the information needed to connect yada with WhatsApp.

Head over to , click on Create App and follow the steps to create a developer app.

Once you've created the developer app, you will need to add some details.

Step 3 - Configure the Developer App

You will need to add the WhatsApp and Webhooks products

Once these two products have beed added, they'll show up in the left bar

Make sure to copy the AccountID somewhere - you will need it to integrate with yada

As a next step, go to your app’s basic settings and set your Privacy policy URL, Contact email and Category. Once you’ve done that, set your app to live at the top.

This App Secret is really important and you'll need it to connect WhatsApp to the Yada API

Step 4 - Generating WhatsApp Access Token

First, you need to create a user with admin permissions. Keep in mind that there can be only one admin account.

Once the admin user is created, select Add assets under the Assigned Assets section.

Select Apps, choose your app with WhatsApp integration and give it full control to Manage App.

Next, you will need to generate a new token. Press the Generate new token button and select your app. In the Available Permissions section select two permissions: whatsapp_business_messaging and whatsapp_business_management.

Finally, copy the generated access token.

MAKE SURE TO COPY THE TOKEN. It is not stored by facebook so if you don't copy it you'll have to generate the token again.

Video Tutorial

Step 5 - Connect WhatsApp to Yada

In the previous steps you've gotten these three fields

  • Account ID

  • App Secret

  • Permanent Access Token

Once you've gotten these three fields, you are ready to connect WhatsApp to Yada

You need to have a paid Yada account to connect to WhatsApp

First, Head to the Powerups page and click on the WhatsApp card. Once you're in here you'll need to copy the above fields into their corresponding inputs

Once yada has been integrated with WhatsApp, you'll get the Webhook Callback URL and the verification secret. Copy these as you'll need them to connect the WhatsApp webhook to Yada and start receiving messages

Step 6 - Connect the WhatsApp Webhook to Yada

Paste in the callback URL and verify token into the following fields

Once the Callback URL has been correctly added, click on the Manage webhook fields button.

Subscribe to the messages fields and select Done to continue.

Make sure to select version v15.0 or v16.0 --- NOT v9.0

Once correctly configured and saved, your Webhooks sections is going to look something like this:

Select your business phone number in WhatsApp Quickstart settings. That’s the number through which your guests will be contacting your busienss on WhatsApp. If you don’t know how to add a phone number to WhatsApp, you can follow this .

While on this page, also take note of your App secret and App ID which you will also need to paste into the

To generate an access token required to integrate with WhatsApp you will need to go to . Make sure you are looking at the correct business account.

The final step will be to integrate and verify the Quickchat webhook endpoint which will receive your message events. Go back to , select your app and open your app’s WhatsApp Quickstart settings. Click on the Edit button for webhooks.

official tutorial
Yada Dashboard
business.facebook.com/settings/system-users
developers.facebook.com/apps
Facebook’s Business Help Center page
developers.facebook.com/apps
You can select either "None" or "Business"
Provide app name, contact email address and select your Business Account
Make sure to add WhatsApp and Webhooks
Notice that Webhooks and Whatsapp have now been made available
Copy and store the WhatsApp Accunt ID somewhere
You're ready to go live now!!
Copying the App Secret
Crating a facebook system user
You will need to add WhatsApp ass an asset to this system user
Select the app and make sure "Manage App" is active
Make sure all the whatspp fields are clicked
Edit the callback URL
Select v14, v15, or v16