> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usefini.com/llms.txt
> Use this file to discover all available pages before exploring further.

# WhatsApp

> Connect WhatsApp business numbers, assign an agent to each number, and configure response delay and Reply Rules.

Connect WhatsApp from **Deploy** to let Fini answer customer messages sent to your business numbers. Each saved number has its own agent routing and response delay; [Reply Rules](https://docs.usefini.com/en/automations/reply-behavior.md) control when the agent responds.

## Connect a number

**1. Start the connection**

Click **Connect** on the WhatsApp card. If you already have saved numbers, click **Open WhatsApp** to manage them and add another number.

**2. Authorize in Meta**

Follow the Meta signup flow to select a WhatsApp business account and number. In the connection dialog, use **Continue to Meta** when prompted.

**3. Choose the agent**

Open the saved number's **Bot Routing** section and select its bot. A connected number with **No bot selected** does not enable AI replies.

**4. Set the delay and save**

Under **Reply Settings**, set **Reply lag** in seconds. The default is 0. Click **Save Changes** to save both routing and delay.

**5. Review when to respond**

Click **Go to Reply Behavior Settings** and configure the agent's Reply Rules for WhatsApp.

You can connect multiple numbers and assign a different agent to each. Removing the selected bot and saving pauses AI replies while keeping the number connected. Disconnecting the number is a separate action.

## Reply limits

Replies use WhatsApp's customer reply window. Fini checks the window again before sending, and text replies must contain 1–4096 characters. This setup is for responding to inbound customer messages; it is not an outbound campaign or message-template sender.

If a send has an uncertain outcome, Fini does not automatically resend it, to avoid duplicate customer messages. Check the conversation in WhatsApp and [Inbox](https://docs.usefini.com/en/testing/inbox.md) before taking further action.

## Verify the setup

Send a test customer message to the connected number. Confirm the number has an agent, its connection setup is complete, the conversation appears in Inbox, and the expected reply arrives after the configured delay. Review AI Steps if a Reply Rule suppresses the answer.

## Why WhatsApp isn't working

> **The number is saved but no agent replies**
>
> Select an available bot under **Bot Routing** and click **Save Changes**. Check Reply Rules and confirm the customer reply window is still open.

> **The number says Setup incomplete**
>
> Click **Retry setup** to complete the webhook subscription, then test a new customer message.

> **The number says Reconnect required or Disconnected**
>
> Click **Reconnect number** and complete the Meta authorization flow. Verify the saved agent and delay after reconnecting.

> **The previously selected bot is unavailable**
>
> Choose an agent that is available in the current workspace before saving the number's settings.


## Related topics

- [Channel overview](https://docs.usefini.com/en/deploy/overview.md)
- [What is Fini](https://docs.usefini.com/en/what-is-fini.md)
- [Front](https://docs.usefini.com/en/deploy/front.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.