> ## Documentation Index
> Fetch the complete documentation index at: https://developer.hubmessage.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Cloud API

> Connect a number to the WhatsApp Official API through the Cloud API

export const frontendUrl = 'https://app.hubmessage.io';

export const projectName = 'Hub Message';

## Overview

The **Cloud API** lets you connect a number directly to the **WhatsApp Official API** through your Meta Business Account (Business Manager). This is the most traditional method for new numbers and gives you access to all the features available on the platform.

## Requirements

* **Business Portfolio (BM)**: you need to have a business portfolio set up (verified, if possible. This gives the BM more credibility with Meta)
* **Account administrator**: you'll need to have an administrator profile on the business account and on Facebook
* **The number must not be in the WhatsApp app**: to use this connection method, the number can't be active in the WhatsApp app. You'll need to disconnect it from the app first. The process between disconnecting and attempting a connection to the Official API through the Cloud API can take a few minutes
* **A number that can receive SMS or calls**: you need a number that can receive an SMS or a phone call, since Meta will send a verification code

## Adding a number through Meta

### Step 1 - Access the Business Portfolio (BM)

* Go to: [business.facebook.com](https://business.facebook.com/)
* Click the gear icon for the relevant Portfolio

<Frame>
  <img src="https://mintcdn.com/hubmessage-2b5e33d5/IO7XX-F8J3cnZZV0/images/cloud-api-1.png?fit=max&auto=format&n=IO7XX-F8J3cnZZV0&q=85&s=f97c133c9a94236af3940e59d017fceb" alt="Access Business Portfolio" width="449" height="661" data-path="images/cloud-api-1.png" />
</Frame>

### Step 2 - Access the WABA (Business Account) screen

* Click **"WhatsApp Accounts"**

<Frame>
  <img src="https://mintcdn.com/hubmessage-2b5e33d5/IO7XX-F8J3cnZZV0/images/cloud-api-2.png?fit=max&auto=format&n=IO7XX-F8J3cnZZV0&q=85&s=af8bad4198f7c02ea87a44ae723e2bc8" alt="WhatsApp Accounts" width="395" height="707" data-path="images/cloud-api-2.png" />
</Frame>

### Step 3 - Add a new WABA and a new number

You can add a WABA directly through Meta.

* Click the **Add** button

<Frame>
  <img src="https://mintcdn.com/hubmessage-2b5e33d5/IO7XX-F8J3cnZZV0/images/cloud-api-3.png?fit=max&auto=format&n=IO7XX-F8J3cnZZV0&q=85&s=4323f82a98380202f5ceab521d4d7bf6" alt="Add button" width="1503" height="299" data-path="images/cloud-api-3.png" />
</Frame>

* Click **Create a new WhatsApp Business account**

<Frame>
  <img src="https://mintcdn.com/hubmessage-2b5e33d5/IO7XX-F8J3cnZZV0/images/cloud-api-4.png?fit=max&auto=format&n=IO7XX-F8J3cnZZV0&q=85&s=de340dd12384a5636f467fbec555d645" alt="Create a new WhatsApp Business account" width="1502" height="409" data-path="images/cloud-api-4.png" />
</Frame>

### Step 4 - Fill in the business information

* **Set up the WhatsApp display name**: it's important that it matches your business name and follows [Meta's guidelines](https://www.facebook.com/business/help/757569725593362)
* **Select a category** that matches your business (Automotive, Education, etc.)

<Frame>
  <img src="https://mintcdn.com/hubmessage-2b5e33d5/IO7XX-F8J3cnZZV0/images/cloud-api-5.png?fit=max&auto=format&n=IO7XX-F8J3cnZZV0&q=85&s=89afbfc1d450cd595e555579425e7aa8" alt="Fill in business information" width="855" height="517" data-path="images/cloud-api-5.png" />
</Frame>

### Step 4 - Choose the number

You'll have two options to choose from:

* **Use a display name**: with this option, Meta creates a virtual number (which can't receive calls or SMS) and only the display name is shown to the customer on WhatsApp
* **Add a number**: with this option, you'll need to add a new number

<Frame>
  <img src="https://mintcdn.com/hubmessage-2b5e33d5/IO7XX-F8J3cnZZV0/images/cloud-api-6.png?fit=max&auto=format&n=IO7XX-F8J3cnZZV0&q=85&s=c7189a129b3de2f903cd7ce4c2d764c2" alt="Choose the number" width="893" height="334" data-path="images/cloud-api-6.png" />
</Frame>

### Step 5 - Verify a phone number

If you choose the **"Add a number"** option, you'll need to verify your phone.

* Choose **SMS** or **Call**

After that, your number will be validated and you'll be able to use it to connect.

<Note>
  It's important to set up a payment method in order to send templates.
</Note>
