> ## Documentation Index
> Fetch the complete documentation index at: https://hilos-40.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect your number

In this guide we will connect your phone number to Hilos so you can start leveling up your company's WhatsApp. This will take roughly 5 minutes.

To follow along with this guide, go to [Hilos > Settings > WhatsApp Accounts > Start now > Connect your phone number (Recommended)](https://app.hilos.io/config/channel/cloud-api/onboarding)

<Steps>
  <Step title="Select the phone number origin">
    There are 3 options to choose from:

    <AccordionGroup>
      <Accordion title="Use a new number">
        When the number you're configuring hasn't been used before in WhatsApp, WhatsApp Business or WhatsApp Business API. This is by far the easiest option to choose as you won't need to do any additional steps.
      </Accordion>

      <Accordion title="Migrate a number in use on the WhatsApp Business App">
        When you want to migrate a number that is currently being used in the WhatsApp Business App. Bear in mind that WhatsApp Business API and WhatsApp Business App are different platforms that can't be used simultaneously, you'll need to delete your WhatsApp Account to continue, once you've done this, you'll be able to migrate your number. To delete your WhatsApp Account follow this guide, once you've deleted your account wait 5 minutes before continuing to follow this guide as Facebook takes a while to update their systems.
      </Accordion>

      <Accordion title="Migrate from another BSP">
        When you want to migrate a number that is currently being used in another Business Solution Provider (BSP) to Hilos. You'll need to have the necessary permissions to do this and ask your current BSP to disable 2FA (Two-Factor Authentication) to continue.

        <Accordion title="How to disable your number's 2FA">
          If you come from another BSP or your number was already connected to WhatsApp Business API, you'll need to disable 2FA (Two-Factor Authentication) to continue. Depending on the BSP sometimes you'll need to ask support to do this or you may do it yourself by going into your [WhatsApp Business Manager](https://business.facebook.com/wa/manage/phone-numbers) and clicking the ⚙️ next to the phone number you're migrating, here you'll need to go to the Two-Factor authentication tab and clic on Disable 2FA.

          ![Disable 2FA](https://hilos-media.s3.us-east-2.amazonaws.com/mintlify/getting-started/connecting-to-hilos/connect-number/2FA-1.jpeg)
          ![Disable 2FA](https://hilos-media.s3.us-east-2.amazonaws.com/mintlify/getting-started/connecting-to-hilos/connect-number/2FA-2.png)
        </Accordion>

        Also, before finishing the onboarding process you'll need to keep the onboarding window open until you've finished adding a payment method to your WhatsApp account.
      </Accordion>
    </AccordionGroup>

    ![Select the phone number origin](https://hilos-media.s3.us-east-2.amazonaws.com/mintlify/getting-started/connecting-to-hilos/connect-number/number-source.png)
  </Step>

  <Step title="Confirm you own a Business Manager & website">
    To continue, you'll need to confirm that you own a Business Manager account and a website. If you don't have a Business Manager account, you can create one [here](https://business.facebook.com/). Websites are needed so that Facebook can verify your business is real, if you don't have one your number might get blocked.
    ![Confirm you own a Business Manager & website](https://hilos-media.s3.us-east-2.amazonaws.com/mintlify/getting-started/connecting-to-hilos/connect-number/number-prerequisites.png)
  </Step>

  <Step title="Login with Meta">
    Now we're all set, click on Login with meta to begin the onboarding process. When prompted, authorize Hilos to access your Facebook account to begin the process.
  </Step>

  <Step title="Authorize Hilos to interact with your business">
    ![Authorize Hilos](https://hilos-media.s3.us-east-2.amazonaws.com/mintlify/getting-started/connecting-to-hilos/connect-number/onboarding-1.png)
    ![Authorize Hilos](https://hilos-media.s3.us-east-2.amazonaws.com/mintlify/getting-started/connecting-to-hilos/connect-number/onboarding-2.png)
  </Step>

  <Step title="Fill your business information">
    ![Fill your business information](https://hilos-media.s3.us-east-2.amazonaws.com/mintlify/getting-started/connecting-to-hilos/connect-number/onboarding-3.png)
  </Step>

  <Step title="Create a new WhatsApp Account">
    ![Create a new WhatsApp Account](https://hilos-media.s3.us-east-2.amazonaws.com/mintlify/getting-started/connecting-to-hilos/connect-number/onboarding-4.png)
  </Step>

  <Step title="Add your WhatsApp Profile details">
    ![Add your WhatsApp Profile details](https://hilos-media.s3.us-east-2.amazonaws.com/mintlify/getting-started/connecting-to-hilos/connect-number/onboarding-5.png)
  </Step>

  <Step title="Verify your phone number via Phone call or SMS">
    ![Verify your phone number](https://hilos-media.s3.us-east-2.amazonaws.com/mintlify/getting-started/connecting-to-hilos/connect-number/onboarding-6.png)
  </Step>

  <Step title="Wait a while and you're set">
    <Warning>
      If you're migrating from another BSP do not click on the Finish button until you've added a payment method to your account (check details below).

      <Accordion title="Adding a payment method">
        If your previous BSP offered a credit line for you you'll need to add a payment method where you'll be billed for your WhatsApp template usage before you finish the onboarding process. To do this go to your [Business Manager WhatsApp Accounts](https://business.facebook.com/latest/settings/whatsapp_account) and click on the newly created WhatsApp Account (You can identify it on the partners tab, you'll see Hilos as the partner associated to that number) here click on Payment settings to add a card to your account.

        ![Payment settings](https://hilos-media.s3.us-east-2.amazonaws.com/mintlify/getting-started/connecting-to-hilos/connect-number/payment-settings.jpeg)
      </Accordion>
    </Warning>

    ![Wait for your account to be ready](https://hilos-media.s3.us-east-2.amazonaws.com/mintlify/getting-started/connecting-to-hilos/connect-number/onboarding-7.png)
    ![You're ready](https://hilos-media.s3.us-east-2.amazonaws.com/mintlify/getting-started/connecting-to-hilos/connect-number/onboarding-8.png)
  </Step>
</Steps>
