Skip to main content

Connecting WhatsApp

ReplyWolf supports two ways to connect a WhatsApp account. You can use one or both methods, and you can connect multiple accounts at the same time.

Connection Methods at a Glance​

QR Code LoginCloud API (Business) -- BETA
Best forPersonal WhatsAppWhatsApp Business API
SetupScan a QR codeEnter API credentials from Meta
Send text and mediaYesYes
Receive messagesYesYes (requires webhook setup)
Auto-reply flowsYesYes
Template messagesNoYes
Requires Meta Business accountNoYes

Method 1: QR Code Login​

This is the easiest way to get started. It connects your personal WhatsApp account by scanning a QR code, similar to WhatsApp Web.

Steps​

  1. Open the Messages page from the sidebar.
  2. In the accounts panel on the left, click the + button.
  3. In the Add Account dialog:
    • Enter a name for this account (for example, "My WhatsApp").
    • Set the Account Type to QR Code Login.
  4. Click Add Account.
  5. A QR code will appear on screen.

QR Code Login

  1. Open WhatsApp on your phone.
  2. Go to Settings > Linked Devices > Link a Device.
  3. Scan the QR code displayed in ReplyWolf.
  4. After a few seconds, the account will show as connected with a green dot.

What QR Code Login Supports​

  • Sending and receiving text messages
  • Sending and receiving media (images, videos, documents, audio)
  • Auto-reply flows and AI-powered automation
  • Contact lookup and WhatsApp number validation
  • Bulk campaigns with text messages

What QR Code Login Does Not Support​

  • Template messages (these require the Cloud API)

Method 2: Cloud API (Business) -- BETA​

The Cloud API connects through Meta's official WhatsApp Business API. This method is required if you want to send template messages (pre-approved message formats for marketing, utility, or authentication).

note

Cloud API support is currently in beta. Core features (sending/receiving messages, templates, media) work well, but you may encounter edge cases. Please report any issues.

Prerequisites​

Before setting up Cloud API in ReplyWolf, you need:

  • A Meta Business account with access to the WhatsApp Business API
  • An Access Token from the Meta developer dashboard
  • Your Phone Number ID from the WhatsApp Business API setup
  • Your WABA ID (WhatsApp Business Account ID) -- needed for template management

Steps​

  1. Open the Messages page from the sidebar.
  2. Click the + button in the accounts panel.
  3. In the Add Account dialog:
    • Enter a name for this account.
    • Set the Account Type to Cloud API (Business) (BETA).
  4. Fill in the required fields:
FieldDescription
Access TokenYour permanent or temporary access token from Meta's developer portal. This authenticates API requests.
Phone Number IDThe numeric ID assigned to your WhatsApp phone number. Find this in your Meta developer dashboard under WhatsApp > API Setup.
API VersionThe Meta Graph API version to use. Defaults to v22.0. You usually don't need to change this.
WABA IDYour WhatsApp Business Account ID. Required for managing and sending template messages. Find this in Meta Business Suite under WhatsApp Manager.
  1. Click Add Account.

Cloud API Setup

Setting Up Webhooks (to Receive Messages)​

ReplyWolf uses a cloud relay to receive incoming messages -- no port forwarding or public IP required. When you add a Cloud API account, a unique webhook URL is automatically generated.

To complete the setup:

  1. After adding the account, click the gear icon on the account to open Account Settings.
  2. Copy the Callback URL and Verify Token from the webhook section.
  3. In Meta Business Suite, go to your app's WhatsApp > Configuration.
  4. Under Webhooks, click Edit.
  5. Paste the Callback URL and Verify Token.
  6. Click Verify and Save.
  7. Subscribe to the messages webhook field.

That's it -- incoming messages will now appear in ReplyWolf automatically.

Updating Credentials​

If your access token expires or you need to change any API credentials:

  1. Click the gear icon on the account to open Account Settings.
  2. Update the fields under API Credentials (access token, phone number ID, API version, WABA ID).
  3. Click Save.
  4. Reconnect the account (disconnect and connect again) for the changes to take effect.

You do not need to delete and recreate the account -- all your chat history and settings are preserved.

Account Status Indicators​

Each account in the sidebar shows its current connection status:

  • Green dot -- Connected and ready to send/receive messages.
  • Gray dot -- Disconnected. Click the connect button (power icon) to reconnect.
  • Spinning indicator -- Reconnecting. The app is trying to restore the connection.

Account Status Indicators

Auto-Connect on Startup​

By default, ReplyWolf automatically connects all your WhatsApp accounts when the app starts. Accounts with saved sessions reconnect silently. Accounts that need a new QR scan will stay disconnected until you connect them manually.

You can turn this off in Settings > General > Auto-Connect by unchecking "Connect accounts on startup."

Multiple Accounts​

You can add as many WhatsApp accounts as you need. Mix and match QR Code and Cloud API accounts. Each account appears in the accounts sidebar on the Messages page, and you can switch between them by clicking on an account.

Multiple Accounts

Managing Accounts​

Hover over an account in the sidebar to see action buttons:

  • Settings (gear icon) -- View and edit account configuration.
  • Connect / Disconnect (power icon) -- Toggle the connection.
  • Delete (trash icon) -- Permanently remove the account and all its data. This cannot be undone.