# How to connect Tiledesk with WhatsApp Business

Tiledesk WhatsApp Integration allows your customers to reach you through their favourite messaging application: WhatsApp. On the other end, your agents will be able to promptly respond directly from our Web Chat. Quick replies, action buttons and media like images, videos and documents are supported on both sides.

If you haven't yet configured a WhatsApp Business account, our guide [Configure a WhatsApp Business account](/apps-and-integrations/whatsapp-business/how-to-configure-a-whatsapp-business-account.md) awaits you!

### Install the WhatsApp Business app on Tiledesk <a href="#install-the-whatsapp-business-app-on-tiledesk" id="install-the-whatsapp-business-app-on-tiledesk"></a>

Login into the [Tiledesk Console](https://panel.tiledesk.com/v3/dashboard/#/projects) and create a project if you haven't already. Just click on “Add project”, choose a name for your project and then click on "Add project" button (leave all the options on default values).

<figure><img src="/files/zu7OQoAByNf069x29UZ8" alt=""><figcaption></figcaption></figure>

Once your project is ready, use the left-bar menu to go to **Settings → Integrations**, and search for the **WhatsApp Business** app.

<figure><img src="/files/ruzoz05BWZnt6xkHejiP" alt=""><figcaption></figcaption></figure>

As shown in the image, you have two options to authorize WhatsApp: **Configure using OAuth** or **Manual Configuration**.

#### **Configure using OAuth** (recommended)

“Configure using OAuth” means you can connect Tiledesk to WhatsApp Business through Meta’s standard OAuth authorization flow, instead of pasting app IDs, secrets, and tokens by hand.\
The process is designed to be intuitive and simple. After clicking on "Configure using OAuth," a pop-up will appear asking you to confirm your account and then provide **your** **business name**, **business email**, **website**, and other details, as shown in the image.

<figure><img src="/files/P6MlS1HsfpHlnQxJxeAt" alt=""><figcaption></figcaption></figure>

The process is quite straightforward. After that, you'll be asked to either connect your existing WhatsApp Business app or start with a new WhatsApp phone number.&#x20;

Follow the steps one by one, and once your phone number is verified, click the **Finish** button.

That’s it! After a few seconds, you should see the confirmation page. In the top right corner, you’ll see the status: **Connected**.

<figure><img src="/files/orTu1VznuEoeJR5N6Ckm" alt=""><figcaption></figcaption></figure>

**Here is also a video tutorial on how to connect Tiledesk to WhatsApp Business using OAuth configuration:**

{% embed url="<https://youtu.be/vGeZYu0fL4w>" %}

#### **Manual Configuration**

Let’s also take a look at **Manual Configuration**. After selecting this option, you will see the fields below, which you’ll need to fill out and configure:

1. WhatsApp token which is your permanent token;
2. Verify Token which is a simple password of your choosing
3. WhatsApp Business Account ID which you can find in the API configuration section of your app on the [Meta for developers console](https://developers.facebook.com/apps/)
4. Tiledesk Webhook Endpoint, which is to be pasted in the API configuration section of your app on the [Meta for developers console](https://developers.facebook.com/apps/)

More details about each field below.

<figure><img src="/files/2BMMO5KM3XOxgOVHkolf" alt=""><figcaption></figcaption></figure>

1\. If you have doubts about the permanent token, please look up our guide [Configure a WhatsApp Business account](/apps-and-integrations/whatsapp-business/how-to-configure-a-whatsapp-business-account.md).

> Note: you can use a **Temporary access token** instead of a permanent one. You can find it on [Meta for Developers Console](https://developers.facebook.com/apps/) → WhatsApp → Getting Started. You can use it for testing purposes, however, since it expires after 24 hours, its use is **highly discouraged**.

2\. Choose a verify token (i.e. "my-verify-token") and type it in the “Verify Token” field, then click on the “Connect” button. Your app is now connected. Click on “Copy” button to copy the webhook endpoint to clipboard, then move to [Facebook Developer Console](https://developers.facebook.com/apps/) and open the app where you have installed the WhatsApp plugin.

<figure><img src="/files/ZhIzxwtDDmh7X1ZCHqCu" alt=""><figcaption></figcaption></figure>

On the left-side menu, underneath products section, go to WhatsApp → Configuration. Then click on “Edit” and paste the URL you copied earlier in “Callback URL". Type in your verify token as well, then click on “Verify and save” button.

<figure><img src="/files/2j36FbzQbtPv9Pzc6kos" alt=""><figcaption></figcaption></figure>

If the verification fails, please check your configuration parameters.

Now click on “Manage” …

<figure><img src="/files/swpwAi6oodb4VjYPz1Tk" alt=""><figcaption></figcaption></figure>

… click on “Subscribe” for messages option, then click on “Done” button.

<figure><img src="/files/8fJUZfIfT0tGTS6sC2cN" alt=""><figcaption></figcaption></figure>

Well done! The configuration is now completed and you should be able to receive message from WhatsApp to your Tiledesk chat. If a chatbot has been configured, it will the first one to greet your customers!

<figure><img src="/files/4mRRkIoQgkNaAQ60oGyZ" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/qim94jFZ8RxJ4gf3yYa4" alt=""><figcaption></figcaption></figure>

If you have any questions, feel free to contact us live on chat or at <support@tiledesk.com>

For more info on who we are, what we do, or what is our shtick, visit the [Tiledesk Website](https://tiledesk.com/) 👩‍🚀.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://guide.tiledesk.com/apps-and-integrations/whatsapp-business/how-to-connect-tiledesk-with-whatsapp-business.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.