> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ycloud.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Connect WhatsApp to YCloud
Connect your business number to YCloud to handle conversations in Inbox, automate common questions with Agents, or send verification codes and order updates from your systems. Choose the right connection method for your number, then test sending and receiving.
## Prepare your account and business information
| Item | Purpose |
| - | - |
| YCloud account | Manage connected numbers, messages, and your team. |
| Number and current registration | Choose a new number, provider migration, or Business app coexistence. When verification is required, make sure you can receive the offered SMS or voice call. |
| Legal business name, address, website, and contact details | Complete business information and prepare for verification. Your website should clearly identify the business and its activities. |
| Registration documents | Support the requested business details when Meta requires verification. |
| Facebook account and asset access | Access the correct portfolio and WABA when using Facebook authorization. QR-code coexistence has a separate flow. |
## 1. Choose your connection method
| Current situation | Choose |
| - | - |
| You want a new dedicated number | Embedded Signup to create or select a WABA and register the number. |
| Your number uses the Business Platform with another provider | [Number migration](/en/documentation/channels/whatsapp-accounts-management/business-accounts/number-migration). |
| You use the WhatsApp Business app and want to keep it | Check [coexistence eligibility](/en/documentation/whatsapp-business-platform/accounts-and-business-identity/whatsapp-business-app-coexistence), then connect the existing number. |
Do not apply Business app coexistence steps to a personal WhatsApp number. Review [Business phone numbers](/en/documentation/whatsapp-business-platform/accounts-and-business-identity/business-phone-numbers) before changing its registration.
## 2. Complete the selected connection
**New number**
1. Sign in to [YCloud](https://www.ycloud.com/console/#/entry/login), open **WhatsApp accounts**, and start Business Platform onboarding.
2. Sign in to the authorized Facebook account in Meta's popup and confirm the account before continuing.
3. Select the existing business portfolio or provide business information to create one. Reuse the correct existing assets to avoid duplicates.
4. Create or select the WABA. Enter its internal name, the number's customer-facing display name, and business category.
5. Enter the number and complete the offered SMS or voice verification. Select **Finish** to return to YCloud. If the number is not registered yet, continue with [Add numbers](/en/documentation/channels/whatsapp-accounts-management/business-accounts/add-numbers).
6. Check the WABA, number, and connection status in **WhatsApp accounts**. See the [Embedded Signup guide](/en/documentation/channels/whatsapp-accounts-management/business-accounts/create-waba-via-embedded-sign-up) for the complete screens.
**Provider migration**
Follow the migration guide to prepare the destination WABA, check display-name review and two-step verification requirements, and arrange the operational cutover. Ordinary number migration does not import the previous provider's chat history into YCloud; preserve the records you need first. After migration, check the number and test templates and replies. Use the dedicated [coexistence migration flow](/en/documentation/channels/whatsapp-accounts-management/coexistence/coexistence-accounts-migration) for a coexistence number.
**Business app coexistence**
The current [onboarding guide](/en/documentation/channels/whatsapp-accounts-management/coexistence/onboard-whatsapp-business-app) offers **Connect with Facebook** and **Connect by QR code**. The Facebook route selects or creates a portfolio. The QR-code route does not require Facebook login or portfolio creation during connection.
Choose the offered method, enter your business information and app number, authorize by scanning with the Business app on the primary phone, and decide whether to share history. QR-code connection does not exempt you from subsequent business verification. If you have no website, use the offered no-website option. If you authorize history sharing, keep the app open until synchronization finishes before checking new Inbox messages. Review the guide for eligibility and synchronization coverage.
## 3. Check business verification and sending readiness
Business verification establishes the organization and its connection to the assets. When required:
1. Select the portfolio that owns the WABA and confirm the operator has the required control.
2. Open Meta's offered verification flow, such as **Security Center** or the relevant product flow.
3. Check the legal name, address, contact details, and website. Supply accepted documents and complete the offered connection-verification method.
4. Check the actual review status and requests for additional evidence. A verified status in another portfolio does not verify this one.
A utility bill's suitability depends on the field and current requirements; it is not a general substitute for proof of the legal business name. See [Business verification](/en/documentation/whatsapp-business-platform/accounts-and-business-identity/business-verification).
Review the [number profile](/en/documentation/channels/whatsapp-accounts-management/phone-number-management/phone-number-profile-settings), [messaging limits](/en/documentation/whatsapp-business-platform/pricing-limits-and-quality/messaging-limits-and-throughput), and [billing](/en/documentation/pricing-and-billing/billing-overview). Verification does not automatically grant a badge or unlimited sending.
## 4. Test before choosing a workflow
Use an approved template to [send a test message](/en/documentation/channels/whatsapp-accounts-management/template-management/test-a-message) to a consenting test recipient. Check the sender, language, and content. Ask the recipient to reply and confirm the reply reaches Inbox or your receiver. Inspect [Message logs](/en/documentation/channels/whatsapp-accounts-management/data-analysis/message-logs).
If number verification fails, check the country code and SMS or voice reception, then follow the displayed retry instructions. An already-registered error requires identifying whether the number belongs to an app, provider, or your current assets before changing it. Preserve the error and contact [YCloud Support](/en/documentation/support/ycloud-support-team) when needed.
Continue with [verification codes](/en/documentation/quick-start/send-verification-codes-via-whatsapp), [utility updates](/en/documentation/quick-start/send-utility-messages-via-whatsapp), [CTWA](/en/documentation/quick-start/acquire-customers-with-click-to-whatsapp-ads), [marketing](/en/documentation/quick-start/run-marketing-campaigns-via-whatsapp), or [customer support](/en/documentation/quick-start/set-up-customer-support-via-whatsapp).
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.