> For the complete documentation index, see [llms.txt](https://help.whautomate.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.whautomate.com/product-guides/integrations/whatsapp-cloud-api.md).

# WhatsApp Cloud API

## Here are two methods to integrate WhatsApp Business API with Whautomate.

### 1. WhatsApp Embedded Signup

{% hint style="info" %}
Set up your WhatsApp Business API quickly and easily with Whautomate's Embedded Signup. In just **10 minutes**, you'll configure your account and start automating customer conversations.
{% endhint %}

**In order to set up WhatsApp Embedded Signup with Whautomate, follow these steps. 👇**

**Step 1:** Go to the **Whautomate app,** select the **Integration** menu option, and Select the **WhatsApp** **Connect** button to continue.

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

**Step 2:** Scroll down find the **Configure WhatsApp via Embedded Signup** section and select the **Configure** button to continue. 👇

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

{% hint style="danger" %}
**Important Note:**\
When proceeding with your WhatsApp Embedded Signup, be sure to select **"Create a WhatsApp Business Account"** rather than using an existing WABA that is already linked to other platforms. Creating a new account is essential to avoid potential payment-related issues. 👇
{% endhint %}

<figure><img src="/files/0e7J8wJXd5nQfYH763mx" alt=""><figcaption></figcaption></figure>

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

***

### 2. WhatsApp Cloud API

{% hint style="info" %}
Configure your WhatsApp Business API using your own WhatsApp Cloud API keys with this detailed guide. In approximately **30 minutes**, you'll complete the setup and start automating your customer interactions.
{% endhint %}

**In order to set up WhatsApp Cloud API with Whautomate, follow these steps. 👇**

**Step 1:** Go to the **Whautomate app,** select the **Integration** menu option, and Select the **WhatsApp** **Connect** button to continue.

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

**Step 2:** Scroll down find the **Bring your own WhatsApp Cloud API keys** section and select the **Configure** button to continue.

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

**Step 3:** You need to first configure **Webhook settings.**

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

**Step 4:** Go to <https://developers.facebook.com/>

**Step 5:** If you already have a **Facebook Developer** account, login

(OR)

Sign up for a **Facebook Develope**r account.

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

**Step 6:** Select the **Get Started** option to continue and Create a Facebook for Developers account.

(i) Register

(ii) Verify account

(iii) Contact info

(iv) About you

![](/files/lt93LiwMjUjEzX5HSeev)

**Step 7:** Apps

(i) Select the **Create App** button to continue

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

(ii) Create an App **(Select an app type)**

* Select the **Business** option

Create or manage business assets such as Pages, Events, Groups, Ads, Messenger, WhatsApp, and Instagram Graph API using the available business permissions, features, and products.

Select the **Next** button to continue.

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

(iii) **Provide basic information**

* Enter a **Display name**.
* Enter the **App contact email.**
* Select **Business Account** (Optional).
* Select the **Create app** button.

![](/files/LqDyVez0d7Xq4ZiATq1P)

**Step 8: Add products to your app**

(i) Find and Select the **WhatsApp Setup** button to continue.

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

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

**Step 9:** Please proceed to the next step before you are required to complete your **Meta Business Verification** process. (To access [certain Meta products](https://www.facebook.com/business/help/1095661473946872), your organization must be verified.)

* Go to <https://business.facebook.com/settings/>
* Click on the **Security Centre** menu option and then select "**Start Verification**" to update your business information and submit the required documents for verification. Verification usually takes 1 to 2 days.
* Once your business is verified, you can proceed to the next step.

Please follow this link to learn how to verify a Meta Business: 👇<https://www.facebook.com/business/help/2058515294227817?id=180505742745347>

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

**Step 10:** Once you have finished the Meta Business Verification process, kindly return to the following URL: <https://developers.facebook.com/> to continue.

Select the **API Setup** option and then select the **Configure Webhooks** link to continue.

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

(i): Select the **Edit** button

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

(ii) Copy the **Webhook callback URL** from the Whautomate app and paste it.

(iii) Copy the **Verify Token** from the Whautomate app and paste it.

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

(iv) Select the **Verify and Save** button

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

(v) Select the Manage button to Subscribe to **Webhook Fields**

(vi) Please ensure that you subscribe to the following three Webhook Fields mentioned below:

* **message\_template\_status\_update**
* **messages**
* **template\_category\_update**

Then select the **Done** button to complete **Webhooks Configuration.**

<figure><img src="/files/nHkwueOHjpf2MNQT31TD" alt=""><figcaption><p><strong>message_template_status_update,</strong> <strong>messages</strong> and <strong>template_category_update</strong></p></figcaption></figure>

**Step 11: Add a phone number**

(i) Select the **Add phone number** button to add your business information and WhatsApp number.

If you want to add a new phone number, simply proceed with the **Add phone number** option.&#x20;

(Or)&#x20;

To migrate your existing WhatsApp account, you must first delete it and then proceed. 👇

Learn more: <https://developers.facebook.com/docs/whatsapp/cloud-api/get-started/migrate-existing-whatsapp-number-to-a-business-account/>

<figure><img src="/files/JtY1Yl98ZzhzhpxB3O39" alt=""><figcaption><p>To start sending messages to any WhatsApp number, add a phone number. To manage your account information and phone number</p></figcaption></figure>

(ii) Please provide the following 4 steps of information in order to add a WhatsApp number.

<figure><img src="/files/dmh9NUpWrew4RhQcfXjf" alt=""><figcaption><p>Business information | WA Business Profile | Add number | Verify number</p></figcaption></figure>

**Step 12:** Next you need to configure **WhatsApp Settings**

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

(i) Go to <https://business.facebook.com/settings/>

(ii) Select the **System users** option and Select the **Add** button.

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

(iii) Enter a system username e.g. **API User,** Select the user role **Admin** option and Select the Create System User button to add.

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

(iv) Select the **WhatsApp accounts** menu option, then select your **WhatsApp Business Account** and Select the **Add People** button to give access to the System user previously you created.

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

(v) Select the **system user** you previously created, enable **Full Control**, and click **Assign** to grant access.

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

(vi) Again select the **System users** menu option and Select the **Add Assets** button.

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

(vii) Select the asset type as **Apps**, then select the previously created app name. Next, choose the **Full Control** option and click on **Save Changes.**

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

(viii) Select the **Generate New Token** button. (WhatsApp Permanent API Token)

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

(ix) **Generate Token**

* Select the App.
* Select the Token Expiration - **Never.**
* Scroll down and Select the Permissions - **whatsapp\_business\_messaging** | **whatsapp\_business\_management.**
* Select the **Generate Token** button.

<figure><img src="/files/5hUxtM4oA2paTIkvMMVx" alt=""><figcaption><p>Select: whatsapp_business_messaging | whatsapp_business_management</p></figcaption></figure>

(x) Copy the **WhatsApp Permanent API Token** and Paste it on the Whautomate app.

<figure><img src="/files/nQvDgMphQ3e62ItWOfcJ" alt=""><figcaption><p>Note: Copy and save this toke as it wom't be stored at Facebook</p></figcaption></figure>

(xi) Then go to <https://developers.facebook.com/apps/>

(xii) Select your previously created app&#x20;

* Copy the **Phone number ID** and Paste it on the Whautomate app.
* Copy the **WhatsApp Business Account ID** and Paste it on the Whautomate app.

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

(xiii) Go to WhatsApp Settings in your Whautoamte app and paste your **API Token, WhatsApp Phone Number ID, and WhatsApp Business Account ID**. Finally, select the **Save** button to complete the setup for WhatsApp Cloud API.

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

Step 13: Now, send a test message to the registered WhatsApp Cloud API mobile number to check if it's working.

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

#### Here is a video of the integration directly with WhatsApp Cloud API

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