> ## Documentation Index > Fetch the complete documentation index at: https://docs.weav.com/llms.txt > Use this file to discover all available pages before exploring further. # WhatsApp Whats App Connect a WhatsApp Business phone number to Weav so your AI agent can answer customer questions on WhatsApp automatically, with conversations appearing in your unified inbox alongside chat and email. Use it to: * Let customers start a conversation with your business on WhatsApp * Have your AI agent answer WhatsApp messages using your training data * Escalate WhatsApp conversations to a teammate when a customer asks for a person * Keep a full WhatsApp conversation history next to your chat and email conversations * Add internal notes on WhatsApp conversations so your team can collaborate behind the scenes WhatsApp is available on all Weav plans. *** ## Before you start You will need: * Admin access in Weav * At least one active AI agent in your workspace * A Meta Business Manager account * A WhatsApp Business phone number, or a phone number that isn't currently active in the regular WhatsApp Business app * Access to that phone number to receive a verification code by SMS or voice call Connecting WhatsApp uses Meta's Embedded Signup flow, so parts of the setup (such as verifying your business with Meta) happen inside a Meta popup rather than inside Weav. Depending on your Meta Business Manager account, Meta may ask you to complete business verification before your number can send messages. If your phone number is currently active in the regular WhatsApp Business app on a phone, you'll need to migrate it to the WhatsApp Business Platform (Cloud API) as part of the Meta setup flow, or use a different number. Meta only allows a number to be connected to one WhatsApp product at a time. *** ## Connect WhatsApp Whatsapp Connection Path: Settings -> Integrations -> WhatsApp 1. Open Settings. 2. Go to Integrations. 3. Select WhatsApp. 4. Click **Connect WhatsApp**. 5. Complete Meta's Embedded Signup flow in the popup window: sign in to your Meta Business Manager account, and either select an existing WhatsApp Business Account and phone number or create new ones. 6. Once the popup closes, return to Weav. Weav validates the connection with Meta, subscribes to your WhatsApp Business Account so messages can flow into your inbox, and sets the connection status to **Active**. Weav handles the Meta webhook configuration for you. You will never need to paste a webhook URL, API key, or access token into Weav. *** ## Register your phone number Some phone numbers need to be registered with Meta's Cloud API before Weav can send outbound WhatsApp messages. If this step is needed, Weav will show a **Phone registration** prompt on the WhatsApp integration page after you connect. 1. Open Settings -> Integrations -> WhatsApp. 2. Find the **Phone registration** section. 3. If this number already has two-step verification enabled in WhatsApp Manager, enter its existing 6-digit PIN. Otherwise, leave the PIN field blank. 4. Click **Register phone number**. Inbound WhatsApp messages still arrive in your inbox while registration is pending. Outbound replies (including AI-generated ones) are blocked until the number is registered. *** ## Assign an agent to WhatsApp WhatsApp is a workspace-level channel, and one AI agent is assigned to handle it at a time. 1. Open the agent you want to handle WhatsApp conversations. 2. Go to its **WhatsApp** tab. 3. Click **Assign to WhatsApp**. If another agent is already assigned to WhatsApp, assigning a new agent will take over all future WhatsApp conversations. The previously assigned agent will no longer respond on WhatsApp. If no agent is assigned yet, WhatsApp conversations will still appear in your inbox, but they will need a teammate to reply manually until an agent is assigned. *** ## Configure agent behavior Whatsapp Options On the agent's **WhatsApp** tab, you can set: * **Welcome message** — the first message this agent sends when it starts a new WhatsApp conversation. * **Escalation assignee** — the teammate WhatsApp conversations are assigned to when a customer asks to speak with a person. *** ## How WhatsApp conversations work * WhatsApp conversations appear in your unified inbox alongside chat and email, with their own channel indicator. * Your assigned AI agent answers using your training data, the same way it does on chat and email. * Meta only allows outbound WhatsApp messages within a **24-hour customer service window**, starting from the customer's most recent message. Once that window closes, you and your AI agent can no longer send a reply until the customer messages again, but you can still add **internal notes** to keep track of the conversation internally. * Customers can ask to speak with a person at any time, which hands the conversation to the escalation assignee configured on the agent's WhatsApp tab. If you regularly need to reach customers outside the 24-hour window, plan to follow up the next time they message you, or reach them through another channel such as email. *** ## Manage the connection Path: Settings -> Integrations -> WhatsApp * **Check health** — verifies the connection is still valid with Meta and refreshes its status. * **Pause** — temporarily stops sending and receiving WhatsApp messages without disconnecting your number. Use this if you need to pause support without losing your setup. * **Resume** — turns a paused connection back on. * **Disconnect** — removes the WhatsApp connection from Weav entirely. You'll need to complete Embedded Signup again to reconnect. *** ## Good to know * Only one AI agent can be assigned to WhatsApp per workspace at a time. * Weav does not currently support Meta message templates, so all outbound messages are regular freeform replies sent within the 24-hour window. * WhatsApp is available on all Weav plans at no extra cost. *** ## Troubleshooting ### I can't finish connecting WhatsApp Check that: * You're signed in to Weav with admin access. * You completed the Meta popup fully, closing it early cancels the connection. * Your Meta Business Manager account has permission to manage the WhatsApp Business Account and phone number you selected. * Your phone number isn't already active in the regular WhatsApp Business app. If it is, migrate it to the WhatsApp Business Platform in Meta's flow, or choose a different number. ### The connection shows "Setup incomplete" or "Error" Click **Check health** on the WhatsApp integration page to refresh the connection status and see the latest detail message. If the issue persists, try disconnecting and reconnecting through Embedded Signup. ### Outbound messages aren't sending Check that: * Your phone number is registered with Meta (see **Register your phone number** above). * The conversation's 24-hour reply window hasn't expired. If it has, you can still add an internal note, but you'll need to wait for the customer to message again before replying. * The WhatsApp connection status is **Active**, not **Paused**. ### The wrong agent is responding on WhatsApp Go to the agent that should handle WhatsApp and click **Assign to WhatsApp** on its WhatsApp tab. Assigning a new agent immediately takes over future WhatsApp conversations. ### I registered my phone number but it still won't send messages Double-check the PIN you entered matches the existing two-step verification PIN configured in Meta's WhatsApp Manager. If this number has never had two-step verification enabled, leave the PIN field blank and try again. ### Customers say messages aren't reaching my inbox Check that: * The WhatsApp connection status is **Active**, not **Paused** or **Disconnected**. * You didn't recently disconnect and forget to reconnect Weav in Meta Business Manager. Run **Check health** to confirm Weav can still reach Meta's API for your number.