# Cloud API ### Overview Cloud API from Meta is an official API to allow developers and businesses to use WhatsApp Business APIs for sending and receiving messages over WhatsApp without hosting their own servers. Using this, you can manage up to 80 messages (combined both sent and received) per second, including text and media. This guide will help you connect Rampwin Channel to Cloud API and initiate the conversation, send notifications, purchase updates, and more. {% hint style="warning" %} To follow this guide, ensure you have an active Meta Developer account. {% endhint %} ### 1) Create a WhatsApp Application To create a WhatsApp application, first, go to Meta for Developers ([https://developers.facebook.com](https://developers.facebook.com/)), then head over to My Apps.

Then, on the apps page, click **Create App**.

Then choose other option and click on next.

This will open a new page, where you've to select your app type.

Select **Business** and then click *Next*. On the next page, you need to enter details for the application. Make sure you add the correct information to avoid suspension or blocking of the app. The details it needs are, * Display name - It's the name that'll help recognise your app in the app library. * App contact email - The email which will Meta use to notify about different events related to your app. * Business Account - The manager who'll have complete control over the app.

Enter the details as applied, then select your Business Manager and click *Create app*. {% hint style="info" %} An email will be sent to the email address you've added. Make sure you verify the account using the link mentioned in it. {% endhint %} ### 2) Add Products to Your App As soon as you click the Create app button, it will redirect you to the following page. Here, you can see different options that you can utilise for your app.

Now, on this page, you've to scroll down a bit and click **Set up** for WhatsApp.

A new page will come up asking you to confirm details for WhatsApp Business Platform API. Check your details and then click **Continue**.

Continue With WhatsApp Business Platform API

As you continue, the Getting started page will open with a temporary access token, test number and more.

Here, scroll down and click on **Add Phone Number**. This will bring a popup to fill in your business information.

You need to fill, * Legal Business Name * Business Email * Country * And Business Website After entering the details, click *Next*, and it will bring fields to create a WhatsApp Business profile.

Fields to Create a WhatsApp Business Profile

The details now it needs are, * WhatsApp Business Profile display name * Timezone * Category * And Business description Simply enter the details and click *Next*. This time it will bring the field to enter your phone number.

First, select your country code, then enter the number. After that, choose how you want to verify it, and then click *Next*.

Enter the code you've received and then click **Next**. Once the number is verified, you must check whether you're WhatsApp Business profile is created or not. To do that, go to the *Send and receive messages* section on this page.

Then, select **Test Number** in the *From* field. Or you can continue with the default.

In the **To** field, enter the number you want to send the test message.

Once both numbers are added, click **Send message**.

If the number you've added for the WhatsApp Business Profile is working, the recipient will get the test message like the above. It means, your number is verified and you can continue with the setup. ### 3) WhatsApp Business Profile Verification Before you further proceed with steps to create a Rampwin Channel connected to Cloud API, it's must you verify the business profile first. And to do so, you've to visit , select My Apps, and then click on the Business name.

On the Business Settings page, scroll down the left tab and select Business Info.

Then, on the Business information page, add information in the Business details section.

Once added the required information, you can continue with the next step. ### 4) Create a RampwinCloud API Channel You've created a WhatsApp Business Profile, now you can connect Rampwin to it. In order to do so, log in to your Rampwin account, then go to Channels, and click **Configure** for Cloud API.

Creating Cloud API Channel Through Configure

Or you could click *Create Channel* if there are channels already in the list.

As soon as you click the Next button, a popup will appear with several fields. In those fields, you've to set Channel Title, System User Access Token and Business Manager ID.

For Title, you can set anything that will help you recognise the channel. For System User Access Token, you've to access your WhatsApp Application to generate it using the *Webhook URL* and *Verify Token* mentioned in the above channel details. #### Edit Webhook Callback URL and Verify Token First, go to , then select the app.

This will open the app dashboard like the following. There, click on WhatsApp and select Configuration.

Then, on the Configuration page, click **Edit** in the Webhook section.

This will open the following Webhook's callback URL popup.

Here, you need to paste the values available in the Channel Details at Rampwin.

Copying Webhook URL and Verify Token Value

First copy the Webhook URL, then Verify Token and paste them into the Webhook's callback URL. You've to copy and paste the values individually.

