WhatsApp

This guide shows how to integrate your Quickchat AI Agent with WhatsApp. The process is divided into 2 simple steps:

• Step 0 - Prerequisites
• Step 1 - Connect WhatsApp

If you have problems with integration or need help, go to Troubleshooting & FAQs section or contact us.

Optional setup tools

• Check WhatsApp setup prerequisites. Review declared number and provider details against the documented setup requirements. This does not access or connect a WhatsApp account.

• Check a WhatsApp service window. Check the 24-hour window from supplied inbound and reply timestamps with time-zone offsets. This does not verify templates, consent or account permissions, or send a message.

• Estimate usage costs. Calculate Quickchat AI model credits and a separate total for supplied fee lines. This does not look up provider rates, combine credits with money or check your account.

Watch the Video

Play

Step 0 - Prerequisites

A. Business Phone Number

Decide which phone number you’ll use for WhatsApp. You can read more in WhatsApp documentation or follow the FAQs below:

Which number can be used in WhatsApp Cloud API?

• You need to use a dedicated business phone number that can receive SMS or voice calls for verification.
• The number must be valid, owned by you, and have a country and area code.

Can I use a number that is already used in WhatsApp Messenger?

• No. You can continue using this number for calls and texts, but not in WhatsApp Messenger.
• If the number is already used in WhatsApp Messenger, delete it first. Don’t forget to back up your WhatsApp chat history.
• Banned numbers must be unbanned before registering.

Can I use a number that is already used by WhatsApp Business App?

• Quickchat AI’s current connection flow does not provide a verified Coexistence path for an existing WhatsApp Business App number. Meta describes how coexistence works in supported integrations in its Business App onboarding guide.
• If you need to keep your existing number, Business App account, and chat history, email support@quickchat.ai before proceeding. Do not delete or disconnect the Business App account, or migrate the number, as a troubleshooting step.

Can I use a new phone number?

• Yes, if you prefer not to use your current number, get a new number (physical SIM or virtual number). You can buy a virtual phone number from services such as Hushed.

B. Business Information

Have these details ready (you’ll enter them during the Meta integration flow):

• Business name
• Business website
• Business category
• Business description

Caution

Even if some fields seem optional, fill them accurately. Missing or inaccurate info can delay approval or cause account restrictions.

Step 1 — Connect WhatsApp

Open the Quickchat AI App → External Apps → WhatsApp → click the Connect WhatsApp button and follow the Meta pop-up:

You can also start from ChatGPT, Claude or another connected AI app: ask for a link to connect this Agent to WhatsApp. The link is valid for 10 minutes and works once, only for the Quickchat account that requested it. Open it in a browser signed in to that account, follow Meta’s setup, and finish any account or phone selection when Quickchat reopens. Then ask your AI app to check the setup and send a real WhatsApp message to confirm that the AI reply arrives. Test each active number if you connect more than one. You approve Meta access in the browser, without sharing tokens in the chat.

1. Log in to your Meta (Facebook) account.
2. Review the permissions you’ll share with Quickchat AI (WhatsApp Business account access and Business portfolio access) and continue.
3. Provide accurate business details (Business Portfolio, Business Name, Business Website, Country, etc.).
4. Create or select your WhatsApp Business Account.
5. Choose a WhatsApp Business display name and category.
6. Add your business phone number and verify it via SMS/voice as prompted.
7. Click Confirm to give Quickchat AI required access.
8. When Meta confirms the setup is complete, click Finish. The pop-up shows a Quickchat AI confirmation that your WhatsApp account has been connected and closes automatically.

If Meta grants Quickchat AI access to more than one account, the WhatsApp panel shows Choose your WhatsApp Business Account instead of connecting immediately. Pick the account your AI Agent should answer on and click Use this account. If you are reconnecting, your current WhatsApp setup stays unchanged until you confirm.

Back in the Quickchat AI App, the WhatsApp panel shows Finish setup until a successful exchange is verified on your own business number. If the panel has not updated after about 30 seconds, click the refresh icon.

Connection to Meta and receiving a message are only part of setup. The panel shows the next step for each enabled number:

• Waiting for your first message: send a WhatsApp message to the number shown from another phone, then click Refresh. Make sure you message the business number your customers will use.
• Waiting for the AI reply to be delivered: Quickchat received your message, but WhatsApp has not yet confirmed delivery of the AI reply. Check whether the reply arrived on the other phone. If it did not, check your AI credits and any warnings in the panel, then send another test message.
• AI reply delivered: WhatsApp confirmed that the AI reply to an incoming message was delivered on this business number.
• Verification needs attention: resolve the connection warnings, keep the intended number enabled, and send a new test message.
• Display name: every number listed lower in the panel carries its display-name status from Meta (Approved, Pending review, Declined, Expired or No display name). A review in progress needs nothing from you and usually finishes within a few days. A declined, expired or missing display name asks you to submit one in WhatsApp Manager.
• Meta test number: Meta-provided +1 555 numbers and sandbox numbers do not verify activation on your business number. Add your own number in WhatsApp Manager, enable it in Quickchat, then test that number.

The panel shows Live when every enabled business number has a verified exchange and the connection checks are healthy. If you enable several business numbers, test each one. A successful test-number exchange, a sent template, or a message-allowance notice does not complete this check.

Tip

Keep the integration enabled while you test. Send a message from another phone to each intended business number, confirm that the AI reply arrives, and click Refresh. The conversation should also appear in the Quickchat AI App Inbox. An existing connection may ask for a new test exchange to verify delivery; it can continue receiving and replying to messages while you complete this step.

If Meta has remaining onboarding steps, complete them in Setup guidance in WhatsApp Manager. Quickchat AI also emails the account owner a reminder when Meta’s setup steps remain unfinished.

Troubleshooting & FAQs

How WhatsApp Business API Pricing Works?

• Replies to user-initiated (inbound) customer inquiries are trated by WhatsApp as Service messages. These messages enable businesses to manage incoming customer inquiries, whether that is via a human agent or a conversational AI-powered bot.
• When users message a business, this opens a 24-hour customer service window during which businesses can respond with service messages, at no charge. This window resets with each user message.
• Outside 24 hours, you must use approved Message Templates (Marketing, Utility, Authentication, etc.) and pay per-message according to WhatsApp Business Platform Message Rates.
• Conversations are categorized and billed by Meta. Ensure your WhatsApp Business Account has a valid payment method for business‑initiated/template messages.

The Connect WhatsApp button does not work. I don’t see the Meta pop-up.

• If your browser blocks the pop-up, allow pop-ups for the Quickchat AI App and click Try again. You can also click Continue on Meta in this tab to complete the same setup without a pop-up.

Quickchat couldn’t confirm the WhatsApp connection

Quickchat shows this recovery message when Meta’s window returns no result and Quickchat still cannot verify the connection. It does not prove that Meta made no changes.

1. Confirm that you are an Admin of the Meta Business that owns the WhatsApp Business Account. If not, ask an Admin to connect it from their Facebook login.
2. Click Try again. If a blocker interferes with Meta’s window, use a private window with extensions paused, or click Continue on Meta in this tab.
3. If the number is active in WhatsApp Messenger, remove it there first or use another number. If it is active in the WhatsApp Business App, stop here and email support@quickchat.ai before proceeding. Quickchat AI’s current connection flow does not provide a verified Coexistence path. Do not delete or disconnect the Business App account, or migrate the number, to troubleshoot this message.
4. If the WhatsApp Business Account uses Aircall, Twilio, 360dialog, MessageBird, or another provider, add Quickchat AI as a partner in Meta Business Settings:
   1. Open Meta Business Settings and go to Accounts → WhatsApp Accounts.
   2. Select the WhatsApp Business Account, open Partners, and click Add Partners.
   3. Enter Quickchat AI’s Business ID: 270696274483463.
   4. Grant Manage WhatsApp accounts, return to Quickchat AI, and refresh the status.

Disconnect the other provider only if Meta does not allow both partners on that account. If you are unsure, contact support before disconnecting a live messaging provider.

Number verification failed.

• Ensure the number can receive SMS or voice calls.
• A generic Ineligible message or This number can’t be shared with this app tooltip does not establish the cause or whether Meta’s coexistence requirements are met. Email support@quickchat.ai with the exact message and the step where it appeared.
• If the number is used in the WhatsApp Business App and you need to keep that account and its history, contact support before proceeding. Do not delete or disconnect the account, or migrate the number, to try to clear the error.

I connected the wrong account.

• Reconnect keeps the account that is already connected. To move the AI Agent to a different WhatsApp Business Account, click Disconnect in the WhatsApp panel, then Connect WhatsApp again and pick the correct Meta Business account and WhatsApp Account in Meta’s window.

We could not tell which WhatsApp Business Account to connect

• Your Meta login has several WhatsApp Business Accounts with phone numbers and Quickchat could not tell which one you meant. Email support@quickchat.ai with the phone number you want connected and we will finish the setup for you.

Messages aren’t appearing in the Quickchat AI Inbox.

• Confirm the pop-up showed the final confirmation message: “WhatsApp account connected!”.
• Double-check you linked the intended WhatsApp Account and the correct AI Agent is selected.
• The Waiting for your first message card names the number your AI Agent answers on. Make sure you messaged that exact number and that it is switched on in the panel, then click Refresh.
• If you’re sending messages after 24 hours without a user message, use approved templates and ensure a payment method is set in WhatsApp Manager.

