About this plugin
MirooCRM Sync for Contact Form 7 listens to the Contact Form 7 wpcf7_mail_sent hook and, for the forms you select in the plugin settings, creates the following on MirooCRM:
- A Customer record, with the form message stored in notes and the lead_source field filled in (default: “CF7 Sito”).
- A Contact linked to that customer, with name, surname, email and phone taken from the CF7 fields.
The MirooCRM JWT token always stays on the WordPress server: it is never exposed to the browser.
Features
- Settings page under Settings → MirooCRM Sync for Contact Form 7 for API URL, JWT and lead source.
- Explicit selection of the CF7 forms to sync: forms that are not selected are ignored.
- Configurable CF7 → MirooCRM field mapping from the admin.
- Asynchronous sync via WP-Cron: the submission responds immediately and the API calls run in the background. Can be disabled with the miroocrm_cf7_async filter.
- JWT token encrypted at rest (AES-256-GCM with a key derived from the WordPress salts) and never printed back to the browser.
- Duplicate-submission guard: identical submissions sent in quick succession are ignored.
- Automatic retry on API calls in case of a network error or a 5xx/429 response.
- Admin-readable log with personal data masked; mirrored to error_log() when WP_DEBUG is enabled.
- WordPress filters for custom logic: miroocrm_cf7_field_map, miroocrm_cf7_customer_attrs, miroocrm_cf7_contact_attrs, miroocrm_cf7_async, miroocrm_cf7_dedup_ttl, miroocrm_cf7_http_timeout, miroocrm_cf7_http_retries, miroocrm_cf7_log_redact.
- Action hooks miroocrm_cf7_sync_success, miroocrm_cf7_sync_error, miroocrm_cf7_sync_partial.
Requirements
- Contact Form 7 active.
- A reachable MirooCRM API endpoint (e.g. https://app.miroocrm.com/api/v1 ).
- A MirooCRM Bearer JWT with permission to POST /customers and POST /contacts.
External services
This plugin connects to MirooCRM, a CRM service operated by Doozy Service Srl. It is used to turn the Contact Form 7 submissions you choose into CRM records: for each selected form it creates a customer and a linked contact in your MirooCRM account.
com/api/v1 ). Nothing is sent for forms that are not selected, and nothing is sent until an administrator has entered the API base URL and an API token. The token is stored on your server and is never sent to the browser.
Using the MirooCRM service requires a MirooCRM account; its terms of use are accepted when the account is created. Legal documents for the service:
- Privacy policy: https://miroocrm.it/privacy-policy/
- Cookie policy: https://miroocrm.it/cookie-policy/
The plugin does not communicate with any other external service.