Adding Values to the Webhook Callback URL

Once added both the values click on **Verify and save**. After saving the webhook URL, click **manage** to select webhook fields.

You'll see multiple webhook fields. *Subscribe* to all and then click **Done**. After this, you'll see your subscribed webhook fields in the configuration section.

Now, you can generate the System User Access Token #### Generating System User Access Token To generate the System User Access Token for Cloud API Channel at Rampwin, you need to go to , there select the Business account manager you've used to create the WhatsApp application.

Based on your selection, it will open the Meta Business Settings. There, you'll have to go to the Users → System Users → click **Add**.

It will open a terms modal, simply click **I Accept**, then **Done** and on the next window, enter details as, * System Username - The name you want to assign to this user. * System User Role - Admin.

Once given the username and assigned the Admin role, click **Create System User**. This will take a few moments to create the system user. Once the user has been created it will ask you to accept the terms. So, click **I Accept** then **Done**, and you'll have your System User page as the following.

Here, click **Add Assets**. An assigning assets popup will come for the System User in which you have to select **Apps** → **select the App** → **Toggle everything to YES** → then click **Save Changes** → **Done**.

Once you finish assigning the asset, you can see the app in the System User Account.

Now to generate the System User Access Token, click **Generate New Token**.

Then select the App,

And once you select it, you'll find different permissions from which you have to select, * business\_management * whatsapp\_business*\_messaging* * whatsapp\_business\_management

After selecting the permissions, click **Generate Token**. This will bring the access token which you have to copy and save on your cloud storage or local system. Once copied, click OK.

Now, head back to Rampwin, and paste the access token in the System User Access Token Field.

Then, visit the System User again, and copy the business id from the URL.

Head back to Rampwin again and paste the Id in the Business Manager ID field. Then, click **Fetch Numbers**.

Adding Business Manager ID and Fetching Phone Numbers

This will showcase the WhatsApp Business Accounts and the Phone Numbers Associated with them.

WhatsApp Business Account and Phone Number

Confirm the details or select a different account and number, then click **Finish**. That's it; you've successfully created a Rampwin Channel and connected it to Cloud API.

{% hint style="success" %} Now, you can chat with customers over WhatsApp using the Rampwin Channel. However, you'll only be able to send and receive up to 1,000 free messages monthly. To increase the limit, you've to add a payment method. {% endhint %} ### Channel Configuration The additional options available for the Channel enable you to utilise it at its best.

* **Details** - Using this access additional options to create Message Templates, [**Buttons/Options/Product Messages**](#button-options-product-messages), Store Settings, and more. * [**Manage Templates**](#set-up-message-template) - Directly access the controls to manage or create message templates. * [**Store Settings**](#store-settings) - Configure payment partners and links for the channel. * [**Manage Profile**](#manage-profile) - Make changes to the WhatsApp Business Profile. * [**Edit**](#more-options) - Access controls to edit channel; copy its id and more. ### Set Up Message Template Refer to the following docs. ### Button/Options/Product Messages Refer to the following docs ### Store Settings Please, explore the following doc to learn more about Rampwin WhatsApp Channel Store Settings. ### Manage Profile Using the Manager Profile option of your Cloud API WhatsApp Channel, you can change your business details for WhatsApp.

Click on the Manage Profile, and it opens the Profile settings like the following,

Here, you can change your Profile Picture, Address, Description, Email, Website and Business Vertical from the available options, * Automotive Beauty * Spa and Salon * Clothing and Apparel * Education * Entertainment * Event Planning and Service * Finance and Banking * Food and Grocery * Public Service * Hotel and Lodging * Medical and Health * Non-profit Professional Services * Shopping and Retail * Travel and Transportation * Restaurant * Other Once done, click **Save Changes**. ### More Options In addition to the Manage Templates, Store Settings, and Manage Profile, there are a few more options you can utilise.

* **Edit** - It provides you with the option to change Channel Name; Add Webhook URL and Disconnection Alert Emails.

* **Delete** - Simply delete the channel. * **Mark as Default** - You'll see this particular channel as the primary channel in the Chat. * **Copy Channel ID** - Copy Channel ID without opening the Phone Settings.