> For the complete documentation index, see [llms.txt](https://docs.askyazi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.askyazi.com/set-up-whatsapp/connect-your-own-number.md).

# Connect your own number

Connect your own WhatsApp business number to Yazi through Meta's sign-up window, and what to do once it is connected.

You connect your own WhatsApp number to Yazi through a Meta sign-up window that opens inside Yazi (Meta calls this "embedded signup"). It creates or links your WhatsApp Business Account, registers your number and gives Yazi permission to send and receive messages on it.

{% hint style="info" %}
**In short:** have full control of a Meta Business Manager and a mobile number that is not on WhatsApp ready before you start. The connection itself takes 15 to 30 minutes. Afterwards, add a payment method in Meta, start business verification, set your profile picture and create your templates.
{% endhint %}

## Before you start

Check you have everything on the list in [WhatsApp number options](https://docs.askyazi.com/set-up-whatsapp/whatsapp-number-options.md#what-you-need-for-your-own-number). In particular:

* **Full control** of your company's Meta Business Manager, or permission to create one.
* **The phone with the SIM** for your new number to hand, ready to receive an SMS or a call.
* **Pop-ups allowed** for app.askyazi.com in your browser, because Meta's window opens as a pop-up.
* **No VPN**, if you can avoid it. VPNs and old browser sessions often send Meta's login into a loop. A private browser window, or your phone's hotspot, usually fixes it.

### If your company does not have a Meta Business Manager yet

You can create one before you start, or during the sign-up window.

1. Go to [business.facebook.com](https://business.facebook.com) and sign in with a Facebook login. Facebook is only used to sign in: the Business Manager stays separate from your personal profile, and your profile is never shown to participants.
2. Follow Meta's steps to create a business (Meta may call it a business portfolio). Meta asks for details such as your business name, your name and your work email.
3. Confirm your email when Meta asks.
4. Optional: add colleagues in the Business Manager's settings. Give full control only to people who need admin rights.

## Connect the number

{% stepper %}
{% step %}

### Start the connection in Yazi

Every new organisation starts on Yazi's shared number. To connect your own, start the upgrade from Yazi: in a sandbox organisation, clicking any locked control takes you to the upgrade steps, which include connecting your number. If you cannot find the starting point, ask Yazi support and we will start it with you.

Meta's window opens on top of Yazi. Sign in with Facebook if asked. Meta may ask for a one-time code before you go further.
{% endstep %}

{% step %}

### Choose your business portfolio

Select the Business Manager (business portfolio) that should own the number, or create a new one.
{% endstep %}

{% step %}

### Create or choose a WhatsApp Business Account

If your business does not have a WhatsApp Business Account yet, choose to create a new one. If it already has one that another provider (such as an agency or messaging company) manages, stop and talk to Yazi first: see [If someone else manages your WhatsApp Business Account](https://docs.askyazi.com/set-up-whatsapp/number-health-and-limits.md#if-someone-else-manages-your-whatsapp-business-account).
{% endstep %}

{% step %}

### Enter your business profile

* **WhatsApp Business Account name:** for your own reference.
* **Display name:** the name participants see. It must clearly relate to your real business name, or Meta will reject it. For research, "\[Your company] Research" works well. See Meta's [display name guidelines](https://www.facebook.com/business/help/757569725593362).
* **Category** and, optionally, a **website** and description.
  {% endstep %}

{% step %}

### Add and verify your phone number

Enter the number with the correct country code. Choose to receive the code by SMS or phone call, then type it in.

If Meta rejects a code, wait a minute and request a new one. If it keeps happening, stop and contact Yazi support rather than retrying many times.
{% endstep %}

{% step %}

### Confirm Yazi as your technology partner

Meta shows the permissions Yazi needs to send and receive messages on your number. Review them and confirm.
{% endstep %}

{% step %}

### Finish and return to Yazi

Complete the remaining screens. Meta's window closes and you are back in Yazi. Once Yazi has finished setting up your number, the **WhatsApp Number Quality** widget at the bottom of the left navigation shows it.

<figure><img src="https://358667285-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzMRQUXiGQlBwWdg6WEmG%2Fuploads%2Fi6K1X20IW7Fmyx89YYGu%2Fwhatsapp-quality-widget.webp?alt=media&amp;token=8fb825e2-d674-476a-bd45-ccb34ca6dbd9" alt="The WhatsApp Number Quality widget at the bottom of the left-hand menu, showing the number&#x27;s quality as Green"><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

## What happens next

| Step                            | Who  | What to do                                                                                                                                                                          |
| ------------------------------- | ---- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Back-end setup                  | Yazi | Yazi finishes configuring your number. Links for studies you already created move to your number automatically.                                                                     |
| Display name review             | Meta | Meta reviews your display name before it shows to participants.                                                                                                                     |
| Payment method                  | You  | Add a card in Meta so messages keep sending. [Add a payment method](https://docs.askyazi.com/set-up-whatsapp/add-a-payment-method-in-meta.md)                                       |
| Business verification           | You  | Needed to send at volume and to use WhatsApp Flows. [Business verification](https://docs.askyazi.com/set-up-whatsapp/business-verification.md)                                      |
| Profile picture and description | You  | Set them in Meta's WhatsApp Manager. [WhatsApp profile and branding](https://docs.askyazi.com/set-up-whatsapp/whatsapp-profile-and-branding.md)                                     |
| Templates                       | You  | Create your invite and reminder templates on the new number and wait for Meta's approval. [Broadcast templates](https://docs.askyazi.com/reach-participants/broadcast-templates.md) |

If you gave Yazi temporary admin access to your Business Manager to help with setup, remove it once setup is complete.

Keep building and testing on the shared number while you wait. Nothing you build is lost.

## Limits and things to know

* **Templates do not carry over** from the shared number or from a previous number. Create them again on your new number.
* **A number can only be on one WhatsApp account.** If the number is still on personal WhatsApp or the WhatsApp Business app, Meta will refuse it.
* **Mobile numbers only.** Meta verifies by SMS or call, so landlines and switchboards do not work.
* **Your sending limit starts low.** A new, unverified number can only start a limited number of conversations a day (often 250). Verify your business before a large send. [Number health and limits](https://docs.askyazi.com/set-up-whatsapp/number-health-and-limits.md)
* **Moving a number later** to a different Business Manager needs the SIM to receive a new code.
* **If the sign-up window will not work for you**, for example because your IT policy requires your own Meta app, Yazi can connect your number using the manual developer-portal method instead. [Developer-portal method](https://docs.askyazi.com/set-up-whatsapp/developer-portal-method-advanced.md)

## Related

* [WhatsApp number options](https://docs.askyazi.com/set-up-whatsapp/whatsapp-number-options.md)
* [Business verification](https://docs.askyazi.com/set-up-whatsapp/business-verification.md)
* [Add a payment method in Meta](https://docs.askyazi.com/set-up-whatsapp/add-a-payment-method-in-meta.md)
* [WhatsApp profile and branding](https://docs.askyazi.com/set-up-whatsapp/whatsapp-profile-and-branding.md)
