Catchline docs
v1.0.0
Get help
● Catchline · Perfex CRM module

Catch every lead.
Answer it while it is still warm.

Forms, popups and hosted pages of your own, Facebook and Instagram Lead Ads, Google Ads lead forms, 12 form tools and CSV files in one place inside your Perfex CRM. Every lead is scored, routed to the right salesperson with a speed-to-lead timer, followed up by e-mail and traced to the customers and paid invoices it brought.

Version 1.0.0Perfex CRM 3.2 or newerPHP 8.1 or newer

01Start here

Catchline is a module you install into your own Perfex CRM. It adds a Catchline menu with a dashboard, the form builder, the lead log, follow-up sequences, reports and the setup pages. Read the pages in order the first time: install, connect one source, send yourself a test lead, then add the next source.

Catchline dashboard: leads today, leads in the last 7 days, the share that became customers and the median first reply
The dashboard. All screenshots in these docs show fictional sample data.

02Before you start

Perfex CRM is sold separately and is not made or endorsed by the author of this module. You need your own, working Perfex CRM 3.2 or newer.

Facebook, Instagram, Meta, Google Ads, Typeform, Tally, Webflow, Framer, Google Forms, Gravity Forms, Elementor, WPForms, Fluent Forms, Contact Form 7, Jotform, Telegram and the AI providers named in these docs are trademarks of their owners. Catchline is not affiliated with, endorsed or sponsored by any of them. Each integration works with your own account at that provider, under that provider's terms and prices. See Who pays for what.

03What the module does

  • Forms of your own: a drag-and-drop builder with 23 ready fields and blocks, steps with a progress bar, show-if logic that the CRM checks again on arrival, file uploads, a consent checkbox with proof of the text shown, translations (right-to-left included), design settings, a live preview, published versions and A/B variants.
  • Everywhere you need them: a hosted page on your CRM's address, an inline script embed, a popup button, an iframe, a plain link, a QR code, and popups, slide-ins and bars with triggers (delay, scroll, exit intent, click).
  • Every other source in the same pipeline: Facebook and Instagram Lead Ads, Google Ads lead forms, Typeform, Tally, Webflow, Framer, Google Forms, Gravity Forms, Elementor, WPForms, Fluent Forms, Contact Form 7, Jotform, any tool that can send a webhook, and CSV files.
  • Clean records: each source maps its fields to Perfex fields, custom fields included, and creates a lead, a customer with its contact, or a ticket. A match by e-mail fills only empty fields; a match on the phone number alone always waits in a review queue.
  • Scoring: profile rules (answers, source, UTM, business or free e-mail) and behaviour rules (opens, clicks, replies, a second submission) give a score from 0 to 100 and a grade from A to D. Behaviour points fade with a half-life.
  • Routing: round robin, weighted, territory, language, interest, fewest open leads or a claim pool where the first to press Claim gets the lead, with availability, holidays and capacity per person. A speed-to-lead timer warns, alerts, reassigns or escalates.
  • Follow-up: sequences of e-mails, waits, conditions and Perfex tasks that stop when the lead replies, becomes a customer or reaches a status you choose. Unsubscribe always works.
  • Back to your ads: Meta Conversions API events when a lead reaches a status or converts, and a conversion file for Google Ads scheduled uploads.
  • Reports: leads, customers, paid-invoice revenue, cost per lead and per customer by source and campaign, a form funnel, A/B results and speed to lead per salesperson, with CSV export.
  • Outgoing webhooks to Zapier, Make, n8n or your own system, signed so the receiver can trust them.
  • Optional AI, off by default, with your own provider key: form drafts, translations, follow-up e-mail drafts, mapping suggestions, message summaries and score explanations. A person approves every proposal.

04What version 1.0.0 does not do

So you can plan around it:

  • A form creates a lead, a customer with a contact, or a ticket. It does not create estimates, proposals or invoices.
  • No signature field and no PDF of a submission. Uploaded files are attached to Perfex leads only; for customers and tickets they stay in Catchline's private storage.
  • Follow-up sequences send e-mail and create tasks. There is no SMS step and no visual workflow builder.
  • Replies are recognised only when you add a reply mailbox (IMAP, read-only). Without one, a sequence stops on status change, conversion, unsubscribe or by hand.
  • Status changes, notes and conversions in Perfex are noticed on the next Perfex cron run, not instantly.
  • Google Ads gets conversions through a scheduled file upload (a secret CSV link). There is no Google Ads API connection.
  • The buttons and error texts of a public form (Next, Back, Send, "Please fill in this field") come from the module's language file in your CRM's language, not from the form's translations. See Languages.
  • Only the English language file ships. Every text goes through Perfex's translation function, so you can add your own (see Languages).
  • Perfex multi-tenant (SaaS) installations have not been tried.

05How it works

Every place leads come from is a source (Catchline calls it a connection) with its own secret link, field mapping, rules and duplicate settings. Built forms are sources too. Every lead runs through the same steps: it is stored in the submission log, mapped, checked for duplicates, routed, written to Perfex, scored and, when a sequence matches, followed up.

How Catchline works Leads arrive from built forms, Lead Ads, Google Ads, form tools and CSV files. Each is stored in the submission log, mapped, checked for duplicates and written to Perfex as a lead, customer or ticket. Routing picks the salesperson and starts the reply timer, scoring gives a grade, sequences follow up by e-mail. Status changes and conversions are sent back to Meta and Google and feed the reports. Your sources Built forms and popups Facebook and Instagram Lead Ads Google Ads lead forms 12 form tools, webhooks CSV files Captured Secret link, signature Spam checks, limits Submission log Repeats stored once UTM and click ids kept Into Perfex Field mapping Duplicate check Lead, customer + contact or ticket Files on the lead To the right person Routing rules Round robin, territory, language, claim pool Alert: Perfex, e-mail Reply timer starts Scored and followed up Score 0 to 100, grade A to D E-mails, waits, tasks Stop on reply or conversion Unsubscribe always works Back to the ad platforms Meta Conversions API events Google Ads conversion file Signed outgoing webhooks Retries on the cron Measured Leads and customers by source Paid-invoice revenue, costs Form funnel, A/B results Speed to lead per person Everything runs inside your Perfex: the module keeps its own tables in your database and does its timed work on the Perfex cron. Data goes only to the services you connect, with your own accounts. Optional AI calls only the provider you configure. Nothing is sent to the author of the module.

06Compatibility and testing

Version 1.0.0 is built for Perfex CRM 3.2 or newer, PHP 8.1 or newer and the MySQL or MariaDB database your Perfex already uses. It was developed on PHP 8.5.

Before release the module passed its suite of 904 automated tests (9,287 assertions) on SQLite and again on MariaDB 13 in strict mode. Install, a second activation, deactivation, uninstall and an upgrade from an older copy of the tables were run on MariaDB in strict mode. A scale run with 100,000 submissions and about 90,000 leads on MariaDB kept the submission list, its filters and the dashboard figures under about 50 ms per query; searching the log by text scans the whole log and took 0.2 to 0.6 seconds, and year-long reports took about 0.2 seconds. The public form, the inline embed and the popup were checked in Chrome at desktop and phone width, in light and dark.

The ad platform, form tool, captcha and AI integrations were tested against the request and webhook formats documented by each vendor, not against live accounts. Connect one source at a time and send yourself a test lead before you rely on it; the submission log shows what arrived and why something failed.