Connect WhatsApp to your workspace

Important — read before connecting WhatsApp

Vmoox embeds a WhatsApp Web-style experience inside your CRM so your team can manage customer conversations and link them to lead records. This is a business management tool — not a secure personal messaging app like WhatsApp on your phone.

• Messages you connect through WhatsApp in Vmoox are stored in your workspace on our platform. They are not protected by WhatsApp end-to-end encryption once inside Vmoox.
• Do not add personal, private, medical, financial, or other sensitive non-business information to Vmoox.
• Vmoox does not guarantee protection against data leaks, unauthorized access, or Meta/WhatsApp account limits. You are responsible for permissions and what your team stores.
• The connection uses an unofficial Web-style client, not Meta's official WhatsApp Business Cloud API. Meta may limit, suspend, or ban numbers used this way.

By connecting WhatsApp you accept these limits. See our WhatsApp Data Policy on vmoox.com for full details.

How WhatsApp connection and lead linking works in Vmoox

Vmoox embeds a WhatsApp Web-style inbox in your workspace so your team can reply from the browser and keep customer context on lead records. You connect a business phone number by scanning a QR code — similar to WhatsApp Linked Devices. This is not Meta's official WhatsApp Business Cloud API, and Vmoox does not provide approved marketing template catalogs. Once connected, you link chats to leads manually or turn on inbound lead automation from the WhatsApp app.

Before you begin

Vmoox works best when your team agrees on one shared process before changing settings. Confirm the workspace owner, map the apps you need, and define who has access to each app. For most small businesses and agencies, a quick setup meeting saves hours of cleanup later. Decide your naming rules, ownership model, and response expectations, then document them inside the workspace using Comments and Files so new teammates can onboard faster.

• Use a dedicated business number — not a personal account you cannot share with the team.
• Install the Leads or CRM app first so you have somewhere to attach conversations.
• Decide who may install apps, connect WhatsApp lines, and view linked message history.
• Read the WhatsApp Data Policy on vmoox.com before scanning QR — you must accept platform limits.
• Have your phone with WhatsApp open and ready to scan the QR code shown in Vmoox.

Step-by-step setup

Use these practical steps in order. If you skip ahead, your team may lose context and duplicate work.

1. Open the Apps hub in your workspace and install the WhatsApp app.
2. Open WhatsApp in the sidebar, add a connection, read the risk acknowledgment, and confirm.
3. Scan the QR code with WhatsApp on your phone (Linked Devices) until Vmoox shows the line as connected.
4. Send a test message to the number and confirm the thread appears in the Vmoox inbox.
5. Open a customer chat and link it to an existing lead record, or create a new lead from the thread.
6. Optionally open WhatsApp lead automation and enable auto-create leads for new contacts messaging you.
7. Assign team members to conversations and reply from the compose box in the thread view.

Daily operating rhythm

Check the inbox at least twice daily: new threads, unassigned chats, and any disconnected lines. When a conversation matters for sales, link it to a lead immediately so stage, owner, files, and Moox context stay on one record. Review connection health weekly — unofficial Web-style sessions can drop and need re-scanning.

Real-world implementation example

A typical agency setup uses Leads to qualify incoming inquiries, then converts qualified opportunities into Projects with linked Tasks and Files. Customer communication continues through WhatsApp and workspace messages, while checklist steps ensure delivery consistency. When teams update records in real time, managers can coach faster, spot risks earlier, and keep client communication aligned with the latest delivery status.

Team governance and ownership

Set one owner for process quality, one admin for app configuration, and clear team-level responsibilities for updates. Review permissions monthly, especially when roles change. A short weekly review of data quality, overdue work, and automation behavior is enough to keep systems healthy as you scale.

Cross-app alignment checklist

Check that Leads hand over correctly to Projects, that Tasks reflect real commitments, and that communication history stays attached to records. If you use Payments, HRM, Timo, or custom apps, define how each app contributes to daily decisions.

• Confirm every active record has an owner, current status, and next action.
• Check that critical conversations and files are attached to relevant records.
• Verify automations still match current field names, stages, and team responsibilities.

Best practices that scale

• Link meaningful sales and support chats to leads as soon as you identify the customer.
• Use one workspace line for the team instead of scattered personal phones.
• Train staff that messages are stored in the CRM — not end-to-end encrypted inside Vmoox.
• Limit WhatsApp app access to roles that need customer conversations.
• Enable inbound lead automation only after field mapping and de-duplication are tested.
• Keep business conversations only — do not store personal or sensitive private data.

Common mistakes to avoid

• Connecting a personal WhatsApp account the team cannot access when someone is away.
• Replying in Vmoox but never linking the chat to a lead, so context stays orphaned.
• Skipping the risk notice and being surprised by Meta limits or session disconnects.
• Expecting Meta-approved template messaging — Vmoox inbox uses normal chat replies, not a template catalog.
• Giving every workspace member access to all message history without role review.

Reporting and optimization

Track first response time and how many inbound chats are linked to leads within 24 hours. If linking lags, enable inbound lead automation and assign a daily inbox owner. Combine linked threads with Moox on the lead record to draft follow-ups from conversation history.

30-day action plan

1. Day 1: Install WhatsApp app, connect line, send internal test messages.
2. Week 1: Link every active sales chat to a lead; enable automation if volume warrants.
3. Week 2: Set assignee habits and restrict permissions to customer-facing roles.
4. Week 3: Review disconnected sessions, lead linkage quality, and Moox follow-up usage.

If your team gets blocked, write to support@vmoox.com. For subscription and charge questions, contact billing@vmoox.com.