Tutorials & Guides
Learn LeadNudge
Step-by-step guides to get set up, manage your pipeline, and close the loop between your CRM and your ad campaigns.
Start here
Getting started in 5 steps
Teams are typically fully live within a day. Here's the exact order that works best.
Accept your invitation
You'll receive an invitation email from info@leadnudge.ae. Click the link, set your password, and you're in. Your workspace is already configured with pipeline stages and settings by your admin.
Connect your lead sources
Go to Settings → Meta Lead Ads and click "Connect with Facebook" to cover every instant form on your Page. Running Google Ads lead forms too? Settings → Google Lead Forms issues a webhook URL and key to paste into each form asset. For website leads, copy the snippet from Settings → Website Snippet. From that moment, every submission lands directly in your pipeline, with no manual exports, no Zapier.
Configure your pipeline stages
Go to Settings → Pipeline. Your stages come pre-loaded from your onboarding discussion. Rename, reorder, or add new stages to match your actual sales process. Each stage can have a Meta event and Google conversion action mapped to it.
Invite your team
Go to Agents and click "Invite Member". Enter the agent's email, full name, role, and commission %. Five roles are available: Super Admin, CRM Manager, Sales Head, Team Lead, and Agent. They receive an invitation email and can log in immediately. There is no separate onboarding step.
Enable Meta CAPI
Go to Settings → Meta CAPI. Enter your Pixel ID (found in Meta Events Manager) and your CAPI Access Token (found in Events Manager → Settings). Select your dataset type, either Website Pixel or CRM Dataset. LeadNudge will then automatically fire conversion events to Meta whenever a lead moves to a qualifying pipeline stage.
Feature guides
Everything you can do with LeadNudge
Deep-dives into each feature: what it does, where to find it, and tips for getting the most out of it.
Meta Lead Ingestion
Connect your Facebook Page once and all lead ad form submissions flow into your pipeline automatically. LeadNudge uses a page-level Meta webhook, not form-level, so every current and future lead form on your connected Page is covered without additional setup.
- Connect at Settings → Meta Lead Ads → "Connect with Facebook"
- Leads arrive in your first pipeline stage instantly, with no polling and no delay
- Duplicate leads (same phone or email within 7 days) are flagged, not silently dropped
- Custom fields from your Meta lead form appear in the Form Responses section of the lead detail
- Use "Sync Historical Leads" on the Meta Lead Ads settings page to import past submissions
- If the connection breaks, re-authorise from Settings → Meta Lead Ads
Google Lead Forms
Google's native lead form assets (attached to Search, YouTube, and Demand Gen ads) deliver leads by webhook. Go to Settings → Google Lead Forms, generate your webhook credentials, and paste them into each lead form asset in Google Ads. Google holds these leads for only about 30 days; LeadNudge collects them the moment they submit.
- Generate the webhook URL and key at Settings → Google Lead Forms
- In Google Ads, open the lead form asset, expand "Webhook integration", and paste both values
- Click "Send test data" in Google Ads: a test lead appears in your pipeline within seconds
- Custom form questions are preserved as form responses and feed the AI first-message draft
- The campaign arrives attached, so campaign routing rules apply automatically
- Rotating the key stops delivery for every form using the old key until updated in Google Ads

Pipeline & Kanban Board
The Pipeline page (/leads) is your main working view. Leads are organised as cards in columns matching your pipeline stages. Drag a card to a new column to move the lead. The board has four tabs: Active, Dormant, Archive, and All Contacts.
- Active tab shows the live Kanban board. Drag cards between columns to move leads
- Dormant tab shows leads that have been inactive past your configured threshold (Settings → Pipeline)
- Archive tab holds leads that were dormant too long. You can re-engage them from there
- All Contacts tab is a full data table with a column picker and saved views
- Each card shows the lead's name, score badge, source chip, assigned agent avatar, and time in stage
- Filter the board by agent, stage, or source using the toolbar at the top

