Importing Leads

Import your existing lead lists into MessengerFlow for use in campaigns.

Import Methods

Manual Entry

Add leads one at a time or paste a list:

1. Navigate to Leads
2. Click Import Leads
3. Enter a collection name
4. Add leads in the format:

   FacebookID, Name
   FacebookID, Name
   

5. Click Import

CSV Upload

Upload leads from a CSV file:

1. Prepare your CSV with columns:
   • id - Facebook ID (required)
   • name - Lead name (optional)
2. Navigate to Leads
3. Click Import Leads
4. Select your CSV file
5. Map columns to fields
6. Click Import

Data Format

Facebook ID

The Facebook ID is a numeric identifier:

• Found in profile URLs: facebook.com/profile.php?id=123456789
• Or in the page source of profiles
• Usernames are not accepted, only numeric IDs

Required Format

Each lead needs at minimum:

{
  "id": "123456789",
  "name": "John Smith"  // optional
}

CSV Example

id,name
123456789,John Smith
987654321,Jane Doe
456789123,Bob Johnson

Import Limits

Your subscription may limit total import collections.

Deduplication

MessengerFlow automatically removes duplicates:

• Same ID appearing multiple times in one import
• Keeps the first occurrence
• Reports duplicate count after import

Validating Leads

Before importing, ensure:

• IDs are valid Facebook user IDs
• No invalid characters in data
• Proper CSV formatting

Invalid entries are skipped during import.

After Import

Once imported:

• Collection appears in Leads list
• Lead count reflects deduplicated total
• Collection is ready for campaigns

Export and Re-import

You can export leads from any collection:

1. Open the collection
2. Click Export
3. Download CSV

This allows:

• Backing up lead data
• Combining collections externally
• Re-importing filtered subsets

Troubleshooting

Import Failed

• Check CSV format is valid
• Ensure IDs are numeric
• Verify file encoding (UTF-8 recommended)

Low Lead Count

• Duplicates were removed
• Invalid IDs were skipped
• Check source data quality

Missing Names

• Names are optional
• Messages can still use spintax fallbacks
• Consider scraping for name data