Getting started

WhatsApp automation setup

8 min readwhatsapp-setup

Connect your WhatsApp number via QR code, configure the AI chatbot, build message sequences, and use the 3-panel inbox.

FlowMaticX WhatsApp automation runs through Wasender — a self-hosted WhatsApp gateway. No monthly per-message fees beyond your FlowMaticX credits (1 credit per message sent).

Step 1 — Link your WhatsApp number
  1. Go to /whatsapp in the sidebar
  2. Click Connect WhatsApp
  3. A QR code appears. Open WhatsApp on your phone → Settings → Linked Devices → Link a Device
  4. Scan the QR code. Your number is now connected within 10–15 seconds.
  5. The status badge turns green: Connected

> One number per workspace. If you're an agency with multiple clients, each client workspace connects its own WhatsApp number.

Step 2 — Configure the AI chatbot

The AI chatbot handles inbound messages automatically when you're not available.

  1. Go to /whatsappChatbot tab
  2. Toggle AI auto-reply ON
  3. Select a chatbot from the dropdown (chatbots are trained at /chatbots)
  4. Set your reply mode:
  • Draft — AI writes a reply, you review before sending
  • Auto — AI sends immediately (good for FAQ bots)
  1. Optionally add a system prompt to focus the bot on specific topics

The chatbot shares memory with your FlowMaticX Brain — if you've trained it on your website and services, those answers are available on WhatsApp automatically.

Step 3 — Build a WhatsApp sequence

WhatsApp sequences work like email sequences — a series of messages sent at scheduled intervals.

  1. Go to /sequencesNew sequence → pick WhatsApp channel
  2. Add steps:
  • Day 0 — intro message (e.g. "Hi {{firstName}}, I noticed you were looking for X…")
  • Day 2 — follow-up ("Just checking in — happy to share a quick case study")
  • Day 5 — close ("Last nudge — would a 15-min call make sense this week?")
  1. Use merge tags: {{firstName}}, {{companyName}}, {{leadSource}}
  2. Add reply detection — tick "Stop on reply" so enrolled leads exit the sequence as soon as they respond
Step 4 — Enroll leads in a WhatsApp sequence
  • Single lead: open the lead detail page → Enroll → pick your WA sequence
  • Bulk: in the Leads table, select multiple leads → ActionsEnroll in sequence → pick your WA sequence
  • Via automation: use the wa.send_text or wa.send_menu node in any automation to send WA messages as part of a multi-channel workflow
Step 5 — Use the 3-panel inbox

The inbox (/inbox) shows email and WhatsApp conversations side by side.

  • Left panel: conversation list — filter by channel (email / WhatsApp), status (open / snoozed / resolved), or assigned team member
  • Middle panel: full conversation thread with WhatsApp-style read receipts (single ✓ sent, double ✓ delivered, blue ✓ read)
  • Right panel: lead profile, pipeline stage, quick actions (move stage, enroll in sequence, add tag, create GHL task)
Automation nodes

The following automation nodes are available for WhatsApp:

NodeWhat it does
wa.send_textSend a plain text message to a phone number
wa.send_menuSend an interactive menu (buttons or list rows)
wa.wait_replyPause the flow and wait for the contact to reply
wa.classifyUse AI to classify the reply intent (e.g. "booking / pricing / support")
wa.handoffTransfer conversation to a human agent with a notification
Credits

Each WhatsApp message sent (text or menu) costs 1 credit. Received messages are free. Check your credit balance at /account/billing.

Troubleshooting
ProblemFix
QR code expiredClick Reconnect and scan again within 60 seconds
"Device not linked" errorYour phone may have disconnected. Reconnect via QR
Messages not deliveringCheck phone internet + battery optimisation (disable for WhatsApp)
AI not replyingCheck chatbot is selected and Auto mode is on
Sequence not sendingVerify the lead has a phone number stored in the phone field