Lead Detail
Click any lead card to open the full detail view. The page has a horizontal pipeline stepper at the top. Click any stage to move the lead there. The right sidebar shows Contact, Assignment, Source, AI Assistant, Form Responses, and Complete Lead Details sections.
- Click a stage in the pipeline stepper to move the lead. This triggers CAPI events if the stage is configured
- Contact section: view and edit email and phone inline
- Assignment section: reassign the lead, edit deal value, and see created/last contact dates
- Source section: shows the campaign, ad name, UTM parameters, Meta Lead ID, and GCLID
- Form Responses section: raw fields from the Meta or website lead form, values are editable
- Activity log below the stepper tracks every stage change, note, field edit, and AI action with timestamps
AI Features
All AI features live in the AI Assistant section of the lead detail sidebar. There are four tools: Lead Score, Generate Summary, Generate Draft, and Generate Followup. Each is generated on demand. Click the button and copy the result.
- Lead Score: generates a 0 to 100 score with a reason. Green ≥ 70, yellow ≥ 40, red < 40. Rescoring is available if the lead data changes
- Generate Summary: an AI-written executive summary based on the lead's source, campaign, stage, deal value, and contact history
- Generate Draft: a sales message draft tailored to the lead's context, ready to paste into WhatsApp or email
- Generate Followup: a follow-up suggestion for leads that have gone quiet
- All outputs have a "Copy" button. None are sent automatically, your team reviews before sending
- Re-score or regenerate at any time using the refresh icon next to each tool
Meta CAPI (Conversions API)
LeadNudge fires conversion events to Meta's Conversions API using your own Pixel ID and access token, not a shared pixel. Events are sent with hashed PII per Meta's requirements. Configure at Settings → Meta CAPI.
- Fields required: Pixel ID and CAPI Access Token (from Meta Events Manager → Settings)
- Dataset Type: choose "Website Pixel" if you have a Meta pixel on your site, or "CRM Dataset" for CRM-only tracking
- Test Event Code (optional): enter a test code from Meta Events Manager to verify events during setup
- Events fire automatically when a lead moves to a stage with a Meta event mapped (configured in Settings → Pipeline)
- Default events: marketingqualifiedlead for MQL stages, salesqualifiedlead for SQL stages, Purchase for Customer/Converted stages
- Verify fired events in Meta Events Manager → Test Events
Google Offline Conversions
LeadNudge uploads conversion data to Google Ads when leads reach a qualifying pipeline stage. This closes the loop between your Google campaigns and actual revenue. Configure at Settings → Google Ads.
- Click "Connect with Google" to authorise LeadNudge via OAuth
- Enter your Google Ads Customer ID (format: 123-456-7890, found top-right in Google Ads)
- Pipeline stages marked as "converted" in Settings → Pipeline automatically send offline conversions to Google
- Google uses this data to optimise Smart Bidding toward leads that actually close
- Conversions are attributed to the original Google Ad click via the GCLID captured on lead ingestion
Notifications
The bell icon sits in the top-right corner of the sidebar. A red badge shows your unread count (shown as "9+" above nine). Clicking opens the notification panel. Clicking any notification navigates to the associated lead and marks the notification as read.
- All notifications auto-mark as read 1.5 seconds after you open the panel
- Use the "Clear read" button to dismiss read notifications from the panel
- Notifications are triggered by: new lead assigned to you, SLA breach, stage change by a colleague, and system events
- Team Leads and Sales Heads are also notified when a lead lands with one of their team members
- Enable "Push on this device" in the panel footer to get these on your phone or desktop even with the tab closed
- SLA thresholds per stage are configured in Settings → Pipeline

Agents & Roles
Team management lives on the Agents page (/agents), not in Settings. Click "Invite Member" to add someone. The page shows all team members as cards with their stats, role, commission rate, and lead counts.
- Click "Invite Member", then enter email, full name, role, and commission %
- Five roles: Super Admin (everything), CRM Manager (daily operations), Sales Head (their teams), Team Lead (one team), Agent (own leads only)
- Visibility is enforced in the database itself: an agent structurally cannot read another agent's leads
- Each agent card shows: Assigned leads, Converted leads, Conversion rate, and Commission %
- Toggle "Receives leads" to include or exclude an agent from automatic lead assignment
- Per-agent email notification preferences (on/off and full or minimal format) are set on the same card
- Removing an agent unassigns their leads. Leads stay in the pipeline and can be reassigned
Teams & Lead Routing
For structured operations, switch teams on in Settings → General. A Teams panel appears on the Agents page where you create teams, pick a Team Lead and Sales Head, and add members. Routing then decides who gets each incoming lead.
- Teams are off by default: solo operators and small teams never see a teams screen
- Route a campaign to a team (leads rotate fairly within it), to a specific person, or to a Sales Head or Team Lead, at Settings → Campaign Routing
- The pool policy controls which roles compete for unrouted leads
- Choose the fallback for leads no rule catches: shared pool, a designated team, or hold for manual dispatch
- A Team Lead reassigns within their team, a Sales Head across their teams
- Every lead page shows its full chain: agent, team, Team Lead, and Sales Head

