WPForms bridge - Animam Documentation

The WPForms bridge lets the agent submit any of your forms on behalf of the visitor, through the native WPForms pipeline. WPForms persists the entry, fires its existing webhooks/Zapier connectors/notification emails — exactly as if a human had filled the form in the browser.

How it works

Each form the tenant whitelists in Settings → Animam → WPForms bridge is exposed as its own dedicated tool, named wp_submit_wpforms_{id} (where {id} is the WPForms form id). The tool’s JSON schema is derived from the form’s own fields (labels, types, required flags), so the agent knows exactly what to collect.

The agent reads the tool’s schema and captures the fields conversationally.
After the visitor expresses intent, the agent calls wp_submit_wpforms_{id} with the structured payload.
The plugin runs the standard WPForms processing pipeline → entry created, notifications and integrations fire.

Only forms built from standard field types are exposed. Forms containing payment, signature or file-upload fields are skipped automatically.

Why this is safer than a parallel capture surface

	Animam-owned capture	WPForms bridge
Tenant validation	bypassed	✅ runs your existing required-field, regex, conditional logic
Tenant integrations	bypassed	✅ Zapier, ActiveCampaign, MailChimp, etc. fire as-is
Tenant notification emails	bypassed	✅ “New form entry” emails go out as before
Audit trail	Animam-side only	both sides
Migration risk	high (re-wire automations)	zero

Per-form whitelist (opt-in)

The bridge is opt-in per form: nothing is exposed until the tenant explicitly whitelists a form in Settings → Animam → WPForms bridge. Only whitelisted forms get a wp_submit_wpforms_{id} tool; everything else is invisible to the agent. This keeps out of reach:

Forms that gate sensitive content (DSAR requests, support tickets requiring human triage).
Forms with payment fields (use the WooCommerce bridge or COLLECT_PAYMENT instead).
Forms behind a manual review queue.

Plan

Bridges require the Visitors plan (€19/month) or higher — the bridges capability. See WordPress pricing.