How can we help you?

1. Overview & System Requirements

The Gravity Forms Bitrix24 CRM Integration Setup Guide connects your WordPress forms directly to Bitrix24—the all-in-one CRM, project management, and business communication platform used by over 12 million organizations worldwide. For commercial teams managing high-volume inbound leads, dealer inquiries, wholesale registrations, or support tickets, manually inputting entries into Bitrix24 creates operational friction and slows sales response times.

With this dedicated integration, every submission on your website immediately creates or updates records inside Bitrix24. You can configure feeds to create Leads (crm.lead.add), commercial Deals (crm.deal.add), individual Contacts (crm.contact.add), or corporate Companies (crm.company.add). Communicating directly with the Bitrix24 REST API via secure Inbound Webhooks, data transfers occur in real time with zero monthly middleware fees.

2. Authentication & Bitrix24 Inbound Webhook Setup

The integration communicates with Bitrix24 using secure Inbound REST Webhook endpoints:

Creating Your Inbound Webhook in Bitrix24

1. Log in to your Bitrix24 portal (e.g. https://yourcompany.bitrix24.com).
2. In the left sidebar, navigate to Developer resources → Other → Inbound webhook.
3. Under Assign permissions, select CRM (crm).
4. Click Save. Bitrix24 generates an Inbound Webhook URL (format: https://yourcompany.bitrix24.com/rest/1/xxxxxxxxxxxx/).
5. Copy this complete Webhook URL to your clipboard.

Configuring in WordPress Dashboard

1. In WordPress, navigate to Forms → Settings → Bitrix24.
2. Paste your complete Inbound Webhook URL into the designated field.
3. Click Save Settings. The plugin sends an authenticated test request to the Bitrix24 API to verify permissions. A green success confirmation verifies proper connection.

3. Feed Configuration & Field Mapping

Feeds allow you to configure custom entity creation, field mapping, and pipeline staging for each form:

Entity Selection & Core Field Mapping

• Target Entity: Choose whether the feed creates a Lead, Deal, Contact, or Company.
• Lead/Deal Title: Define dynamic titles using Gravity Forms merge tags (e.g. Website Lead: {Name:2} - {Company:4}).
• Contact Details: Map First Name, Last Name, Work Email, and Telephone Number. Bitrix24 stores multi-channel contact arrays automatically.
• Opportunity Value: For Deals or Leads, map form budget inputs to the OPPORTUNITY monetary amount and select the currency code (USD, EUR).
• Comments & Descriptions: Map the user inquiry message into the COMMENTS field using HTML formatting.

Bitrix24 Custom Fields & Conditional Logic

Bitrix24 allows users to define custom CRM fields (e.g. UF_CRM_...). The add-on features a dynamic mapper:

• Custom Fields: Map form choices (such as preferred appointment time, branch location, or referral source) directly to Bitrix24 user fields.
• Conditional Execution: Only trigger feed execution when specific criteria are met—for instance, creating Deals only when users select “Request an Enterprise Quote”.

4. Advanced Workflows & CRM Pipeline Automation

Connecting Gravity Forms to Bitrix24 empowers sales and customer service operations:

• Kanban Pipeline Automation: High-intent web leads immediately enter the “Unassigned” stage of your Bitrix24 CRM Kanban board, alerting on-duty sales reps.
• Automated Contact & Company Linking: Use dual feeds to create both a corporate Company record and an individual Contact record, automatically establishing parent-child relationships in Bitrix24.
• Telephony & SMS Integration: Newly added Bitrix24 leads immediately sync with Bitrix24 telephony and SMS robots for automated immediate callback scheduling.
• Audit Trail in WordPress: Every submitted entry stores the returned Bitrix24 Entity ID directly inside the Gravity Forms Entry Notes sidebar for complete auditability.

5. Troubleshooting & Diagnostic Error Matrix

When contact synchronization or lead creation encounters issues, consult the following diagnostic matrix:

6. Developer Extensibility & Filter Hooks

Developers can programmatically modify CRM payloads or execute custom actions upon successful synchronization:

/**
 * Filter: gform_bitrix24_request_data
 * Purpose: Dynamically customize field data before posting to Bitrix24 REST API.
 * 
 * @param array  $fields The array of CRM fields destined for crm.lead.add or crm.deal.add.
 * @param string $entity The target entity ('lead', 'deal', 'contact', 'company').
 * @param array  $entry  The submitted Gravity Forms entry object.
 * @param array  $form   The active form object.
 * @return array Modified fields array.
 */
add_filter( 'gform_bitrix24_request_data', function( $fields, $entity, $entry, $form ) {
    // Set lead source description
    $fields['SOURCE_DESCRIPTION'] = sprintf( 'Submitted via %s on %s', esc_html( $form['title'] ), current_time( 'Y-m-d H:i' ) );

    // Enforce default status for inbound leads
    if ( $entity === 'lead' ) {
        $fields['STATUS_ID'] = 'NEW';
    }

    return $fields;
}, 10, 4 );

/**
 * Action: gform_bitrix24_post_process
 * Purpose: Record returned Bitrix24 Entity ID into entry metadata.
 * 
 * @param string $entity    The CRM entity type ('lead', 'deal', 'contact').
 * @param int    $entity_id The created Bitrix24 entity ID.
 * @param array  $entry     The active Gravity Forms entry.
 */
add_action( 'gform_bitrix24_post_process', function( $entity, $entity_id, $entry ) {
    if ( ! empty( $entity_id ) ) {
        gform_update_meta( $entry['id'], '_bitrix24_' . $entity . '_id', intval( $entity_id ) );
        GFFormsModel::add_note( $entry['id'], 0, 'Bitrix24', ucfirst( $entity ) . ' created in Bitrix24. ID: ' . $entity_id );
    }
}, 10, 3 );

7. Frequently Asked Questions