Form Bridge docs
v1.0.0
Get help
● Set up · reference

Every screen
and every setting.

Form Bridge adds one menu to the Perfex admin sidebar. This page walks through each screen in menu order and lists every setting with its default.

DashboardConnectionsSubmissionsReview queueAI queueSettings

01Dashboard

Key numbers (submissions today, last 7 days compared with the 7 days before, the share that became a record, items waiting for review, failures), a chart of submissions per day for the last 30 days, the latest failures with their reason, your connections with their 7-day count and last submission, and when the cron last ran.

Dashboard with five key numbers, a bar chart for 30 days, the latest failures and the connections table
Form Bridge › Dashboard · Sample data · development harness, not a Perfex install

02Connections

All connections with their form tool, target (Creates), 7-day count, failures, last submission and state, plus the New connection form (Name, Form tool, Creates). A connection without a mapping is marked "Waiting for a mapping: submissions are only captured". There is no limit on the number of connections.

03A connection, step by step

Each connection has five steps along the top and a Switch off / Switch on button. A switched-off connection answers HTTP 403 and stores nothing.

StepContents
1 SetupName, form tool, target. Defaults for new records: lead status, lead source, assign to, tags, ticket department, ticket priority, ticket subject when the form sends none. Behaviour: context note, notify the assigned staff member, also by e-mail, attach tickets to an existing contact (see Tickets), AI summaries (when AI is on), honeypot field, submission id field (tools without a signature), secret header name (tools that can send a header). On the right: the webhook link, Create a new link, Protection with the signing or shared secret, How to connect steps for the tool (with the Apps Script for Google Forms) and Delete this connection.
2 MappingField mapping and custom fields.
3 RulesRouting rules.
4 DuplicatesDuplicates and the review queue.
5 TestDry test with a pasted payload, a curl example for a real submission, and the latest submissions of this connection.

04Submissions

The log with filters and search, and a page per submission with fields, result, raw payload, Save and replay, Delete and, with AI on, Ask AI for a summary. See Submission log and Replay.

05Review queue

Possible duplicates waiting for a decision: Merge into existing, Create new or Skip. See The review queue.

06AI queue

Shown only while the AI helper is on. Proposals waiting for approval, usage, recent decisions and the audit log. See Optional AI helper.

07Settings (administrators only)

SettingDefaultAllowedWhat it does
Largest submission (KB)51216 to 20480Larger requests are refused with HTTP 413. Your web server or PHP may have a lower limit of its own.
Submissions per minute, per connection601 to 100000More is refused with HTTP 429 until the minute has passed.
Repeat window (hours)241 to 8760The same body arriving again within this time counts as one submission. Tools that send their own id are always recognised.
Signature age (seconds)30030 to 86400A signed Webflow or Google Forms request older than this is refused as a replay.
Automatic retries30 to 10How often the cron retries a failed submission before it waits for a person.
Blocked e-mail domainsemptyone per lineSubmissions from these domains (and their subdomains) are logged as Spam.
Keep payloads for (days)300 to 3650See Retention. 0 keeps them.
Save the sender's IP address in the record noteoffAdds the IP to the context note.
AI helperoffProvider, model, API key, endpoint, limits (200 per month, 20 per staff member per day), apply summaries without asking (off). See Optional AI.

Also on this page: Export or erase by e-mail, Remove old payloads now, and System (module version, when the cron last ran, audit log state, installation date).

Settings page with webhook protection, privacy, the AI helper switched off, data requests and system information
Form Bridge › Settings · Sample data · development harness, not a Perfex install

08Changing texts and language

All texts are in modules/form_bridge/language/english/form_bridge_lang.php, and every key starts with fb_. To change a text without losing it on the next update, override the key in Perfex's custom_lang.php for your language, as Perfex describes for its own texts. Version 1.0.0 ships English only.