Skip to main content
The WhatsApp QR connect add-on is a separate module. Purchase it from Envato, then install and enable it from Admin → Addons using your purchase code.
Before enabling the add-on for plans, run Evolution API on your server (Swiftchats uses it as the WhatsApp Web gateway). See System requirements for hosting and Docker guidance.

Prerequisites

  1. Upgrade Swiftchats to v3.0 or newer.
  2. Run Evolution API on your stack (see System requirements).

1. Install and enable the add-on (admin)

  1. Sign in to the admin account.
  2. Open Addons.
  3. Find WhatsApp QR connect.
  4. Enter your Envato purchase code and click Install. The script downloads the add-on and runs setup in the background.
  5. When install completes, open Setup and turn the add-on on (enable the toggle).

2. Enable on subscription plans (admin)

  1. Open Plans (subscription plans).
  2. For each plan that should use WhatsApp QR connect, enable the WhatsApp QR connect add-on.
  3. Save changes.

3. Connect WhatsApp (user)

  1. Sign in to a user account on a plan that has the add-on enabled.
  2. Go to SettingsWhatsApp (WhatsApp settings).
  3. Click Setup WhatsApp.
  4. Open the WhatsApp Web tab (not WABA).
  5. Enter:
    • Instance name — must match your Evolution API instance name.
    • Phone number — country code + national number, digits only (no +).
  6. Scan the QR code with WhatsApp on your phone and finish pairing.
  7. When chatting, if multiple lines are available, select the WhatsApp QR connect line in the chat form dropdown before sending.

Quick reference

StepWhereWhat to do
PrerequisitesServer + appSwiftchats v3.0+; Evolution API running
InstallAdmin → AddonsPurchase code → Install → Setup → enable
PlansAdmin → PlansEnable WhatsApp QR connect per plan
PairUser → Settings → WhatsAppSetup WhatsApp → WhatsApp Web → instance + phone → QR
For Docker-based Evolution API on Ubuntu and environment variables used alongside Swiftchats, see section 5 in Installation.