Lumenbase

    Integrating with WhatsApp

    Setup Guide

    Link your own WhatsApp number to sync conversations with existing contacts into the unified Communication inbox and contact timelines.

    By Sebastian StreiffertPublished Jan 10, 2026Updated May 4, 20266 min read

    What is the WhatsApp integration and when should you use it?

    The WhatsApp integration brings your WhatsApp conversations into the CRM as a first-class channel. You link your own WhatsApp number, and conversations with people who already exist as CRM contacts appear in the unified Communication inbox and on each contact's timeline alongside email and LinkedIn.

    Use it if you do real selling over WhatsApp and want that history visible to your team without copy-pasting screenshots. It is a 1:1, human-paced channel — not a broadcast or bulk messaging tool.

    How Lumenbase handles WhatsApp

    Lumenbase connects to WhatsApp the same way WhatsApp Web / Desktop does (multi-device). You link your own number by scanning a QR code or entering a pairing code on your phone. A persistent background worker then holds the connection, ingests incoming messages, and sends your approved replies.

    To keep your inbox relevant, Lumenbase only syncs conversations that match an existing CRM contact. Chats with people who are not yet contacts are left out until you add them, so the CRM inbox stays focused on the relationships you track.

    WhatsApp linking uses an unofficial connection (like WhatsApp Web). Keep messaging human and 1:1 — Lumenbase does not bulk-send, and abusing automated sending can get a number blocked by WhatsApp.

    Setting up WhatsApp

    1

    Open WhatsApp integration settings

    Go to My Settings → Integrations → WhatsApp. WhatsApp is a personal integration — each member links their own number.
    2

    Start a link request

    Choose pairing code (enter your phone number, then type the code into WhatsApp on your phone) or QR code. The code appears live in settings and expires after a short window, so have your phone ready.
    3

    Confirm on your phone

    In WhatsApp on your phone open Settings → Linked devices → Link a device and scan the QR or enter the pairing code. Once linked, settings shows your connected number and a live connection status.
    4

    Verify in Communication

    Open the Communication inbox. WhatsApp threads for people who are already CRM contacts appear with a WhatsApp channel badge. If you don't see any, it usually means none of your recent chats match an existing contact yet.
    WhatsApp threads require the WhatsApp plan capability to be enabled for your workspace. If the integration card is hidden or threads don't appear, confirm your plan includes WhatsApp and that your number shows as connected in settings.

    How conversation syncing works

    Contact-only sync

    Only conversations matched to an existing CRM contact (by phone number) are synced. Add the person as a contact with their WhatsApp number to bring that thread into the inbox and onto their timeline.

    Timeline and signals

    WhatsApp messages are logged as activities on the matched contact's timeline, and inbound replies feed Lumo so they can show up as follow-up signals in the Feed.

    Replying

    You reply from the Communication composer, or approve a Lumo-drafted reply. Sending is 1:1 and human-paced through the connected number — there is no bulk send.

    Channel visibility

    The Communication status bar has a per-channel visibility toggle, so you can show or hide WhatsApp (and Gmail, Outlook, LinkedIn) in the unified inbox whenever you want to focus.

    Connection health

    Because the link behaves like WhatsApp Web, it can drop if your phone is offline for a long time or you unlink the device. Settings shows the live status and a recent heartbeat; a background watchdog also re-checks linked numbers and helps recover stuck links. If a connection goes stale, re-link from My Settings → Integrations → WhatsApp.

    Keep your phone online and connected to the internet. WhatsApp's multi-device mode keeps working for a while when your phone is off, but linked devices eventually need the phone to check in.

    Common mistakes and misunderstandings

    Expecting every chat to sync

    Conversations only sync when the other party is an existing CRM contact. If a thread is missing, add the person as a contact with their WhatsApp number first.

    Treating it as a broadcast tool

    WhatsApp here is for 1:1 selling, not campaigns. There is no bulk send, and using a personal number for mass messaging risks a WhatsApp block.

    Linking the wrong number

    You link the number you actually message prospects from. Conversations and sends route through that linked number, so use the one your contacts recognize.

    Troubleshooting

    QR or pairing code expired

    1. Re-open My Settings → Integrations → WhatsApp to generate a fresh code
    2. Have WhatsApp open on your phone before you start so you can link quickly
    3. If pairing code fails, try the QR method (or vice versa)

    Threads not appearing

    1. Confirm your number shows as connected in settings
    2. Check the person exists as a CRM contact with the correct WhatsApp number
    3. Confirm WhatsApp is enabled on your workspace plan
    4. Make sure WhatsApp isn't hidden by the Communication channel visibility toggle

    Connection keeps dropping

    1. Keep your phone online and charged
    2. Re-link the device from integration settings
    3. Verify the number is still listed under Linked devices in WhatsApp on your phone

    Related

    WhatsApp lands in the same unified inbox as email and LinkedIn. See unified communication for how channels share one timeline, and LinkedIn integration for the other extension-based channel.

    Quick Reference

    Integration settings: My Settings → Integrations → WhatsApp
    Link method: Pairing code or QR (link your own number)
    View WhatsApp messages: Communication (sidebar)
    What syncs: Only chats matched to existing CRM contacts
    Sending: 1:1, human-paced; compose or approve a Lumo draft
    Plan requirement: WhatsApp capability enabled on your plan

    Was this article helpful?