Skip to main content
Heyy connects to WhatsApp through Meta, giving you a single Inbox for conversations alongside Instagram, Messenger, Live Chat, and SMS. There are two connection methods — pick one before you start, since they have different tradeoffs and are not simple to switch between later.
Choosing a WhatsApp connection method

​
Choose a method

If you’re not sure which to pick, choose Cloud API. It’s more stable, and it’s what most growing teams end up on eventually — Coexistence exists specifically for the transition period before that.

​
Before you start (both methods)

  • A Meta Business Portfolio with the Business Info section fully completed. Incomplete Business Info is the single most common reason a connection fails partway through.
  • A phone number that can receive an SMS or voice call for verification.

​
Connect with Cloud API

The number you connect cannot be active on the WhatsApp mobile app (Standard or Business) once the connection completes. If you’re currently using this number on your phone, back up your chat history there first — you will not be able to use it in the app afterward.
  1. Go to Settings → Channels → Add Channel.
  2. Select WhatsApp.
  3. Click Connect Number.
  4. In Meta’s flow, select Create a WhatsApp Business account.
  5. Complete the remaining steps: portfolio selection, business details, and number addition/verification.
Meta Cloud API connection flow
When adding a number, Meta gives you two options:

​
Connect with Coexistence

“Don’t share chats” may lead to connection errors if skipped or answered incorrectly. When Meta’s flow asks whether to share existing chats, select Don’t share chats — sharing chats at this step is a common cause of a broken connection.
Requirements specific to Coexistence:
  • WhatsApp Business App version 2.24.17 or higher.
  • The app must not already be connected to any other Business Platform integration.
  • Your Meta Business Portfolio’s Business Info must be complete.
  • Your WhatsApp display name should match your business Portfolio name, or contain it.
If your Business App is already connected to another platform, disconnect it first: Then connect to Heyy:
  1. Go to Settings → Channels → Add Channel.
  2. Select WhatsApp, then click Connect Number.
  3. Select Connect a WhatsApp Business App.
  4. Enter the phone number associated with your Business App.
  5. Scan the QR code, or enter the pairing code inside the Business App.
  6. When prompted, select Don’t share chats.
  7. Complete the remaining steps in the flow.
Coexistence QR pairing flow

​
After connecting

Once connected, configure your public-facing profile — see Guides — and set up your message template library before relying on WhatsApp for outbound or re-engagement messages.
Disconnecting or deleting a WhatsApp channel is irreversible. Heyy will no longer send or receive messages for that number. Export or back up anything you need first.

​
What WhatsApp is good for