My AI’s WhatsApp replies are failing to send.

If your AI’s replies can’t be delivered, Quickchat AI shows a “WhatsApp replies are failing” alert on the WhatsApp panel in External Apps and a notification on your dashboard. The most common causes and fixes:

• Display name not approved on a Meta test number: Meta holds replies from a Meta-provided +1 555 number until its display name is approved. The panel’s display-name alert turns red and names the number. Wait for the review to finish (usually a few days) or, if it was declined, submit a new display name in WhatsApp Manager, then send a test message. A display name still under review on your own number does not block replies on its own; the panel shows it as a note.
• Connection expired or revoked: your WhatsApp connection is no longer valid. Open the WhatsApp panel and click Reconnect to resume sending replies.
• Number restricted: Meta has limited your number over its quality rating or a policy issue. Check its status in WhatsApp Manager to restore sending.
• Business Account locked (error 131031): Meta has blocked replies from the WhatsApp Business Account. The Inbox delivery error and WhatsApp panel explain the restriction. Open Business Support Home, select the WhatsApp account, choose the violation and click Request Review: Meta lifts an account lock only through this review. Reconnecting Quickchat does not lift the restriction.

Other alerts clear automatically once a reply sends successfully again. An account-lock alert stays until a new real visitor message gets a fully delivered AI reply, because Meta can accept a reply and still fail it. If only Meta test numbers (+1 555) are active, the next successfully sent AI reply clears it. Support AI can also explain a recent stored account-lock failure, but historical evidence does not prove the account is still locked.

Template or business‑initiated messages fail.

• Verify your Message Templates are approved and your payment method is active in WhatsApp Manager.
• New senders start with messaging limits that scale based on quality and verification. If you hit limits for business‑initiated messaging, review Meta’s Messaging Limits guidance.
• Check messaging limits and quality rating in WhatsApp Manager if delivery is throttled.

How to create my own WhatsApp link and “Chat on WhatsApp” button?

• Follow this WhatsApp tutorial.
• Or download WhatsApp brand button designs and use one of these inline scripts:

<!-- WhatsApp inline button -->
<!-- Update WHATSAPP_PHONE_NUMBER and filename/path as needed -->
<a
  aria-label="Chat on WhatsApp"
  href="https://wa.me/WHATSAPP_PHONE_NUMBER"
  target="_blank"
  rel="noopener noreferrer"
>
  <img
    alt="Chat on WhatsApp"
    src="WhatsAppButtonGreenLarge.svg"
    style="
      width: 200px;
      height: auto;
      cursor: pointer;
      border-radius: 12px;
    "
  />
</a>

or

<!-- WhatsApp floating button -->
<!-- Update WHATSAPP_PHONE_NUMBER and filename/path as needed -->
<a
  aria-label="Chat on WhatsApp"
  href="https://wa.me/WHATSAPP_PHONE_NUMBER"
  target="_blank"
  rel="noopener noreferrer"
  style="position: fixed; right: 20px; bottom: 20px; z-index: 9999"
>
  <img
    alt="Chat on WhatsApp"
    src="WhatsAppButtonGreenLarge.svg"
    style="
      width: 200px;
      height: auto;
      cursor: pointer;
      border-radius: 12px;
      box-shadow: rgba(0, 0, 0, 0.5) 0px 5px 15px 0px;
      transition: all 0.3s ease;
    "
    onmouseover="this.style.transform = 'scale(1.05)'"
    onmouseout="this.style.transform = 'scale(1)'"
  />
</a>

How to create my own WhatsApp QR code?

• Visit WhatsApp Manager → Phone numbers → select your business phone number → Message links → Create Message Link.
• Alternatively you can find it in your WhatsApp Business mobile app. Follow this WhatsApp tutorial.

Should I disconnect my WhatsApp Business App account to fix setup?

• No. Do not delete or disconnect your Business App account, or migrate its number, as a troubleshooting step. Quickchat AI’s current connection flow does not provide a verified Coexistence path that preserves your existing app setup and history.
• Email support@quickchat.ai before changing a live Business App account. Meta’s Business App onboarding guide describes coexistence for supported integrations; it does not confirm availability for your Quickchat AI setup.

What access does Quickchat AI get to our WhatsApp Business Account?

• Scoped API access, not account ownership. Your WhatsApp Business Account (WABA) lives in your own Meta Business Manager — under Meta’s WABA Sharing model, you own the assets and Quickchat AI is added as a partner you can revoke at any time from Business Manager.
• We can send and receive messages through the Cloud API and receive message events via webhook while integration is active.
• We cannot close, transfer, or rebrand your account, change billing, or remove your administrators.

Need Help?

Chat with Quickchat’s Support AI on WhatsApp:
📱 +1 302-405-9992 — Start a chat

Or scan the QR code: