How can we help you?

1. Overview & System Requirements

The Gravity Forms WhatsApp Integration Premium Add-on connects your WordPress forms directly to the WhatsApp Business Cloud API. With open rates exceeding 98% and average response times under 90 seconds, WhatsApp is the world’s most effective messaging channel for business-to-consumer communication. Relying exclusively on email notifications for urgent customer inquiries or order confirmations frequently leads to missed opportunities and spam filter issues.

With this integration, every form submission on your website can trigger real-time, automated WhatsApp notifications directly to the submitter’s mobile phone or your internal team’s dispatch numbers. Utilizing official Meta pre-approved template messages, you can dynamically insert customer names, booking dates, appointment times, order numbers, and tracking links into personalized messages. Operating directly over Meta’s Graph API infrastructure, notifications arrive within seconds with enterprise reliability.

2. Authentication & Meta Cloud API Credentials Setup

The integration communicates with Meta’s official WhatsApp Business Cloud API via Graph API endpoints:

Obtaining Meta WhatsApp API Credentials

1. Log in to the Meta for Developers Portal at developers.facebook.com.
2. Navigate to My Apps and select your WhatsApp Business App.
3. Under the left sidebar, click WhatsApp → API Setup.
4. Copy your Phone Number ID and WhatsApp Business Account ID.
5. In Business Manager Settings, navigate to System Users, generate a Permanent Access Token with whatsapp_business_messaging and whatsapp_business_management scopes, and copy the token string.

Configuring in WordPress Dashboard

1. In WordPress, navigate to Forms → Settings → WhatsApp.
2. Enter your Phone Number ID, WhatsApp Business Account ID, and paste your Permanent Access Token.
3. Click Test Connection. The system verifies API connectivity and fetches your registered WhatsApp templates. A green success message will confirm validation.
4. Click Save Settings.

3. Feed Configuration & Template Mapping

Feeds allow you to configure custom WhatsApp outbound notifications for each form across your site:

Recipient Phone & Template Selection

• Recipient Phone Number: Map the user’s phone field or enter a static administrative number. Numbers must include the international country code (e.g. +1 for USA, +44 for UK).
• Template Selection: Choose from your Meta pre-approved WhatsApp message templates (e.g. booking_confirmation, lead_notification, order_alert).
• Language Code: Select the template language (e.g. en_US, es_ES, fr_FR).

Dynamic Variable Parameter Mapping

Meta templates use positional parameters (such as {1}, {2}). The add-on features an intuitive variable mapper:

• Variable Mapping Table: Map parameter {1} to Customer First Name, {2} to Appointment Date, and {3} to Service Package.
• Media Headers: If your template includes an image or document header, map a form file upload field or provide an image URL.
• Conditional Logic: Enable conditional rules so WhatsApp messages only dispatch when users explicitly opt-in or select WhatsApp as their preferred contact method.

4. Advanced Workflows & Customer Engagement

Deploying WhatsApp with Gravity Forms transforms customer responsiveness:

• Immediate Booking Confirmations: Medical clinics, salons, and consultants provide instant confirmation with appointment details and Google Maps directions via WhatsApp seconds after booking.
• VIP Lead Dispatch: Alert sales representatives on their mobile WhatsApp within seconds of high-value prospects submitting an enterprise RFP.
• Interactive Quick Reply Buttons: Meta templates featuring Call-to-Action or Quick Reply buttons allow customers to confirm attendance with one tap directly in WhatsApp.
• Audit Trail in WordPress: Every submitted entry stores the returned Meta Message ID and delivery status inside the Gravity Forms Entry Notes sidebar.

5. Troubleshooting & Diagnostic Error Matrix

When WhatsApp message delivery encounters issues, consult the following diagnostic matrix:

6. Developer Extensibility & Filter Hooks

Developers can programmatically modify WhatsApp message payloads or execute custom actions upon successful transmission:

/**
 * Filter: gform_whatsapp_message_payload
 * Purpose: Dynamically filter WhatsApp message payload prior to sending to Meta Cloud API.
 * 
 * @param array $payload The formatted API request body destined for /messages.
 * @param array $feed    The Gravity Forms WhatsApp feed settings.
 * @param array $entry   The submitted Gravity Forms entry object.
 * @param array $form    The active form object.
 * @return array Modified message payload.
 */
add_filter( 'gform_whatsapp_message_payload', function( $payload, $feed, $entry, $form ) {
    // Sanitize phone number to strictly digits
    if ( ! empty( $payload['to'] ) ) {
        $payload['to'] = preg_replace( '/[^0-9]/', '', $payload['to'] );
    }

    return $payload;
}, 10, 4 );

/**
 * Action: gform_whatsapp_post_message_send
 * Purpose: Record returned Meta WhatsApp Message ID into entry metadata.
 * 
 * @param string $message_id The created WhatsApp Message ID.
 * @param array  $entry      The active Gravity Forms entry.
 * @param array  $form       The form object.
 */
add_action( 'gform_whatsapp_post_message_send', function( $message_id, $entry, $form ) {
    if ( ! empty( $message_id ) ) {
        gform_update_meta( $entry['id'], '_whatsapp_message_id', sanitize_text_field( $message_id ) );
        GFFormsModel::add_note( $entry['id'], 0, 'WhatsApp', 'Message dispatched via WhatsApp. ID: ' . $message_id );
    }
}, 10, 3 );

7. Frequently Asked Questions