# 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>" %}