Setting Up Searchbug Phone Number Validation Webhook

The Searchbug integration validates phone numbers in real-time, identifying line types, carriers, connection status, and DNC/TCPA compliance information to help improve data quality and marketing compliance.

Prerequisites

Before setting up your webhook, you'll need:

• An active Searchbug account
• Bearer authentication token from your Searchbug account
• Prepaid balance loaded for API queries

Setup Process

1. Get Your Authentication Token

1. Log into your Searchbug account
2. Navigate to your account settings
3. Find the API section and copy your Bearer authentication token
4. Ensure your account has sufficient prepaid balance for phone validation queries

2. Create New Webhook

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

3. Basic Configuration

1. Bearer Authentication Token: Enter your Searchbug Bearer token
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 Searchbug validation parameters:

• InboundNumber maps to the phone number parameter for validation

Request Structure The webhook sends a POST request with form data containing:

• Phone number for line type and carrier identification
• API location and format parameters for JSON response
• Bearer authentication for secure API access

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 line_type, carrier, active_status, dnc_status, etc.
2. Map them to custom tags for advanced routing and compliance filtering
3. Use extracted data to automatically identify cell phones vs landlines
4. Route calls based on carrier information and DNC compliance status

Testing

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

Best Practices

• Monitor your prepaid balance and usage for cost control
• Set up value extraction to capture line type and carrier information
• Use DNC and TCPA compliance data for regulatory adherence
• Test with various number types to ensure proper line type identification
• Configure filtering to avoid unnecessary API calls for known internal numbers

Troubleshooting

• Verify your Bearer token is active and correctly formatted
• Ensure your Searchbug account has sufficient prepaid balance
• Check that phone numbers are in the correct format for validation
• Monitor API response times and adjust timeout settings if needed
• Review Searchbug documentation for specific error codes and responses

The integration enables real-time phone number validation and compliance checking, helping you automatically identify line types, carriers, and regulatory status to improve marketing effectiveness and maintain TCPA compliance.