# 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="https://810714386-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FF8vuadG7OJ1fFdSBZATv%2Fuploads%2FIY9j2HXLWtSAe3LtFGcw%2Fimage.png?alt=media&#x26;token=7249fc29-d631-458a-a672-adca1eca6752" 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="https://810714386-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FF8vuadG7OJ1fFdSBZATv%2Fuploads%2FsMcL3T7up11XttPyTkgk%2Fimage.png?alt=media&#x26;token=dd6d72a2-cebf-40d3-9584-1657ffac586b" 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="https://810714386-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FF8vuadG7OJ1fFdSBZATv%2Fuploads%2F1Gh4qMdbMekIGtMZD77j%2Fimage.png?alt=media&#x26;token=7d7c4ffa-c103-4099-b46c-e7eef4ee51c6" 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="https://810714386-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FF8vuadG7OJ1fFdSBZATv%2Fuploads%2FakltgXKxb3jk84DcR5rO%2Fimage.png?alt=media&#x26;token=ad5b4bbd-e9dc-4f0d-aef0-e3851cda3f62" 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="https://810714386-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FF8vuadG7OJ1fFdSBZATv%2Fuploads%2FIPVCy7SSLltlMkeQtGFA%2Fimage.png?alt=media&#x26;token=285989af-4095-4144-a2e6-1b79de85d4e5" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://810714386-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FF8vuadG7OJ1fFdSBZATv%2Fuploads%2FpDpGwuZAljY0Mqc45yhW%2Fimage.png?alt=media&#x26;token=d66d2291-fac0-4b27-a1be-49af25e6d975" 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="https://810714386-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FF8vuadG7OJ1fFdSBZATv%2Fuploads%2FGh4NKX5L7PRW25lz1sPB%2Fimage.png?alt=media&#x26;token=a2e0beb5-55df-4b59-9a57-2ec3ab9c270c" 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

