Home/Help Center/Leads pipeline

Sales

Use the Leads Pipeline

Set up your leads pipeline, work the Dashboard, Board and List views, and see how a lead becomes a WhatsApp contact automatically as it moves through stages.

By Chirag Darji · Updated 31 Oct 2026 · 9 min read

On this page
  1. Before you start
  2. Steps
  3. What you will see
  4. Why does a lead's detail panel matter more than the card itself?
  5. One customer, several enquiries
  6. Settings and options
  7. Troubleshooting
Leads board in VGraple CRM with Intake, Qualified and Converted columns, each lead showing source, campaign, owner and next step

The leads pipeline is where every inbound inquiry lands before it becomes a paying customer, whether it arrived from a WhatsApp Form, a web form, a Facebook ad or a booked call. This walkthrough covers the Dashboard, Board and List views, how a lead moves through stages, and exactly when it becomes a WhatsApp contact you can message directly.

Leads pipeline: first 5 of 7 steps

  1. 1Open Leads from the main navigation
  2. 2Check the Dashboard view first
  3. 3Switch to Board for day-to-day work
  4. 4Open a lead to see the full
  5. 5Use List view for sorting and bulk
The steps on this page, in order.

Before you start

  • The leads pipeline is available on every plan, including Free, with no separate cap on lead count.
  • Your account needs the permission that grants access to the Leads module, included in Owner, Admin and most custom roles by default.
  • A default pipeline with three starter stages already exists on a new org, so there is nothing to build before your first lead arrives. If you want a second pipeline or custom stage names, see creating pipelines and stages first.
  • At least one lead source should be connected for leads to arrive automatically: a form (see building forms), Facebook Lead Ads (see connecting Facebook Lead Ads), Calendly (see connecting Calendly). A plain inbound WhatsApp message does not create a lead on its own: turn on Create a lead from each submission on a WhatsApp Form, or map a Click-to-WhatsApp ad to a pipeline.

Steps

  1. Open Leads from the main navigation. In the sidebar, open CRM, then Leads. The page opens on whichever view (Dashboard, Board or List) you last used, defaulting to Dashboard the first time.

Leads overview in VGraple CRM with totals, leads by campaign and leads by stage across two pipelines

  1. Check the Dashboard view first. It shows total lead counts, a Leads by Campaign chart, and a Leads by Stage breakdown, useful for a quick read on where volume is coming from before you start working individual leads.

  2. Switch to Board for day-to-day work. Click the Board button (the grid icon) to see a Kanban view with one column per stage. Drag a lead's card from one stage to the next as it progresses, for example from "New" to "Contacted" to "Qualified" depending on how your pipeline's stages are named.

  3. Open a lead to see the full detail panel. Click any card or table row to open its detail panel: contact details, the pipeline stage, a lead score with a factor breakdown, form answers if it came from a form, a Notes timeline, and a Sequences tab showing every automated follow-up it has ever been enrolled in.

  4. Use List view for sorting and bulk work. Click the List button (the list icon) for a table you can sort by any column (score, created date, stage, source) and select multiple rows for bulk actions like tagging or reassigning.

  5. Assign a lead to a team member. From the detail panel's Pipeline and Assignment section, pick who owns this lead. There is no automatic assignment unless you set up a lead rule.

  6. Filter by campaign, form or agent when you need to. The All forms, All campaigns and All agents filters above the board and list narrow what you see, useful right after connecting a new Facebook Lead Ad campaign or a new form to check that leads are actually arriving and landing in the right stage.

What you will see

A new lead card appears in the first stage of whichever pipeline it was routed to, tagged with its source (Meta Lead Ad, Web Form, WhatsApp Form, Calendly, Comment Rule, Chatbot or Manual) and, where applicable, the campaign or form name it came from. A 0 to 100 lead score badge shows on the card immediately, colour-coded hot, warm or cold. The moment a usable phone number exists on the lead, its detail panel shows a linked WhatsApp contact, no separate "convert to contact" step is needed or offered, because it happens automatically.

The Dashboard view's Leads by Campaign chart updates the moment a new lead lands, so a running Facebook or Instagram campaign shows fresh volume without a manual refresh. Opening a lead that came from a form shows every submitted answer under a Form Data tab, including anything not mapped to a standard field like name, email or phone, stored exactly as the person typed or selected it.

Why does a lead's detail panel matter more than the card itself?

The card on Board or List is a summary meant for scanning a full pipeline quickly, name, source, score and stage. The detail panel is where the actual work happens: a Notes timeline for anything your team logs manually, a Sequences tab listing every automated follow-up the lead has ever been enrolled in with its current status, and a Pipeline and Assignment section for moving the lead or reassigning it to a different team member. For a lead with form data attached, the raw answers sit in their own tab rather than being flattened into a single note field, so a counsellor or agent calling back can see exactly what was asked and answered.

Example

A coaching institute's counsellor opens a lead that came from a course-interest form. The detail panel's Form Data tab shows the exact course and batch the visitor selected, including the fee shown at the time, so the callback starts with the right pitch instead of a generic "how can I help."

One customer, several enquiries

