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.

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?

• Yes. If your number is currently used in the WhatsApp Business App, you may be able to onboard it to the Cloud API without deleting the app account. Read more about Coexistence onboarding in Meta documentation.

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:

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, follow Meta’s Coexistence onboarding.
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/voice calls and isn’t blocked by an active registration path that Meta doesn’t allow to coexist. If the number is used in the Business App, try onboarding via Coexistence.

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.

The alert clears automatically once a reply sends successfully again.

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.

If we connect via coexistence, can we disconnect later?

• Yes, at any time. From inside the WhatsApp Business App, go to Settings → Account → Business Platform → Disconnect.
• The number stays live on the Business App, and your contacts and existing chat history are unaffected.
• Quickchat AI’s API access ends immediately.
• You can also pause integration without disconnecting by simply stopping outbound messages from Quickchat AI.

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: