Convertr Help Centre Help Center home page
Submit a request
Sign in
  1. Convertr Help Centre
  2. Product
  3. Leads - Management

Convertr Connect Soft Check Workflow Follow

 

Overview

With the introduction of Soft Check in Convertr Connect, lead troubleshooting ownership has shifted.

  • Before: Receiving enterprise investigated failed leads
  • Now: Sending enterprise (lead provider) initiates the troubleshooting process and must provide full lead details.  This allows the partners to be more proactive in the troubleshooting process.

Convertr Connect: Soft Check - New Troubleshooting Workflow

Step Workflow What Happens Owner
1

Lead is flagged 

- Soft check fails

A Lead Flag is generated.

It includes the Soft Check reason, Job ID, and Error Label.  

The lead is NOT delivered.  The receiving enterprise cannot see the lead data.

QA Flags
2 Capture error details

In Convertr, copy:

Lead Hash, Job ID and Lead Flag 

(Soft Check error message & label)

Sending Enterprise - Lead Provider/Partner
3 Review QuickSight Dashboard

Use the Quicksight dashboard to:

  • See patterns and summary of failed leads
  • Understand why leads are being rejected
  • Validate against expected campaign logic
Sending Enterprise - Lead Provider/Partner
4 Validate against campaign requirements

Compare what was submitted vs. what the receiving enterprise expects.  Check for:

  • Field mismatches
  • Missing required values
  • Formatting issues
  • Validation rule conflicts
  • Value Transforms
Sending Enterprise - Lead Provider/Partner
5 Send troubleshooting details to receiving Enterprise

Proactively reach out and include:

  • Lead Hash
  • Job ID
  • Full Lead Flag / Error Message
  • QuickSight export or supporting notes

*Provide full context upfront - do not ask the receiving enterprise to look up the lead.*

Sending Enterprise - Lead Provider/Partner
6 Receiving Enterprise reviews and validates

Using the Job ID, they will:

  • Review job configuration
  • Compare against expected campaign logic
  • Confirm correct setup or identify mismatched values
Brand or Agency Platform Contact
7 Resolution

Configuration Issue - 

Receiving Enterprise updates campaign logic if needed.

Data Issue - 

Sending Enterprise correct lead submission values.

Brand or Agency Platform Contact
Sending Enterprise - Lead Provider/Partner
8 Retest & Confirm

Resubmit the lead (if applicable)

Confirm successful delivery.

Monitor for repeat failures.

Sending Enterprise - Lead Provider/Partner

 

What Happens When a Lead Fails Soft Check

  1. A Lead Flag is generated in the platform
  2. The flag includes:
    • Soft Check failure reason
    • Job ID
    • Error label / validation message
  3. The lead is not delivered to the receiving platform
  4. The receiving enterprise has no visibility into the lead
  5. The sending enterprise must initiate and drive resolution

Workflow Process:

1. Identify the Failed Lead
  • Locate the lead in Convertr
  • Confirm it was flagged due to Soft Check
2. Capture Error Details 

Copy the following directly from the platform using the copy icon on the top right of the dialogue box:

  • Lead Hash
  • Job ID
  • Lead Flag (error message + reason)

*If Step 2 produces results, proceed to Step 3.

3. Review QuickSight Dashboard (If necessary) (Refreshed every hour)

It is the Partner’s responsibility to validate against expected campaign logic before reaching out to the customer.

Use the QuickSight dashboard to:

  • Identify patterns in failures, rather than looking at leads individually.
  • Understand why leads are being rejected
4. Validate Against Campaign Requirements

Compare:

  • What was submitted in the lead
    vs.
  • What the receiving enterprise expects

Look for:

  • Field mismatches
  • Formatting issues
  • Missing required values
  • Validation rule conflicts
  • Value Transforms 
    • If Value Transforms are the only reason for the failures, push the lead through as best practice.
    • How to Reprocess a Lead
5. Send Troubleshooting Details to Receiving Enterprise

The sending enterprise must proactively reach out and include:

Required in communication:

  • Lead Hash
  • Job ID
  • Full Lead Flag / Error Message
  • Supporting details (QuickSight export or notes from QA flags)

Note: This replaces the old “Can you check this lead?” approach — the expectation is fully informed troubleshooting context is provided upfront

6. Brand or Agency Main Contact Review

Using the Job ID, the receiving enterprise will:

  • Confirm:
    • Correct setup, or
    • If the values provided indicated in the lead flag details are a mismatch against what was submitted.
  • Review job configuration
  • Compare against expected campaign logic
7. Resolution Path

Two possible outcomes:

A. Configuration Issue

  • Receiving enterprise updates campaign logic if needed

B. Data Issue

  • Sending enterprise corrects lead submission values

C. If both A & B are confirmed, please open a support ticket.

8. Retest Lead Flow
  • Resubmit leads
    • Convertr best practice is to resubmit 1-2 leads, limiting reprocessing
  • Confirm successful delivery
  • Monitor for repeat failures as needed


    Support Is Available - Convertr Support Team can assist with troubleshooting, validate configurations, and provide guidance.  Engage support if the root cause is unclear or if the issue persists.

Articles in this section

  • Returned Leads in The Convertr Platform
  • Convertr Connect Soft Check Workflow
  • Custom Returned Lead Flags
  • Replacement Leads In The Convertr Platform
  • Lead Export
  • Selecting Delimiters when Importing
  • Introduction to Bulk Editing
  • Bulk Lead Editing - Call Centre Users
  • Bulk Lead Editing - Publisher User
  • Bulk Lead Editing - Admin/Agency User
See more

Related articles

  • Global Forms
  • Configuring Convertr Connect in your Campaign
  • Convertr Connect: Integration
  • Adding your Convertr Connect Credentials
  • How to Duplicate a Campaign
Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request
Return to top

Related articles

  • Global Forms
  • Configuring Convertr Connect in your Campaign
  • Convertr Connect: Integration
  • Adding your Convertr Connect Credentials
  • How to Duplicate a Campaign
Convertr