A lead belongs to the contact for its phone number, and VGraple CRM creates that contact when there is none. If you add a lead for a number that already has one, you are shown the existing lead first, so a double entry does not slip through. If it is a different enquiry from the same customer, such as another trip or product, choose Add as another lead and give it an enquiry name. Each lead keeps its own stage, reminders, notes and outcome, while the customer stays one contact with one chat history. The enquiry name can be changed from the lead's detail panel at any time, and it shows beside the person's name on the board, in the list, in Follow-ups and in the Android app. Through the API, a call for a number that already has a live lead returns that lead with duplicate: true; to add another lead for the same customer, send allow_additional: true and a title, as described in the REST API quickstart.

Example

A travel company has one customer asking about Winter Spiti and, a week later, Kedarkantha. Winter Spiti is Booked while Kedarkantha is still at Follow up, each with its own reminder, on one contact.

Settings and options

Setting or fieldWhat it doesDefault
ViewDashboard, Board or List, the three ways to look at the same pipeline dataDashboard on first visit, remembers your last choice after
Pipeline selectorSwitches which pipeline's leads you are viewing, if you have more than oneThe org's default pipeline
Form filter (All forms)Narrows to leads from one formAll forms shown
Campaign filter (All campaigns)Narrows to leads from one Facebook or Instagram campaignAll campaigns shown
Agent filter (All agents)Filters by which team member owns the leadAll agents
Sort (List view)Sort by score, created date, name or stageNewest first

Troubleshooting

SymptomLikely causeFix
A lead I expected never appearedThe source it came from was never connected, or a Facebook Page's access token expiredCheck Facebook Lead Ads or forms connection status in Settings; a Facebook connection expiry shows a reconnect notice
A lead has no phone number and cannot be messagedThe original form, comment or chatbot capture never provided oneAdd a phone number manually on the lead detail panel, or wait for the person to message your WhatsApp number directly, which links automatically
Two leads exist for what looks like the same personSomeone chose Add as another lead on purpose (or an integration sent allow_additional), each Meta lead ad submission is its own card by design, or the two phone numbers differ (another country code or a different number) so they are two contactsOpen each lead and read its enquiry name and source; merge notes by hand, or move one to Closed if it is a genuine duplicate
A lead landed in the wrong pipelineNo campaign-to-pipeline mapping exists for that source, so it fell back to the org's default pipelineSet up a mapping under Campaign Routing in Settings, Sales setup, Lead Pipelines if this source should always route elsewhere, or move the lead manually
The lead score seems stuck or wrongScore only recalculates on creation, on an inbound reply, or on the periodic background sweep for recency, not on every page loadOpen the lead detail panel and use the manual recalculate button on the score section
Dragging a card on Board view does not save the stage changeA network interruption during the drag, or the browser tab lost focus mid-dragRefresh the page and try again; the stage move only commits after a successful save

Once your pipeline is set up the way you want it, tune the stages themselves in creating pipelines and stages, and understand exactly how the score on each card is calculated in how lead scoring works.

Frequently asked questions

Do I need to set anything up before leads start arriving?
No. A default pipeline with three starter stages exists on every new org, so a lead from any connected source lands somewhere immediately. You only need extra setup if you want a second pipeline, custom stage names, or campaign-to-pipeline routing.
Does a WhatsApp conversation create a lead on its own?
No. A lead is created when a WhatsApp Form with Create a lead from each submission turned on is submitted, when a conversation starts from a Click-to-WhatsApp ad whose campaign is mapped to a pipeline, when a chatbot captures one, or when your team adds one by hand or through the API. A plain message to your number creates a contact and a conversation, not a lead. The Chat pipeline and the Leads pipeline are separate, each with its own stages, so a conversation can sit in one chat stage while the same person is a lead in a different stage.
Which sources create a lead automatically?
Six of them, a Facebook or Instagram Lead Ad submission, a web form or WhatsApp Form built in VGraple CRM, a Calendly booking, a comment matching a Comment Rule on a monitored post, or a chatbot conversation, plus manual entry by your team.
How do I switch between the Dashboard, Board and List views?
Three view buttons sit at the top right of the Leads page, Dashboard (chart icon) for totals and campaign breakdowns, Board (grid icon) for the drag-and-drop Kanban view, and List (list icon) for a sortable table. Switching views does not change which leads or pipeline you are looking at.
Why does a lead not show a phone number even though it has a WhatsApp contact?
It usually does, the lead card shows whichever phone value was on the original submission. If a phone truly is missing, the lead stays pipeline-only until one is added manually or the person messages your WhatsApp number directly, at which point it links automatically.
Can I move a lead to a different pipeline after it is created?
Yes, from the lead detail panel's Pipeline and Assignment section, without losing its notes, form data or sequence history. Moving pipelines does not reset its lead score.
What happens if I delete a pipeline that still has leads in it?
You cannot. VGraple CRM blocks the delete and tells you how many leads are still in that pipeline; move them to another pipeline first, then delete.
Is there a limit on how many leads I can have?
No separate lead cap on any plan, including Free. Your plan sets how many contacts you can store, and a lead's contact counts toward that like any other contact; conversations are unlimited on every plan.

Run your WhatsApp on VGraple CRM

Free forever plan, official Meta WhatsApp Business API, set up in 15 minutes. No card needed.