MirooCRM Sync for Contact Form 7

Sync Contact Form 7 submissions to MirooCRM as customers and contacts via API, server-side, with selectable forms and configurable mapping.

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:

1. A Customer record, with the form message stored in notes and the lead_source field filled in (default: “CF7 Sito”).
2. 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.

What data is sent, and when: when a visitor successfully submits one of the CF7 forms you enabled in the plugin settings, the plugin sends the mapped submission fields (such as name, surname, email, phone, message and company) to the MirooCRM REST API endpoint you configure (for example https://app.miroocrm.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.