Skip to main content

Lead Generation Forms

Important: What This Feature Actually Is​

This is a read-only leads inbox, not a form builder. Whoxa CRM cannot create or edit Meta Lead Ad forms — you build and publish those in Meta Ads Manager yourself. This page only receives and displays submissions via webhook once your Page is connected.

Prerequisite​

  1. Complete Connect Facebook — this page has no connection controls of its own.
  2. In Meta Ads Manager, create and publish a Lead Ad with a Lead form, using the Page you connected.
  3. In your Meta App's dashboard, make sure the Page webhook's leadgen field is subscribed (this is app-level Meta configuration, separate from anything in Whoxa CRM).

Where to Find It​

Sidebar → Facebook → Lead Generation Forms (route /integrations/lead-generation-forms).

How Leads Arrive​

When someone submits your Lead Ad form, Meta's webhook notifies Whoxa CRM with just a lead ID. The backend then fetches the actual answers from Meta, extracts name/email/phone from the submitted fields (matching common field names, case-insensitive), and stores the lead with status New. Duplicate webhook deliveries for the same lead are ignored.

Using the Page​

  • Status tabs: All / New / Contacted / Converted / Discarded.
  • Table: Name, Email, Phone, Submitted date, and a Status dropdown per row — the only editable control on this page.

Update the status dropdown as you work a lead — this is purely a pipeline label inside Whoxa CRM and doesn't sync back to Meta.