How to Integrate Contact Form 7 with Hunter Lead Module

Introduction

Integrating Contact Form 7 with Hunter Lead module helps your lead management process by automatically sending form submissions directly to Hunter. This integration saves time, reduces manual data entry errors, and ensures that your leads are efficiently captured and managed in your CRM.

What is hunter.io?

Hunter is your all-in-one email outreach platform and help you find and connect with the people that matter to your business.

Why Integrate Contact Form 7 with Hunter

Contact Form 7 is a widely-used WordPress plugin for creating and managing contact forms. However, manually transferring form submissions to your CRM can be time-consuming and possibilities of errors. By integrating Contact Form 7 with Hunter, you can automate this process, ensuring all form data is accurately captured and stored in your CRM for future reference.

Features

• Capture Contact Form 7 submissions: Automatically collect form data.
• Send form data to Hunter via API: Seamless integration with Hunter.io’s API.
• Admin settings page: Easily manage and store your Hunter API key.

Below are the steps to integrate Contact Form7 with Hunter:

Step 1: Install and Activate Contact Form 7

2. Create or Use Existing Form:

1. Create a new form or edit an existing one using Contact Form 7.
2. Define fields such as your-name, your-email, your-message, etc., as needed for your lead capture.

Step 2: Set Up Plugin Files and Settings

1. Create Plugin Directory and Files:

1. Navigate to wp-content/plugins/ and create a new folder named cf7-to-hunter-lead-integrator.
2. Inside this folder, create the following files:

• cf7-to-hunter-lead-integrator.php
• settings.php
• Api-hunter.php

2. Plugin Header (cf7-to-hunter-lead-integrator.php):

<?php
/*
* Plugin Name: Contact Form 7 to Hunter Lead Integrator
* Description: Integrates Contact Form 7 with Hunter's lead module.
* Version: 1.0.0
* Author: Your Name
* Text Domain: cf7-hunter
*/
if (!defined('ABSPATH')) {
    exit;
}
// Include necessary files
require_once plugin_dir_path(__FILE__) . '/settings.php';
require_once plugin_dir_path(__FILE__) . '/api-hunter.php';
?>

3. Add Settings Menu & Display Settings Page (settings.php):

<?php
// Add settings menu
add_action('admin_menu', 'hunter_settings_menu');
function hunter_settings_menu() {
    add_options_page(
        __('Hunter Settings', 'cf7-hunter'),
        __('Hunter', 'cf7-hunter'),
        'manage_options',
        'hunter-settings',
        'hunter_settings_page'
    );
}

// Display settings page
function hunter_settings_page() {
    ?>
    <div class="wrap">
        <h1><?php echo esc_html__('Hunter Settings', 'cf7-hunter'); ?></h1>
        <form method="post" action="options.php">
            <?php
            settings_fields('hunter_settings_group');
            do_settings_sections('hunter-settings');
            submit_button();
            ?>
        </form>
    </div>
    <?php
}
// Register settings
add_action('admin_init', 'hunter_register_settings');
function hunter_register_settings() {
    register_setting('hunter_settings_group', 'hunter_api_key', 'hunter_validate_api_key');

    add_settings_section(
        'hunter_settings_section',
        __('API Settings', 'cf7-hunter'),
        'hunter_settings_section_callback',
        'hunter-settings'
    );

    add_settings_field(
        'hunter_api_key',
        __('Hunter API Key', 'cf7-hunter'),
        'hunter_api_key_callback',
        'hunter-settings',
        'hunter_settings_section'
    );
}

function hunter_settings_section_callback() {
    echo esc_html__('Enter your Hunter API key below:', 'cf7-hunter');
}

function hunter_api_key_callback() {
    $api_key = get_option('hunter_api_key');
    echo '<input type="text" name="hunter_api_key" value="' . esc_attr($api_key) . '" class="regular-text">';
}

function hunter_validate_api_key($input) {
    if (empty($input)) {
        add_settings_error(
            'hunter_api_key',
            'hunter_api_key_error',
            __('Hunter API key is required.', 'cf7-hunter'),
            'error'
        );
        return get_option('hunter_api_key'); // Return the previous value to prevent updating with an empty value
    }
    return sanitize_text_field($input);
}
?>

Step 3: Capture and Send Form Data to Hunter (api-hunter.php)

• Retrieve Form Data After Submission:– Utilize the `wpcf7_mail_sent` hook to capture form data once the email is sent. This hook allows executing a custom function after the form submission is completed.

<?php
// Capture Form Submission
add_action('wpcf7_mail_sent', 'cf7_to_hunter_integration');
function cf7_to_hunter_integration($contact_form) {
    $api_key = get_option('hunter_api_key'); // Retrieve API key from options

    $submission = WPCF7_Submission::get_instance();

    if ($submission) {
        $posted_data = $submission->get_posted_data();

        // Map form fields to Hunter API fields
        $hunter_data = array(
            'first_name' => isset($posted_data['your-name']) ? sanitize_text_field($posted_data['your-name']) : '',
            'last_name' => isset($posted_data['your-lastname']) ? sanitize_text_field($posted_data['your-lastname']) : '',
            'email' => isset($posted_data['your-email']) ? sanitize_email($posted_data['your-email']) : '',
            // Add more fields as needed
        );

        // Call function to send data to Hunter
        cf7_to_hunter_send($hunter_data);
    }
}

// Send Data to Hunter
function cf7_to_hunter_send($hunter_data) {
    $api_key = get_option('hunter_api_key'); // Retrieve API key from options
    $api_url = 'https://api.hunter.io/v2/leads?api_key=' . $api_key; // Hunter.io API endpoint for leads

    // Set up the request
    $args = array(
        'body' => json_encode($hunter_data),
        'headers' => array(
            'Content-Type' => 'application/json',
            'Authorization' => 'Bearer ' . $api_key
        ),
        'method' => 'POST'
    );

    // Send the request to Hunter
    $response = wp_remote_post($api_url, $args);

    // Handle response if needed
}
?>

Usage and Configuration

1. Obtain Hunter API Credentials:

• Log in to your Hunter.io account or sign up to retrieve your API key.
• The API key is essential for your WordPress site to communicate with Hunter.io via their API.

2. Install and Activate the Plugin:

• Navigate to Plugins > Installed Plugins in your WordPress admin.
• Find “Contact Form 7 to Hunter Lead Integrator” and click Activate.

3. Configure Plugin Settings:

• Go to Settings > Hunter in your WordPress dashboard.
• Enter your Hunter API key into the provided field and save the settings.

4. Test Integration:

• Create or edit a Contact Form 7 form on your website.
• Ensure that the field names (your-name, your-email, etc.) in Contact Form 7 match those expected by the plugin.
• Submit the form to verify that the data is successfully sent to Hunter.io.

Additional Tips

Handle Missing API Key:

• Implement error handling in your plugin to notify users if the Hunter API key is missing or incorrectly configured.
• For example, display a message such as “Hunter API key is required” if the API key field is empty.