Setting Up IPQualityScore Phone Number Validation Webhook

The IPQualityScore integration validates phone numbers in real-time, providing fraud detection, carrier information, and reputation scoring to help identify high-risk numbers and improve lead quality.

Prerequisites

Before setting up your webhook, you'll need:

• An active IPQualityScore account
• API key from your IPQualityScore dashboard
• Premium account access for advanced validation features

Setup Process

1. Get Your API Key

1. Log into your IPQualityScore account
2. Navigate to your account settings or dashboard
3. Find the API section and copy your API key
4. Ensure your account has phone validation credits available

2. Create New Webhook

1. Navigate to Integrations → Webhooks
2. Click + New Webhook
3. Select Data Collection template type
4. Choose IPQualityScore Phone Number from the dropdown

3. Basic Configuration

1. API Key: Enter your IPQualityScore API key
2. Name: Give your webhook a name
3. Event: Select Call Completed
4. Click Save Webhook

4. Advanced Options

After saving, you can configure additional settings:

Dynamic Variables The system automatically maps call data to IPQualityScore validation:

• InboundNumber maps to the phone number parameter for validation

Request Structure The webhook sends a GET request to IPQualityScore's API with:

• Phone number for validation and analysis
• Your API key for authentication
• Request for comprehensive fraud and reputation scoring

Filtering

• Add filters using any system tag (InboundState, BuyerName, CampaignName, etc.)
• Use Equals conditions to control when validation occurs
• Combine conditions with Add Or Rule or Add And Rule

Value Extraction After running a webhook test to discover response properties:

1. Select response properties like fraud_score, valid, carrier, line_type, etc.
2. Map them to custom tags for advanced routing and lead qualification
3. Use extracted data to automatically filter high-risk or invalid numbers
4. Route calls based on phone validation results and reputation scores

Testing

• Fill in test values for InboundNumber (use a real phone number format)
• Click Run Webhook to verify the integration
• Review the response data to see validation results and available properties

Best Practices

• Monitor your API usage and credit consumption
• Set up value extraction to capture key validation metrics
• Use fraud scores and reputation data for call routing decisions
• Test with various number formats to ensure proper validation
• Configure filtering to avoid unnecessary API calls for internal numbers

Troubleshooting

• Verify your API key is active and has sufficient credits
• Ensure phone numbers are in the correct format for validation
• Check that your IPQualityScore account has phone validation enabled
• Monitor API response times and adjust timeout settings if needed
• Review IPQualityScore documentation for specific error codes

The integration enables real-time phone number validation and fraud detection, helping you automatically identify and route calls based on phone number quality, carrier information, and risk scoring to improve lead quality and prevent fraudulent activity.