---
description: Learn how to configure your WhatsApp Business Platform (API) channel and manage your profile on respond.io.
title: WhatsApp Business Platform (API) Channel Configuration
image: https://assets1-proxy.respond.io/api/v1/image/assets%2F11f7a662b80a4675973850b067c01fa5%2F3f43c48b21b24f4e8b02b100c0c8fab0
---

[New🌍 WhatsApp API Calling is now available globally! Start making calls with respond.io today. Learn more![arrow-icon](https://assets1-proxy.respond.io/api/v1/image/assets%2F11f7a662b80a4675973850b067c01fa5%2Fe43213a7a9314673bd8d2060c25f9b87)](/whatsapp-business-calling-api)

Help me with... ⌘ 

1. [All Collections >](/help)
2. [ Channels >](/help/channels)
3. [ WhatsApp >](/help/whatsapp)
4. WhatsApp Business Platform (API) Channel Configuration

# WhatsApp Business Platform (API) Channel Configuration

![Avatar](https://assets2-proxy.respond.io/ph8r57dk1q9w/4GvzCieeTBRY4TRJUbIr4y/b92428e6b049d23f546269180534f7ea/Ryan_Tan_Avatar.svg)

Joshua Lim

· 03 Dec 2025

8 min read

## Configuring WhatsApp Channel Name

A WhatsApp Business Platform (API) channel can be configured with a unique channel name.

**Step 1:** Navigate to **Workspace Settings** \> Click **Channels**.

**Step 2:** Locate the WhatsApp Business Platform (API) Channel > Click **Manage.**

![](https://assets2-proxy.respond.io/ph8r57dk1q9w/3J9BSjLEp98kl3QelUGLOJ/fb04ab75b98f1179337799468b203e4c/image.png?fm=jpg&q=80&w=1200&fl=progressive)

**Step 3:** Configure the Channel name, which is used internally to identify the account.

**Step 4:** Click **Save Changes** to update the Channel configuration.

## Managing Profile for WhatsApp Business Platform (API)

If there is a need to make a change or check your WhatsApp Business Platform (API) Profile, it can be done on the respond.io platform.

**Step 1:** Navigate to **Workspace Settings** \> Click **Channels**.

**Step 2:** Locate the WhatsApp Business Platform (API) Channel > **Manage > Profile**

![](https://assets2-proxy.respond.io/ph8r57dk1q9w/3GriDY2jGIPaAgIG5vk6bY/a8ccc66edf976662413d0c972560562d/image.png?fm=jpg&q=80&w=1200&fl=progressive)

**Step 3:** If the profile hasn't been synced, click **Sync Profile** to obtain the latest WhatsApp Business Profile information from WhatsApp.

**Step 4:** You may edit the following information as needed:

| Fields        | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Profile Photo | Image shown as the profile picture of the WhatsApp Business Account.An image size of 640x640 is recommended.note: Images smaller than 192x192 may cause issues when resizing during upload.                                                                                                                                                                                                                                                                                     |
| About         | The business's About text. This text appears in the business's profile beneath its profile image, phone number, and contact buttons - maximum of 139 characters.                                                                                                                                                                                                                                                                                                                |
| Address       | Address of the business. Maximum of **256 characters.**                                                                                                                                                                                                                                                                                                                                                                                                                         |
| Description   | Description of the business. Maximum of **512 characters.**                                                                                                                                                                                                                                                                                                                                                                                                                     |
| Email         | Email address (in valid email format) to contact the business. Maximum of **128 characters.**                                                                                                                                                                                                                                                                                                                                                                                   |
| Vertical      | Industry of the business. Must be one of these accepted values:\- Automotive\- Beauty, Spa and Salon\- Clothing and Apparel\- EducationEntertainment\- 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\- OtherThe business vertical cannot be set back to an empty value after it is created. |
| Website       | URLs (including http:// or https://) associated with the business (e.g., website, Facebook Page, Instagram). Maximum of **2** websites with a maximum of **256 characters** each.                                                                                                                                                                                                                                                                                               |

**Step 5:** Review the information and click **Save Profile**.

## Metadata Received by Channel

Different channels provide different sets of Contact’s metadata to respond.io platform. You can obtain the following Contact's data from this channel:

* Phone number
* Phone number ID
* Profile name
* WhatsApp ID

## Supported File Types

The file type supported by WhatsApp and the maximum file size for the type is as follows:

* Audio & Video (16MB)
* Document (100 MB)
* Image (5 MB)
* Sticker (100 KB)

> Messages that are not supported will have a fallback display with Unsupported Message or Custom Payload text and Type (if available). For any unsupported file type or file that exceeds the maximum file size sent via WhatsApp Business Platform (API), the file will automatically be turned into a URL link on the respond.io platform. For Custom Payload, you can click _Show More_ to view the JSON payload of this message. Examples of unsupported messages for WhatsApp Business Platform (API) are:  
> \- Contact Card  
> \- Reactions  
> \- Deleted Message  
> \- Polls  
> \- Ephemeral Message

> Make sure that the file format of your file is supported; otherwise, the file may fail to send despite being within the size limit. This happens when the file is not converted properly. Learn more about the [supported media types here](https://developers.facebook.com/docs/whatsapp/cloud-api/reference/media#supported-media-types).

## Text Formatting

You can use text or markdown formatting in your messages. Learn more on [how to format your text here](https://faq.whatsapp.com/539178204879377).

## Rate Limits

A rate limit is the number of API calls an app or user can make within a given time period defined by the channel. Learn more about the [rate limits for this channel here](https://developers.facebook.com/docs/whatsapp/cloud-api/overview/).

## Limitations

### WhatsApp Groups

Group Messages are not supported by WhatsApp Business Platform (API). Meta has deprecated the development of this feature.

### Unsupported number types

WhatsApp does not allow VoIP, toll-free or landline numbers. This includes:

* **Telnyx numbers** (no longer supported since January 2023)
* **Google Voice numbers** (VoIP)

## Best Practices to Avoid WABA Disablement

To ensure long-term stability of your WhatsApp Business Platform (API) setup and avoid unexpected bans or disruptions, follow these best practices:

### Use a verified and unique Meta Business Manager (MBM)

* Only use **one MBM** per business. Creating multiple MBMs with the same business name, address, or website may be flagged by Meta.
* If a previous MBM was banned, avoid using the same business details to create a new one—Meta may instantly ban it.
* **Verify your MBM** by submitting official business documents (e.g. business license, matching website).
* **Control access carefully**: Only grant admin rights to real Facebook profiles with consistent activity (posts, friends, etc.).
* **Enable Two-Factor Authentication (2FA)** for all Admins.

### Manage WhatsApp Business Accounts (WABAs) responsibly

* If a WABA is banned, **appeal via Meta Support**. Do not create a new one while the appeal is pending—this may be seen as policy evasion.
* Use clear and accurate **display names**. For example, “Acme Co – California” is better than just “Acme”.
* Do not delete and recreate phone numbers frequently (“burning” numbers). Instead, resolve the reported issue via Meta.

### Handle Facebook users the right way

* Admins must use **authentic Facebook accounts** with real history.
* Avoid using newly created or duplicate accounts solely for access purposes.
* **Limit access** to essential team members and regularly audit MBM users.
* Enforce 2FA to reduce the risk of unauthorized access.

### Keep your business aligned across platforms

* Ensure your **business name, address, website, and other details match** across your MBM, WABA, and Ad Account.
* This alignment increases trust with Meta and improves your chances of verification.

### If your WABA gets disabled

* **Do not panic or create a new WABA**.
* **Submit an appeal** via [Meta Business Support](https://business.facebook.com/help/).
* Gather and provide necessary documentation (e.g., business license, proof of domain ownership).
* Review and correct any violations of Meta’s [Business Messaging Policy](https://www.whatsapp.com/legal/business-policy/).

> Following these best practices helps ensure your WhatsApp setup remains secure, stable, and compliant with Meta’s policies.

## FAQ and Troubleshooting

### What are the requirements for phone number to be used to sign up for WhatsApp Business Platform (API)?

* The phone number used for WhatsApp Business Platform (API) can’t be used in the WhatsApp Personal or Business app. You'll have to delete the account on WhatsApp Personal or Business app before you can use the number to sign up for WhatsApp Business Platform (API).
* You can still use the phone number for other purposes, such as calling and receiving SMS after registering it on the WhatsApp Business Platform.

### Can I view my conversation insights for my WhatsApp Business Account?

Yes, you can monitor your messaging and spending analytics in real-time for your WhatsApp Business Account in the **Insights** tab of your Meta WhatsApp Manager. Read more [here](https://www.facebook.com/business/help/338500813332755?id=2129163877102343).

### Why do I see duplicate Contacts from the same WhatsApp channel?

WhatsApp passes the Contact’s phone number in [a format that is different from the E.164 format](https://faq.whatsapp.com/640432094208718) that respond.io uses. This difference causes Contacts from certain countries to be duplicated. Should this occur, do [reach out to us here](https://respond.io/contact).

### How do I get my business name to be shown to my contacts on WhatsApp rather than my business number?

Standard WhatsApp Business Platform (API) Accounts display the business number rather than the name. To display your business name to Contacts even if they haven't added your business to their address book, you will need a WhatsApp Official Business Account.

Official Business Accounts have a green tick next to the business name, and usually only large, high-profile businesses will be given this status. Learn more about how to [apply for an Official Business Account here](https://respond.io/help/whatsapp/whatsapp-official-business-account-green-tick).

### What is Meta Product Catalog and how can I use it?

Meta Product Catalog is a feature that allows you to create a catalog of your products and share it with your customers. Learn more about [using Meta Product Catalog in respond.io](https://respond.io/help/whatsapp/meta-product-catalog) here.

### Can a subsidiary company or an agency register a WhatsApp Business Account on behalf of another company?

Yes, they can. However, the Meta Business Account and business information used to register the WhatsApp Business Account must belong to an entity that can be verified with the relevant legal documentation. Learn more about [Meta Business Verification here](https://respond.io/blog/facebook-business-verification#toc-mobile-0).

### How many phone numbers can a business register when signing up for a WhatsApp Business Platform (API) account and How can I increase that limit?

When a business signs up for a WhatsApp Business Platform (API) account and is unverified, they can register up to 2 phone numbers only. Verified businesses have the ability to register more phone numbers. They may register up to 20 phone numbers for a single Business Manager.

If you are stuck at a lower number, such as 5 phone numbers, and are unable to register additional numbers, you can submit a ticket directly to Meta to request an increase in the phone number limit.

**Steps:**

1. Click here [this link](https://business.facebook.com/direct-support/) for direct support.
2. Go to Ask a Question > WABiz: Account & WABA > Request type > Increase Phone Number Limits
3. Provide an explanation of why you want to increase the phone number limit.
4. Submit your request.

### How can I check my WhatsApp conversation consumption?

To check your WhatsApp conversation consumption, follow these steps:

1. Navigate to your [Meta Business Manager](https://business.facebook.com/settings/info).
2. Click on **Settings** \> **Business Settings** \> **WhatsApp Accounts**
3. Select your WABA and click on **Settings** \> **WhatsApp Manager**.
4. Under **Account tools**, click on **Insight**.

### Why does the message enter as an unsupported message with error code: 131051?

One of the possible reasons is that WhatsApp API accounts are not designed to chat with other WhatsApp API accounts. This is a Meta restriction. Note that the _error code: 131051_ is used for multiple types of errors related to unsupported message types. If you are unsure about this error, you can [contact our support](https://respond.io/contact).

### Why am I receiving an error message stating "Undefined: Receiver is incapable of receiving this message" when trying to send messages?

This error message is passed by Meta. Here are a few steps suggested by Meta to troubleshoot the issue:

Ensure that the Contact receiving the message:

* has an active WhatsApp account.
* is using the latest version of WhatsApp.
* has accepted the new Terms of Service and Privacy Policy.
* is not banned on WhatsApp or from a country where WhatsApp is banned.

### I’ve lost credentials for my Meta Business Manager account. What should I do?

To regain access to your Meta Business Manager account, you can learn how to reset your password and recover your email address or phone number [here](https://www.facebook.com/help/213395615347144).

### Why was my WhatsApp Business Account disabled?

Your WhatsApp Business API (WABA) account may be disabled for several reasons. Common issues include non-compliance with Meta's Commerce Policies and listing an invalid website. To appeal this decision, you should take the following steps:

**Ensure Compliance with Meta's Commerce Policies:** Review and align your business practices with Meta's guidelines. This is crucial for a successful appeal.

**Ensure you have a** **Valid** **Website:** Update your business information in the Meta Business Manager (MBM) to include a valid and clear website that showcases the nature and details of your business.

[**Prepare an Appeal**](https://respond.io/help/whatsapp/whats-app-business-api-channel-configuration#what%5Fshould%5Fi%5Fdo%5Fto%5Fprepare%5Fan%5Fappeal%5Fif%5Fmy%5Fwaba%5Fis%5Fdisabled)**:** In the appeal dialogue, explain how your business uses WhatsApp for communication. Highlight that:

* Messages are sent only to customers who have opted in.
* All communications are relevant to your business and following WhatsApp's policies.

Learn how to request a review with Meta [here](https://www.facebook.com/business/help/422289316306981).

### What should I do to prepare an appeal if my WABA is disabled?

Follow these steps and review the key information to ensure your appeal is well-prepared. If you are [appealing through our Customer Support team](https://respond.io/contact), please ensure that these screenshots are shared with them as well. 

1. **Review your business account quality:** Go to [Account overview](https://business.facebook.com/business-support-home/?landing%5Fpage=account%5Foverview) \-> Click **View my accounts**
![](https://assets2-proxy.respond.io/ph8r57dk1q9w/1QEDwIoeH2WpF4NT8LXHIt/dfef01e20ac63f306188593119dbeff8/image.png?fm=jpg&q=80&w=1200&fl=progressive)

2\. **Verify business details:** Go to [Business portfolio info](https://business.facebook.com/latest/settings/business%5Finfo?)

![](https://assets2-proxy.respond.io/ph8r57dk1q9w/67rsKG3un4OrGG05B2pkEK/aca3de2da50dbc6f4c04c725e63a5e47/image.png?fm=jpg&q=80&w=1200&fl=progressive)

3\. **Retrieve your MBM ID, WABA ID and phone number quality rating to submit an appeal:** 
 \- Retrieve your MBM ID from your business info.

![](https://assets2-proxy.respond.io/ph8r57dk1q9w/6onesqO7LMCfbPpuMncpIf/ff14e7469413afb0b620d29eebd1d7f7/image.png?fm=jpg&q=80&w=1200&fl=progressive)

\- Go to [WhatsApp accounts](https://business.facebook.com/latest/settings/whatsapp%5Faccount?) and retrieve your WABA ID. Select the correct WhatsApp account and click to copy the WABA ID.

![](https://assets2-proxy.respond.io/ph8r57dk1q9w/4KdtjS3zaSiVBu0f43gJ3A/b4ee632a4b979a0f770f6719fb90b84f/image.png?fm=jpg&q=80&w=1200&fl=progressive)

\- Scroll down and go to your WhatsApp Manager to view your phone number quality rating.

![](https://assets2-proxy.respond.io/ph8r57dk1q9w/3bcce8uXGL5duIEgtttjI2/b2b1177db94d3e25dc80c2ae0075ea72/image.png?fm=jpg&q=80&w=1200&fl=progressive)

### Why did I receive this error "Business eligibility payment issue" when sending a message?

This error may occur when you have recently deleted a Channel and tried to send a WhatsApp message template or start a new conversation using a different WhatsApp Business number. This is due to the credit line being released from your deleted Channel's phone number and redistributed to your remaining phone numbers. This process can take up to 5 minutes. We recommend waiting for 5 minutes before sending the message again.

> This error will only occur if you have more than one number under the same Business Manager and those numbers are connected to the platform.

### Can my WhatsApp API number connected to a WhatsApp Business Account (WABA) registered in Business Suite directly connect to respond.io?

No, it is not possible for your WhatsApp API number that's connected to a WhatsApp Business Account (WABA) registered in Business Suite to directly connect to respond.io.

### Why isn't my Contact's profile picture showing?

Due to limitations with the WhatsApp Channel, we are unable to display your Contact's profile picture. WhatsApp does not provide an API that allows us to fetch this information.

### What happens when I delete my WhatsApp Channel?

Deleting a WhatsApp Channel will not remove the associated Contacts or chat history.

Chat history is linked to your Contacts, unless you manually delete a Contact from the Contacts module, both the Contact and their conversation history will remain in the workspace.

When you reconnect the same WhatsApp Channel and receive a message from the same number, the Contact will be merged with the existing one.

### Why am I seeing “Meta Error (#131057): Account in maintenance mode” on WhatsApp?

This happens when your WhatsApp Business Account is temporarily in maintenance mode, usually during a throughput upgrade. It lasts about a minute, and your number will work again automatically once the upgrade is done.

### Why am I seeing a “Media Upload Error” or “Media Download Error” when sending a template?

These errors occur when the media file attached to your template doesn’t meet Meta’s requirements. Common causes include:

* The file format is not supported.
* The file type is incorrect.
* The media exceeds Meta’s size limits.

These issues originate from Meta’s side and are outside respond.io’s control. You can also refer to Meta’s [error codes documentation](https://developers.facebook.com/docs/whatsapp/cloud-api/support/error-codes#error-codes) for more details on specific error responses.

### Why can’t my contact see which message I’m replying to on WhatsApp?

This happens because WhatsApp messages older than 30 days are moved to long-term storage by Meta, and the context of the replied message is no longer available. As a result, the “reply-to” bubble does not appear on messages sent as replies to those older messages. 

### Does WhatsApp Business Platform (API) support group chats?

No, it does not support managing or sending messages to group chats. Meta has deprecated the development of this feature.

Share this article

[![Telegram](https://assets1-proxy.respond.io/api/v1/image/assets%2F11f7a662b80a4675973850b067c01fa5%2F44daca77a4844f0c8fd29040ddeba057?width=22)](https://api.whatsapp.com/send?text=https://respond.io/help/whatsapp/whats-app-business-api-channel-configuration)[![Facebook](https://assets1-proxy.respond.io/api/v1/image/assets/11f7a662b80a4675973850b067c01fa5/fff57eeb01160bc604392f519b4f3461ca16f0fa1b6a587b20b142cdf1ad0ba7?placeholderIfAbsent=true&width=22)](https://www.facebook.com/sharer/sharer.php?u=https://respond.io/help/whatsapp/whats-app-business-api-channel-configuration)[![Linkedin](https://assets1-proxy.respond.io/api/v1/image/assets/11f7a662b80a4675973850b067c01fa5/7aaf8d87b5410844d83e06a4ed663e4f551b8c5ef51dbb20a8ff064a1eed9a0f?placeholderIfAbsent=true&width=22)](https://www.linkedin.com/sharing/share-offsite/?url=https://respond.io/help/whatsapp/whats-app-business-api-channel-configuration)[![Twitter](https://assets1-proxy.respond.io/api/v1/image/assets%2F11f7a662b80a4675973850b067c01fa5%2F4e03e02422a94e8eab9b8b41457c2371?width=22)](http://twitter.com/share?url=https://respond.io/help/whatsapp/whats-app-business-api-channel-configuration)

## 

Related articles 👩‍💻

* [WhatsApp Business Platform (API) Quick StartGet a WhatsApp Business API account fast to start chatting with your customers. ](/help/whatsapp/whatsapp-api-quick-start)
* [WhatsApp Business App Quick Start (WhatsApp Coexistence)Learn how to connect the WhatsApp Business App to respond.io for seamless messaging and automation. ](/help/whatsapp/whatsapp-coexistence)
* [Getting Ready for Inbound ConversationsLearn about conversation windows, sending message templates and setting up a simple entry point to manage WhatsApp messages from your customers. ](/help/whatsapp/getting-ready-for-inbound-conversations)
* [Getting Ready for Promotional MessagingLearn how to broadcast promotional messages using WhatsApp message templates. ](/help/whatsapp/getting-ready-for-promotional-messaging)
* [WhatsApp Official Business Account (Blue Tick)Learn how to get a WhatsApp Official Business Account. ](/help/whatsapp/whatsapp-official-business-account-blue-tick)

Can't find what you're looking for? 🔎

[Contact Support](/contact-us)

2025-12-05T03:58:03.817Z

help

```json
[{"@context":"https://schema.org","@type":"TechArticle","articleBody":"Learn how to configure your WhatsApp Business Platform (API) channel and manage your profile on respond.io.","author":{"@type":"Person","image":"https://assets2-proxy.respond.io/ph8r57dk1q9w/4GvzCieeTBRY4TRJUbIr4y/b92428e6b049d23f546269180534f7ea/Ryan_Tan_Avatar.svg","name":"Joshua Lim","url":"https://respond.io/author"},"dateCreated":"2025-04-18T14:18:00.000Z","dateModified":"2025-12-03T22:03:58.090Z","datePublished":"2025-04-18T14:18:00.000Z","headline":"WhatsApp Business Platform (API) Channel Configuration","image":"https://assets2-proxy.respond.io/ph8r57dk1q9w/6JR2K21jt1pwEm4hdNaNJu/50c569aff7320939f8a33cc1293f7e1a/image.png","mainEntityOfPage":"https://respond.io/help/whatsapp","publisher":{"@type":"Organization","logo":"https://respond.io/favicon/favicon.svg","name":"respondio"},"thumbnailUrl":"https://assets2-proxy.respond.io/ph8r57dk1q9w/6JR2K21jt1pwEm4hdNaNJu/50c569aff7320939f8a33cc1293f7e1a/image.png","url":"https://respond.io/help/whatsapp/whats-app-business-api-channel-configuration"},{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","name":"Help","item":"https://respond.io/help","position":1},{"@type":"ListItem","name":"Channels","item":"https://respond.io/help/channels","position":2},{"@type":"ListItem","name":"WhatsApp","item":"https://respond.io/help/whatsapp","position":3},{"@type":"ListItem","name":"WhatsApp Business Platform (API) Channel Configuration","item":"https://respond.io/help/whatsapp/whats-app-business-api-channel-configuration","position":4}]}]
```
