> ## Documentation Index > Fetch the complete documentation index at: https://docs.bevits.com/llms.txt > Use this file to discover all available pages before exploring further. # WhatsApp coexistence > Connect a number that already uses the WhatsApp Business App and add more numbers to the same account. ## How do I connect a WhatsApp Business App number? With coexistence, the number stays active in the WhatsApp Business App and also sends and receives messages through Meta's official API. Use this flow when the number is already in the app and you don't want to lose the chat history or the conversations you handle on the phone. For a new number that isn't on WhatsApp, use the **Cloud API** card. The manual connection, with token and IDs, is in [Official WhatsApp](https://docs.bevits.com/en/send-methods/official-whatsapp.md). ### Requirements * You need to be an **owner** or **administrator** of the Bevits account, with the integrations permission. * A phone with the **WhatsApp Business App** installed and the number active on it. Keep the device at hand: pairing needs a QR code scanned in the app. * Access to the Meta account that manages the company's **business portfolio**. * Pop-ups allowed in the browser. > [!TIP] > > If the account already has two connected numbers, check the portfolio limit in > the **Connect more numbers** section before you start. ## Step by step **1. Open the WhatsApp settings** In Bevits, click your email in the bottom-left corner and go to **Settings** → **WhatsApp** → **Official API** → **Configure**. **2. Choose the Coexistence card** Under **New connection**, click **Connect with Coexistence**. ![Official WhatsApp screen with the Coexistence card highlighted](https://bucket.bevits.com/docs/whatsapp-coexistencia/passo-2-card-coexistencia.png) **3. Sign in with the Meta account** Sign in with the Meta account that manages the business portfolio. Choose the same portfolio as the other numbers. If Meta asks for the WhatsApp Business Account (WABA), use the same one or create a new one: both work in Bevits. **4. Enter the phone number** Type the number that is active in the WhatsApp Business App, with country and area codes. ![Meta window asking for the phone number](https://bucket.bevits.com/docs/whatsapp-coexistencia/passo-4-numero.png) Check that the profile shown belongs to the right company. Meta reads the profile from the app. > [!NOTE] > > The order of the screens can vary. If Meta asks for the number before the > portfolio, enter it and continue: the flow is the same. **5. Pair the phone** Pairing happens on two screens: Meta's window on the computer and **WhatsApp Business** on the phone. In Meta's window, pairing starts with the QR code: ![Meta window with the QR code and the phone instructions](https://bucket.bevits.com/docs/whatsapp-coexistencia/passo-5-qr.png) On the phone, open **WhatsApp Business** and tap the message from the official Facebook Business account. Tap **Connect** and follow the instructions until the app opens the camera. Point it at the QR code. If the camera fails or if the window is open on the phone itself, click **Use an access code instead**: ![Meta window with the verification code and the Copy button](https://bucket.bevits.com/docs/whatsapp-coexistencia/passo-5-codigo-acesso.png) Copy the verification code shown in the window and paste it in the app, in the field that asks for the access code. During pairing, the app asks whether you want to share the chat history. Allow it: this is what brings the account contacts and history to the official API. If the QR code expires, close the window and repeat step 2. **6. Finish and check the connection** When pairing ends, the number appears under **Official connections**. Click **Templates** to sync the WABA templates. > [!NOTE] > > The first connected number becomes the **default**. To change it, click > **Make default** on the number that should send the campaigns. ## Connect more numbers Bevits doesn't limit how many official numbers an account can have. Repeat the steps for each new number. The limit belongs to Meta and applies to the **business portfolio**: ![Unverified portfolio holds 2 numbers; verified holds up to 20](https://bucket.bevits.com/docs/whatsapp-coexistencia/limite-portfolio.png) * **Unverified portfolio:** 2 registered numbers, counting all WhatsApp Business accounts in the portfolio. * **Verified portfolio:** up to 20 numbers. If the third number shows as **Pending** or **Failed** in WhatsApp Manager, verify the business in Meta Business Suite. Verification unlocks the higher limit. Each coexistence number needs a phone with the app active. Open WhatsApp Business on each device at least once every 13 days to keep the connection. ## What doesn't work * **Using Bevits' Meta account or another company's account.** The portfolio must belong to your company. Outside accounts can get the portfolio blocked. * **Connecting a number that is already on the official API.** Coexistence only works for a number that is in the WhatsApp Business App. * **Using a number from regular WhatsApp.** Coexistence requires the WhatsApp Business App. Register the number in the app first; it stops working in regular WhatsApp. * **Keeping the blue badge (OBA).** Coexistence doesn't support the official account badge. Use Meta Verified for Business. ## Common issues | Symptom | What to do | | - | - | | The number stays **Pending** or **Failed** in WhatsApp Manager | The portfolio reached the 2-number limit. Verify the business in Meta Business Suite. | | Meta's window doesn't open | Allow pop-ups in the browser and click **Connect with Coexistence** again. | | The QR code doesn't scan | Use the access code: copy the code from the window and paste it in the app. | | The QR code expires before you scan it | Close the window and repeat step 2. The code only works for that session. | | Meta says the number is already on the API | That number can't use coexistence. Use another number. | | I can't find **Settings** → **WhatsApp** → **Official API** | Ask an owner or administrator with the integrations permission to grant access. | | The connection dropped after a few days | Open WhatsApp Business on the phone. The app needs to be used at least once every 13 days. | For questions about the connection, email us at **[hey@bevits.com](mailto:hey@bevits.com)** or use the support chat in the platform. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.