Twilio

Overview

The Twilio integration for LeadExec provides real-time phone number validation using Twilio’s Phone Lookup API. This integration is designed to improve lead quality, reduce failed outreach attempts, and ensure compliance by automatically rejecting or flagging invalid or high-risk phone numbers as leads are ingested.

Key Features

• Real-Time Validation: Every phone number submitted to LeadExec is checked instantly using Twilio’s Lookup API.
• Line-Type & Carrier Detection: The API returns details such as validity, line type (mobile, landline, VoIP, toll-free), carrier, and country code.
• Automated Lead Filtering: Based on the validation response, leads can be accepted, rejected, or flagged according to configurable rules.
• Campaign-Level Control: The integration can be enabled or disabled per campaign, with flexible mapping of the phone field and custom response handling.
• Integration Criteria Builder: Exposes validation results (valid, type, carrier) for use in campaign logic, allowing granular control over lead acceptance and flagging.
• Comprehensive Logging: Full API responses are stored (with API keys masked) for 30 days, and key fields are surfaced in the LeadExec UI for inspection.
• Error Handling & Retries: Implements robust retry logic for quota and rate-limit errors, with exponential backoff and clear logging for all error types.

How It Works

1. Setup

   • Enter your Twilio API credentials in LeadExec’s global integration settings.
   • Enable Twilio validation for specific campaigns and map the phone field.

2. Execution Flow

   • When a lead is submitted, LeadExec calls the Twilio Lookup API:

     GET https://lookups.twilio.com/v2/phone_numbers/{phone_number}?Type=carrier

   • The API response is parsed for key fields:
     • valid (boolean or inferred from response)
     • line_type (e.g., mobile, landline, voip, toll_free)
     • carrier
     • country_code
   • Default decision logic:
     • If the number is invalid: Reject the lead.
     • If line_type is VoIP or Toll_Free: Flag the lead.
     • Otherwise: Accept the lead.

3. Error Handling

   • 400/401: Log and skip retry.
   • 429: Retry with backoff (up to 2-3 times).
   • 5xx: Exponential backoff, then flag if still failing.

Benefits

• Improved Lead Quality: Invalid and risky numbers are filtered out before delivery.
• Reduced Compliance Risk: Flags VoIP and toll-free numbers to help manage TCPA and carrier compliance.
• Operational Efficiency: Reduces wasted outreach and carrier costs by ensuring only valid numbers are processed.

References

• Twilio Phone Lookup API Documentation