---
title: "Connecting WhatsApp — Yims.ai"
url: "https://yims.ai/docs/channels/whatsapp"
description: "How to connect WhatsApp to Yims.ai from the setup wizard, what verification and display-name approval involve, and what disconnecting does and does not affect."
---

Owner guide

# Connecting WhatsApp

WhatsApp is connected from the setup wizard through WhatsApp's own guided signup. You either bring a number you already control or take a number WhatsApp provides — both end in the same connected state, but they fail in different ways, and the setup receipt states which situation applies.

01

## Before you connect

WhatsApp is connected from the setup wizard, or later from the dashboard's channel settings, through WhatsApp's own guided signup. In that signup you set up a **WhatsApp Business portfolio**, activate your business number and link it to your business.

The connect screen first asks for an optional personal number: the one _you_ will use to manage the business. It becomes the business admin automatically and is not the number customers write to.

02

## Choosing the button and the number

The screen shows up to two buttons. Use the one that matches your number.

-   **Connect your WhatsApp Business number**: for the number you already use in the WhatsApp Business app (not consumer WhatsApp). You keep the app on your phone and the assistant works beside it on the same number; replies you type by hand are recognised and not repeated. Keep the phone at hand, because WhatsApp asks you to confirm from it. This button appears only where that route is available.
-   **Connect a new WhatsApp Business number**, with a number of your own that is not on WhatsApp yet. It is verified by SMS or voice call and handled only by the assistant, with no WhatsApp app on your phone for it.
-   **Connect a new WhatsApp Business number**, with a virtual number from WhatsApp. No SIM is needed, but it is offered only for some countries and accounts, so do not plan on it. Approval and activation can take up to 24 hours.

A number that is not already an active WhatsApp Business app number is refused behind the first button, with a message to use the new-number button. Nothing is lost: start again with the other button. A number already connected to another WhatsApp API provider cannot be connected by you alone; contact support.

03

## If you want voice calls

Only the second kind of number can take AI voice calls: a number your business owns, connected with the new-number button for the assistant alone. A number shared with the WhatsApp Business app keeps ringing on your phone, and a virtual number cannot take calls. Meta must also have verified your business, and your plan must include call minutes.

04

## Bringing your own number

A number you bring must be verified by SMS or voice call during signup. If you don't finish verifying, the connection is still kept and completes on its own once you do — there is no need to return to the wizard.

If the number already has two-step verification switched on with a PIN that wasn't set through Yims.ai, the connection cannot complete. Turn two-step verification off for that number in WhatsApp Manager, then connect again — retrying without that change fails the same way every time.

05

## Getting a number from WhatsApp

A number WhatsApp provides is created asynchronously and can take up to twenty-four hours to appear. Nothing is required from you while that happens; the business is messaged as soon as the number is live.

06

## Display-name approval

A connected number cannot send any message until WhatsApp approves its display name — a review by WhatsApp, not a setting Yims.ai controls. While approval is pending the number receives messages normally but every reply is rejected, so customers can appear to be ignored and the dashboard link can't be delivered.

No action is needed. Approval usually lands within a day, and the business is messaged once it does, with a fresh dashboard link for admin owners in that same message. Waiting on approval and need access sooner? Connect your own verified number instead — it skips the display-name review.

07

## Admin access and disconnecting

The phone number given during signup is registered as the business admin automatically. Anyone added afterwards joins as staff through an invitation rather than by repeating signup.

Disconnecting from the dashboard stops message delivery to Yims.ai only. It does not affect your WhatsApp Business account, the number's registration, or your use of that number in the WhatsApp Business app or any other tool. Reconnecting from the dashboard needs no repeat of verification.

Never send access tokens, app secrets, or any other provider credential to product support.

## Other guides

[All guides](/docs/)

Get started

## Give every customer your concierge.

Give customers one reliable place to ask, book, buy and reach your team on the messaging channels they already use.

[Set up your place - 30 days FREE!Beta](https://app.yims.ai/onboarding)