Reports & Analytics
The Reports page (/reports) gives managers a full view of pipeline health, team performance, and ad spend. Use the date filter (24h, 7d, 30d, or custom range) to scope the data.
- KPI cards: Total Leads, New Leads, Converted Leads, and Conversion Rate for the selected period
- Charts: Leads Over Time, Leads by Source, Ad Spend Over Time, Spend by Campaign, Leads by Stage, Google Ads Spend
- Agent Performance table: leads worked, contacted, converted, and commission earned per agent
- Campaign Performance table: spend, cost per lead (CPL), and lead volume per Meta campaign
- AI Insights section: auto-generated bullet-point summary of the period's performance
- Ad spend data requires your Meta ad account to be connected (Settings → Meta Lead Ads)

Prospecting
The Prospecting page (/prospecting) is a Beta AI feature for finding new leads outside of your Meta campaigns. It has two tabs: ICP (define your target audience) and Contacts (view and action the results).
- ICP tab: create a template with target job titles, industries, locations, country, and company size range
- Once an ICP is saved, LeadNudge runs a prospecting job to find matching contacts
- Contacts tab: review prospected contacts with columns for name, title, company, email, phone, LinkedIn, and confidence score
- From the Contacts tab you can: push contacts into your pipeline, assign to an agent, verify emails in bulk, or export as CSV
- A quota bar shows how many contacts you've used against your plan limit
- Filter contacts by ICP template, prospect status (unassigned / assigned / in pipeline), and email verification status

Settings Overview
Settings (/settings) is organised into four groups. Admin access only. Each group has dedicated tabs. Navigate using the left sidebar within the Settings page.
- General: Currency, Commission rules, Custom Fields, and the Teams on/off switch
- Pipeline: Pipeline (stages, SLA thresholds, Meta events, Google conversion actions), Lead Assignment (round-robin pool and fallback), Campaign Routing (route campaigns to teams, people, or leadership)
- Integrations: Meta Lead Ads, Meta CAPI, Google Ads, Google Lead Forms, Website Snippet, WhatsApp Widget, Webhook & API Key, API Docs
- Account: Billing, Your Data (export or delete your workspace data)
- Dormant After (days) and Archive After (days) are configured in Settings → Pipeline. These control when leads move from Active to Dormant and from Dormant to Archive

Importing Leads (CSV)
Import an existing lead list from the Pipeline page. Go to the Active tab and click the "Import" button (visible to admins). A four-step wizard guides you through upload, column mapping, preview, and import.
- Step 1: Upload your CSV file
- Step 2: Map CSV columns to LeadNudge fields. Auto-detects common headers like "First Name", "Email", "Phone"
- Step 3: Preview a sample of rows with mapped values before committing
- Step 4: Result summary shows how many leads were created, skipped (duplicates), or errored
- Supported fields include: name, email, phone, deal value, campaign/ad/UTM data, custom fields
- Imported leads are tagged with source "csv_import" and follow the same pipeline and SLA rules as any other lead
Install the App (Mobile & Desktop)
LeadNudge installs straight from the browser, with no app store. On your phone, open your workspace and choose "Add to Home Screen" (iPhone: Share menu; Android: browser menu). On desktop Chrome or Edge, click the install icon in the address bar. The installed app opens in its own window, named and themed for your company.
- The app opens directly on your pipeline, signed in
- Turn on push notifications from the bell panel ("Push on this device") to get lead alerts on your phone the second a lead lands
- On iPhone, push notifications require the app to be installed to the home screen first
- Push is per device: enable it separately on your phone and your laptop if you want both
- Tapping a push notification opens the lead it refers to
FAQ
Common questions
How long does the initial setup take?
Teams are typically fully live within a single working day. Connecting Meta (Settings → Meta Lead Ads) takes about 5 minutes. Configuring pipeline stages (Settings → Pipeline) takes another 10 to 15 minutes. Inviting agents from the Agents page takes under 5 minutes per person.
Do I need technical knowledge to connect Meta?
No. The Meta connection is a standard OAuth flow, the same experience as "Login with Facebook" on any app. You select your Page and click Authorise. No API keys or developer portal access is required.
Where do I add team members, Settings or Agents?
Agents. Go to the Agents page (/agents) and click "Invite Member". There is no team management section in Settings.
Can I change pipeline stages after leads are already in them?
Yes. Renaming or reordering stages in Settings → Pipeline does not move existing leads. Leads stay in their current stage. Only the label and position change. To delete a stage, you must first move or archive leads in that stage.
What happens to leads that come in before I finish setup?
You won't miss them. The Meta webhook activates the moment your Page is connected. Leads that arrived before the connection are not backfilled automatically. Use "Sync Historical Leads" in Settings → Meta Lead Ads to import them manually.
Where can I get help if I'm stuck?
Email us at info@leadnudge.ae or reach us on WhatsApp. We typically respond within a few hours during UAE business hours.
Ready to get started?
LeadNudge comes with a 10-day free trial. No credit card required. Teams are typically fully live within a day.