![](https://810714386-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FF8vuadG7OJ1fFdSBZATv%2Fuploads%2FbdxbQEBP6G5gLrA0sYuy%2FCreate%20a%20account.png?alt=media\&token=a066cd82-bd08-411e-8526-a75ed01fe443)

**Step 7:** Apps

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

<figure><img src="https://810714386-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FF8vuadG7OJ1fFdSBZATv%2Fuploads%2Fr1Pfa67KMn4M0jJwX0H0%2FApps.png?alt=media&#x26;token=109e1152-6bcf-47cc-890a-5b1ec264613a" 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="https://810714386-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FF8vuadG7OJ1fFdSBZATv%2Fuploads%2F3wJ9mqM8cjRpzuvJSQHI%2FSelect%20an%20app%20type.png?alt=media&#x26;token=a3e19baf-4e5b-4a8a-b387-3a25839edcce" 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.

![](https://810714386-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FF8vuadG7OJ1fFdSBZATv%2Fuploads%2FFiDRMgVJoE4YJvZA87ie%2FCreate%20an%20app.png?alt=media\&token=3478348a-cf60-486f-b257-b71484d4aabd)

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

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

<figure><img src="https://810714386-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FF8vuadG7OJ1fFdSBZATv%2Fuploads%2F9umGeIZIxfbzhd0PXLap%2FAdd%20products%20to%20your%20app.png?alt=media&#x26;token=e6b69542-0bdd-4cfc-a823-f828d15afed7" alt=""><figcaption></figcaption></figure>

<figure><img src="https://810714386-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FF8vuadG7OJ1fFdSBZATv%2Fuploads%2FUV8VJAW1RYaL70zKxzek%2FSelect%20Whatsapp.png?alt=media&#x26;token=30d0e66c-e31c-4e4c-be79-661c05b06680" 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="https://810714386-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FF8vuadG7OJ1fFdSBZATv%2Fuploads%2F9MkTCOvFjHOqDfOEh8by%2Fimage.png?alt=media&#x26;token=b53bde72-2930-4f20-8abf-9787b7d35b20" 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="https://810714386-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FF8vuadG7OJ1fFdSBZATv%2Fuploads%2Fu5eFsyAEbyMDjLjvEn5D%2Fimage.png?alt=media&#x26;token=c5d88fc3-5c6d-434b-940b-8042c4fe1311" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://810714386-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FF8vuadG7OJ1fFdSBZATv%2Fuploads%2FSwJeQd3dEsDIIhG6YXlJ%2Fimage.png?alt=media&#x26;token=74cc3177-7a88-4cde-bf04-ff18ba72d6f0" 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="https://810714386-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FF8vuadG7OJ1fFdSBZATv%2Fuploads%2FwjJpRXxs5mGB7sRZ8opz%2Fimage.png?alt=media&#x26;token=51c1a16b-2385-4707-b6ee-fca39f80dda4" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://810714386-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FF8vuadG7OJ1fFdSBZATv%2Fuploads%2FWqpjrGmyXP0EVDlNSKdL%2Fimage.png?alt=media&#x26;token=c6171150-ce0b-4160-8dfe-7bd9853be727" 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="https://810714386-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FF8vuadG7OJ1fFdSBZATv%2Fuploads%2FYIoTW170FbavjNgI0WCT%2Fimage.png?alt=media&#x26;token=86e5ed95-1175-419d-86d7-f3df8ed44095" 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="https://810714386-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FF8vuadG7OJ1fFdSBZATv%2Fuploads%2Ftrip22abo9dllboQ1TaG%2Fimage.png?alt=media&#x26;token=502c5ee5-66a3-4f88-a070-3bb58fa577e7" 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="https://810714386-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FF8vuadG7OJ1fFdSBZATv%2Fuploads%2F7jCcqRbFT8G7RWuBpkpN%2Fimage.png?alt=media&#x26;token=fade9386-2c23-4165-825d-8270446a2a72" 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="https://810714386-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FF8vuadG7OJ1fFdSBZATv%2Fuploads%2Fk5HtIO70l1coXC1bA9Cl%2Fimage.png?alt=media&#x26;token=60e76d2d-0535-4fab-bbf6-7e54e1df7829" 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="https://810714386-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FF8vuadG7OJ1fFdSBZATv%2Fuploads%2FVhzczkVS1NMfeixvykpa%2Fimage.png?alt=media&#x26;token=8bef1b3f-c51a-4924-b182-f76ff0449140" 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="https://810714386-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FF8vuadG7OJ1fFdSBZATv%2Fuploads%2F7zwqAwBh2DSsE4lFPGI4%2Fimage.png?alt=media&#x26;token=cbce1485-b4ac-4096-af54-b916cb6175c0" 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="https://810714386-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FF8vuadG7OJ1fFdSBZATv%2Fuploads%2F7AfqcfTGhmULTtB1KK9A%2Fimage.png?alt=media&#x26;token=92ebdbc7-699b-4404-8a24-b1ef8717a62c" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://810714386-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FF8vuadG7OJ1fFdSBZATv%2Fuploads%2Fa4QskfNwk7odqbeRhcat%2Fimage.png?alt=media&#x26;token=560a787a-24b0-42e5-a5c5-1848e9f45799" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://810714386-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FF8vuadG7OJ1fFdSBZATv%2Fuploads%2F2n3araTxoPvZOoPHxDxm%2Fimage.png?alt=media&#x26;token=7ec54755-8338-45a2-be7c-aed2eef006bc" 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="https://810714386-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FF8vuadG7OJ1fFdSBZATv%2Fuploads%2FUTorPfnoCis3pgKNT2MX%2Fimage.png?alt=media&#x26;token=1f2b7afc-63fe-4c8e-9e0b-7506fa3f34d7" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://810714386-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FF8vuadG7OJ1fFdSBZATv%2Fuploads%2FtoVBKfM9LkSZLgKYvHqN%2Fimage.png?alt=media&#x26;token=a3381a75-9b9d-4dd7-9568-48cd347e67c0" 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="https://810714386-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FF8vuadG7OJ1fFdSBZATv%2Fuploads%2FQu85qLwVngC63wkuDe0T%2Fimage.png?alt=media&#x26;token=09914fae-4029-4ca0-a95b-d5ba64256ba6" 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="https://810714386-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FF8vuadG7OJ1fFdSBZATv%2Fuploads%2FhYQi7iaGPUaq2T2hbsaT%2Fimage.png?alt=media&#x26;token=9e2609fc-eb9a-40f1-9d64-e82e280dbc00" 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="https://810714386-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FF8vuadG7OJ1fFdSBZATv%2Fuploads%2FT5yGRNTznyOXehdxU2Mc%2Fimage.png?alt=media&#x26;token=ad1d1791-25db-499a-9862-801167e1f6a6" 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="https://810714386-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FF8vuadG7OJ1fFdSBZATv%2Fuploads%2FTAexG7U4J47NRqUvLIsI%2Fimage.png?alt=media&#x26;token=e2b06edb-446c-4522-8a34-623af87e7e19" 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="https://810714386-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FF8vuadG7OJ1fFdSBZATv%2Fuploads%2FHKJUxVqyDD1tRpg7VZnI%2Fimage.png?alt=media&#x26;token=10c3bf08-a175-44fe-969a-f34f28a92eaf" alt=""><figcaption></figcaption></figure>

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

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


---

# 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://help.whautomate.com/product-guides/integrations/whatsapp-cloud-api.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.