Setting Up IPQualityScore Proxy Detection Webhook

The IPQualityScore Proxy integration analyzes visitor IP addresses in real-time to detect proxies, VPNs, Tor connections, and other high-risk IP addresses, providing fraud scoring and reputation data to improve call quality and security.

Prerequisites

Before setting up your webhook, you'll need:

• An active IPQualityScore account
• API key from your IPQualityScore dashboard
• Premium account access for advanced proxy detection 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 IP reputation query credits available

2. Create New Webhook

1. Navigate to Integrations → Webhooks
2. Click + New Webhook
3. Select Data Collection template type
4. Choose IPQualityScore Proxy 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 IP analysis:

• VisitorIpAddress maps to the IP parameter for reputation analysis

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

• IP address for proxy detection and reputation scoring
• Your API key for authentication
• Request for comprehensive fraud and risk analysis

Filtering

• Add filters using any system tag (InboundState, BuyerName, CampaignName, etc.)
• Use Equals conditions to control when IP analysis 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, proxy, vpn, tor, abuse_velocity, etc.
2. Map them to custom tags for advanced routing and risk assessment
3. Use extracted data to automatically filter high-risk IP addresses
4. Route calls based on IP reputation scores and connection types

Testing

• Fill in test values for VisitorIpAddress (use a real IP address)
• Click Run Webhook to verify the integration
• Review the response data to see reputation results and available properties

Best Practices

• Monitor your API usage and credit consumption
• Set up value extraction to capture key reputation metrics
• Use fraud scores and proxy detection for call routing decisions
• Test with various IP types to ensure proper detection
• Configure filtering to avoid unnecessary API calls for trusted IP ranges

Troubleshooting

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

The integration enables real-time IP reputation analysis and proxy detection, helping you automatically identify and route calls based on visitor IP risk scores, connection types, and abuse history to prevent fraudulent activity and improve call quality.