Telesign Add‑On

Leandro
Leandro
  • Updated

Feature Snapshot

Summary:
The Telesign Add‑On leverages real‑time phone validation to verify that a submitted phone number is active and to append actionable, global phone number intelligence – including detailed risk ratings, phone type, carrier information, geolocation, subscriber status, and device status – into your LeadConduit flow.

Key Benefits:

  • Validates that phone numbers are active and correctly formatted
  • Provides comprehensive phone intelligence (e.g., risk rating, phone type, carrier, geolocation)
  • Helps identify fraudulent or disconnected numbers to improve lead quality
  • Informs dynamic decision making and filtering in your lead processing flow

Typical Use Cases:

  • Validating phone numbers during lead submission to ensure data accuracy
  • Filtering out leads with invalid, disconnected, or high‑risk phone numbers before costly processing
  • Enhancing lead routing and messaging by understanding phone type and geographical context
  • Enabling fraud detection and improved pricing decisions by incorporating detailed phone insights

How the Telesign Add‑On works?

When you add the Telesign Add‑On step to your LeadConduit flow, the add‑on cleans and reformats the submitted phone number and then sends it to Telesign’s Phone ID API for real‑time validation. The service returns a rich set of data—including validation outcome, risk rating, phone type, carrier information, and geolocation details—that is then appended to the lead. This appended information is used to filter out leads with poor quality phone data, flag disallowed phone types (such as payphones or pagers), and ultimately improve lead quality and pricing decisions.

Step‑by‑Step Instructions

  1. Edit Your Flow:
    Open your LeadConduit flow and navigate to the “Steps” tab.
  2. Add an Add‑On Step:
    Click the “Add Step” (+) button and select “Add‑On” from the available step types.
  3. Search for Telesign:
    In the Add‑On dialog, search for “Telesign Add‑On” (or “Telesign: Phone Validation”) and click “Add to Flow.”
  4. Review the Introduction Screen:
    A screen will display details on how the service works and the types of data it returns.
  5. Configure Phone Type Settings:
    Select the acceptable phone types (e.g., mobile, fixed, toll‑free) by checking the available options. This step ensures that disallowed types are properly filtered.
  6. Finish Configuration:
    Click “Finish” to save your add‑on step configuration.

Expected Result:
Your LeadConduit flow will now include the Telesign Add‑On step. When a lead is processed, the add‑on validates the phone number and appends data fields such as Outcome, Risk, Phone Type, Subscriber Status, Device Status, Carrier, and detailed geolocation information to the lead record.

📷 Screenshot Placeholder: [Insert UI image or GIF showing the Telesign configuration screen in LeadConduit]


Validation & Monitoring (optional)

  • Test the Setup:
    Submit a test lead with a correctly formatted phone number and check that the lead record shows appended Telesign data (e.g., Outcome, Risk, Phone Type, etc.).
  • Where to Monitor?:
    View the LeadConduit Events tab or your designated reporting dashboard to confirm that phone validation outcomes (such as “success”, “failure”, or “error”) are being logged properly.

Best Practices

  • Deploy Early in the Flow:
    Add the Telesign Add‑On as an early step to prevent low‑quality leads from consuming resources in downstream processes.
  • Review Appended Data Regularly:
    Periodically monitor the appended Telesign fields (like Risk and Outcome) to optimize filter thresholds and allowed phone type settings.
  • Configure Allowed Phone Types Mindfully:
    Tailor the phone type settings (mobile, fixed, prepaid, etc.) to match your business requirements and avoid processing leads with disallowed or risky phone numbers.
  • Leverage Data for Downstream Processes:
    Use the additional phone intelligence in routing, dynamic pricing, and fraud detection rules to improve overall lead quality.

Troubleshooting

Symptom / Error Likely Cause Resolution
No phone validation data appears The lead may be missing a properly formatted phone number or field mapping is incorrect Ensure the lead submission includes a valid phone number and verify that the phone field is correctly mapped in the flow.
Outcome returns “failure” or “error” The submitted phone number is invalid, missing, or Telesign encountered an error Check the phone number format, confirm that the correct phone type options are enabled, and review the “Reason” field for details.
Unexpected “risk” rating or ambiguous phone type The configuration of allowed phone types may not match business requirements or vendor data has updated Adjust the phone type settings in the add‑on configuration and consult Telesign documentation if needed.
Disallowed phone types (e.g., payphones) are not filtered out Phone type settings were not configured properly during setup Revisit step 5 in your configuration and ensure that disallowed phone types (such as payphones or pagers) are unchecked.

Frequently Asked Questions (FAQ)

Q: Can the Telesign Add‑On validate international phone numbers?
A: Yes. To validate non‑US numbers, be sure to enable the “Allow Non‑US” option (if available) and ensure that submitted phone numbers include the proper country code.

Q: What does the “Outcome” field indicate?
A: The Outcome field shows whether the validation was successful, failed, or resulted in an error. A “success” outcome means complete and valid data was returned, while “failure” or “error” indicates issues with the phone number submission.

Q: How do I adjust which phone types are accepted?
A: During the phone type settings configuration (step 5), simply check or uncheck the options for mobile, fixed, prepaid, toll‑free, etc., to tailor validation based on your requirements.

Q: How does the add‑on handle phone numbers that are disallowed (like payphones or pagers)?
A: The add‑on marks disallowed phone numbers as failures and returns an Outcome indicating that the phone type is not acceptable. You can then filter these leads out in your flow.


Glossary

Term Definition
Phone ID API Telesign’s API that cleans, verifies, and returns detailed information about the phone number submitted.
Outcome The result of the phone validation process, typically indicated as “success,” “failure,” or “error.”
Appended Data Additional fields (such as Risk, Phone Type, and Geolocation) returned by the Telesign Add‑On used for filtering and decision making.
Roaming Indicates whether the mobile device is currently operating outside its home network’s coverage area.
Device Status Reflects the current reachability status of the phone (e.g., reachable, unavailable, or unreachable).

Was this article helpful?

0 out of 0 found this helpful

Comments

0 comments

Please sign in to leave a comment.