Facebook Lead Forms

Guide: Connecting Facebook Lead Forms to DM Champ via Automation

Overview

This guide walks you through integrating Facebook Lead forms with DM Champ using an automation platform (like Pably). This integration allows you to automatically add Facebook leads to your DM Champ campaigns.

Prerequisites

• Facebook Ads Manager access

• DM Champ account with API access

• Automation platform account (e.g., Pably, Zapier, Make)

• A DM Champ campaign (either Combined or Outgoing)

Step 1: Create Your Facebook Lead Form

1. Navigate to Facebook Ads Manager

2. Create a new lead form with the following requirements:

   • Important: Set phone number as a required field (not optional)

   • Configure other fields as needed

Step 2: Test Your Facebook Form

1. Go to business.facebook.com/latest/instant_forms

2. Locate your newly created form

3. Click on the form, then click the "Test form" button

4. Keep this tab open - you'll need it later

Step 3: Set Up Your Automation Platform

1. Open your automation platform (e.g., Pably)

2. Create a new automation/workflow

3. Add Facebook Lead Ads as your trigger:

   • Look for "Facebook Lead Ads" integration

   • Select "New lead" as the trigger event

   • Note: You may need to try different Facebook integration options if the first one doesn't work

4. Select your Facebook page and the lead form you created

5. Verify the form name matches what you created in Step 1

Step 4: Test the Connection

1. In your automation platform, look for a button like "Test request" or "Wait for incoming response"

2. Return to the Facebook test form tab (from Step 2)

3. Fill out and submit the test form

4. The test data should appear in your automation platform

5. (Optional) Add a delay step to your automation if needed

Step 5: Configure DM Champ API Calls

You'll need to make two API calls to DM Champ:

API Call 1: Create Contact

Method: POST Endpoint: https://api.dmchamp.com/v1/contacts?apiKey=YOUR_API_KEY

Headers:

Content-Type: application/json

Body:

{
  "phone_number": "{phone_from_facebook}",
  "email": "{email_from_facebook}",
  "first_name": "{first_name_from_facebook}"
}

Map these fields from your Facebook lead form data. This call will return a contact ID.

API Call 2: Add Contact to List

Method: POST Endpoint: https://api.dmchamp.com/v1/contacts/lists?apiKey=YOUR_API_KEY

Headers:

Content-Type: application/json

Body:

{
  "contact_id": "{contact_id_from_previous_step}",
  "list_id": "YOUR_LIST_ID"
}

Step 6: Get Your List ID

The list ID depends on your campaign type:

For Combined Campaigns:

1. Create and launch a combined campaign in DM Champ

2. The system automatically creates a list

3. Go to the Contacts page

4. Find your list in the left sidebar

5. Click on it to reveal the List ID

6. Copy this ID for your API call

For Outgoing Campaigns:

1. When creating an outgoing campaign, enable "Activate on new contacts added to list"

2. This ensures the opening message sends when new contacts are added

3. Use the list ID associated with this campaign

Step 7: Test and Publish

1. Test the entire flow using your own phone number

2. Verify you receive messages in DM Champ

3. Once confirmed working, publish/activate your automation

Important Notes

• Always test with your own contact information first

• The phone number field must be required in your Facebook form

• Combined campaigns are recommended if you don't have an existing contact list

• Replace YOUR_API_KEY with your actual DM Champ API key in both endpoints

• For detailed API documentation, check the Help tab in DM Champ under "API"