Centous Integration for Brevo with Contact Form 7 and WPForms

Description

Centous Integration for Brevo allows you to seamlessly connect Contact Form 7 and WPForms submissions with brevo.com CRM.

Using this plugin, submissions from your WordPress forms can be automatically sent to brevo.com as Contacts, Companies, or Deals. This helps you manage leads and customer data efficiently without manual entry.

Key Features:

Support for two popular WordPress form plugins:
– Contact Form 7 integration
– WPForms integration

Brevo object support:
– Contacts
– Companies
– Deals

Core features:
– Secure OAuth 2.0 authentication with brevo.com
– Create and manage multiple form-to-brevo integrations
– Advanced field mapping between form fields and brevo properties
– Test connection and verify brevo credentials
– Add notes to brevo records from WordPress logs
– Comprehensive API request/response logging
– Detailed error tracking and debugging tools
– Optional clean uninstall (remove plugin data)
– Restructured architecture for better performance and maintainability

Usage

Basic Setup

1. Connect your brevo.com account from plugin settings
2. Install and activate your preferred form plugin (Contact Form 7, WPForms, or both)
3. Create a new integration feed
4. Select your form (CF7 or WPForms)
5. Select the brevo object (Contact, Company, or Deal)
6. Map form fields to brevo properties
7. Save the integration
8. Form submissions will now be sent to brevo automatically

Contact Form 7 Integration

1. Ensure Contact Form 7 is installed and activated
2. Create a Contact Form 7 form or use an existing one
3. Go to Brevo Connect → Feeds
4. Click Add New Feed
5. Under “Form Type”, select Contact Form 7
6. Select your Contact Form 7 form from the dropdown
7. Configure field mapping (see Field Mapping section below)
8. Save the feed

WPForms Integration

1. Ensure WPForms plugin is installed and activated
2. Create a WPForms form or use an existing one
3. Go to Brevo Connect → Feeds
4. Click Add New Feed
5. Under “Form Type”, select WPForms
6. Select your WPForms form from the dropdown
7. Configure field mapping (see Field Mapping section below)
8. Save the feed

Configuration

The plugin uses a modernized feed-based configuration system, allowing you to control which forms send data to brevo and how the data is mapped.

Plugin Menu Structure

After activation, a new admin menu appears:

Brevo Connect
– Brevo Connect (Account Setup)
– Test Connection
– Integrations/Feeds
– Logs
– Settings

1. Brevo Connect (Account Setup)

2. Go to Brevo Connect → Brevo Connect

3. Enter brevo OAuth credentials:
   • Client ID
   • Client Secret
   • Redirect URL
4. Click Connect Account
5. Log in to brevo.com and approve access
6. Your account details will appear after successful connection

7. View your Brevo Account ID and linked email

8. Test Connection

9. Navigate to Brevo Connect → Test Connection

10. Click Test Connection

11. The plugin verifies:

    • OAuth authentication validity
    • Access token status
    • brevo API connectivity
    • Account permissions

12. Integrations/Feeds

Integrations (feeds) control how form submissions are sent to brevo.

Create a New Integration

1. Go to Brevo Connect → Integrations
2. Click Add New Integration
3. Configure the following:

a) Select Form Type
Choose which form plugin to integrate:
– Contact Form 7
– WPForms

b) Select Form
Choose the specific form from your selected form plugin.

c) Select brevo Object Type
Choose where to send data:
– Contacts – Create or update contact records
– Companies – Create or update company records
– Deals – Create or update deal records

d) Field Mapping

Map your form fields to brevo properties.

Contact Form 7 Example:
– Email → [email* your-email]
– First Name → [text first-name]
– Last Name → [text last-name]
– Phone → [tel your-phone]
– Company → [text company-name]
– Message → [textarea your-message]

WPForms Example:
– Email → Email field (Field ID)
– First Name → Name field (Field ID)
– Phone → Phone field (Field ID)
– Message → Message/Textarea field (Field ID)

e) Conditional Logic (if applicable)
– Set conditions to send data only when specific criteria are met
– Examples: Send to Brevo only if a checkbox is checked, select field has specific value, etc.

f) Integration Status
– Enable or disable integration using the Active/Inactive toggle
– Only active integrations send data to brevo

Manage Integrations

• Edit – Modify existing integration settings
• Test – Send a test submission to verify the integration
• Duplicate – Clone an existing integration for quick setup
• Delete – Remove an integration
• View Logs – Check logs specific to this integration

1. Logs

2. Go to Brevo Connect → Logs

3. View comprehensive logs including:

   • API requests sent to brevo
   • API responses from brevo
   • Error messages and debugging information
   • Timestamp of each submission attempt
   • Integration/form associated with the submission
   • Submission status (success/failed)

4. Features:

   • Filter logs by integration, date range, or status
   • Add notes to brevo records directly from log entries
   • Export logs for external analysis
   • Search functionality for quick troubleshooting

5. Settings

6. Navigate to Brevo Connect → Settings

7. Configure:

   • Logging: Enable/disable detailed logging
   • Log Retention: Set how long logs are kept (7, 14, 30, 90 days, or indefinite)
   • Data on Uninstall: Choose whether to delete all plugin data when uninstalling
   • API Retry: Configure automatic retry attempts for failed submissions
   • Timeout Settings: Adjust API request timeout values

8. Save changes

External Services

This plugin integrates with brevo.com APIs for CRM functionality.

Data Flow

1. Create / Update Records
   Uses brevo.com REST API (v3) to create or update Contacts, Companies, or Deals.

2. OAuth Authentication
   Uses brevo.com OAuth 2.0 endpoints to authorize and refresh access tokens securely.

3. Retrieve Account Information
   Fetches account details to verify a valid brevo connection.

4. Create Notes on Records
   Adds notes to brevo items from plugin logs when manually triggered.

5. Data Transmission
   Form data such as name, email, phone, and mapped custom fields is sent securely over HTTPS when a form is submitted.

6. Privacy & Compliance
   Site owners are responsible for GDPR, CCPA, and other legal compliance when sending personal data to brevo.com.

7. brevo.com Policies
   By using this plugin, you agree to brevo.com’s policies:

   • Privacy Policy: https://brevo.com/legal/privacy-policy
   • Terms of Service: https://brevo.com/legal/terms

Supported Forms

Contact Form 7 – Popular, lightweight contact form plugin
WPForms – Drag-and-drop form builder with advanced features

You can integrate multiple forms from either plugin or both simultaneously.

Plugin Features

• Support for two popular WordPress form plugins
• Automatically create brevo Contacts, Companies, or Deals
• OAuth 2.0 authentication setup within WordPress
• Advanced field mapping system
• Multiple integration feeds per form
• Add notes to brevo records from logs
• Detailed logging and error tracking
• Test integration before going live
• Conditional submission logic
• Bulk integration management
• Export/import integration settings

Support

For support, feature requests, or bug reports, contact Centous at:
https://centousplugins.com/contact-us/

Author

Centous
Website: https://www.centous.com/
Email: support@centous.com

Additional Resources

Brevo API Documentation: https://developer.brevo.com/
Contact Form 7 Plugin: https://wordpress.org/plugins/contact-form-7/
WPForms Plugin: https://wpforms.com/
WordPress Plugin Development: https://developer.wordpress.org/plugins/

License

This plugin is licensed under the GPLv3 or later.
See https://www.gnu.org/licenses/gpl-3.0.html for more details.