Webhook Integration
Webhook Integration
Intelligems provides a powerful webhook system that allows you to send real-time data about experiments, user actions, and store events to external services. This enables you to build custom integrations, automate workflows, and connect Intelligems data with your existing tools and platforms.
Overview
Webhooks are HTTP POST requests that Intelligems sends to your specified endpoints when certain events occur. This allows you to:
Receive real-time notifications about experiment events
Integrate Intelligems data with external analytics platforms
Automate workflows based on A/B test results
Send alerts to team communication tools like Slack
Trigger custom business logic in your applications
Available Webhook Events
Intelligems supports webhooks for the following experience event types:
Experience Events
Create Experience: Triggered when a new A/B test or experiment is created
Start Experience: Triggered when an experiment goes live
Pause Experience: Triggered when an experiment is paused
End Experience: Triggered when an experiment is stopped or completed
Update Experience: Triggered when experiment settings are modified
Delete Experience: Triggered when an experiment is deleted
Setting Up Webhooks
1. Configure Webhook Endpoints
To set up webhooks in Intelligems:
Navigate to Settings in your Intelligems dashboard
Enter your webhook endpoint URL
Select the events you want to receive
Click Add Webhook in the Webhooks section
Configure any authentication headers within your consuming application, if required
Test the webhook connection
2. Webhook Security (Optional)
Intelligems signs all webhook payloads with a secret key to ensure authenticity:
3. Handling Webhook Retries
Intelligems will retry failed webhook deliveries:
Success Criteria: HTTP status codes 200-299
Timeout: 10 seconds per request
Maximum Retries: 5 attempts
Example: Zapier to Slack Integration
This step-by-step example shows how to use Zapier to send Slack alerts when experiments reach statistical significance.
Step 1: Create a Zapier Webhook
Click Create Zap
Search for and select Webhooks by Zapier as the trigger app
Choose Catch Hook as the trigger event
Copy the webhook URL provided by Zapier
Step 2: Configure Intelligems Webhook
In your Intelligems dashboard, go to Settings > Integrations
Click Add Webhook
Paste the Zapier webhook URL
Select the Start Experience event (or any other experience event you want to track)
Save the configuration
Step 3: Set Up Slack Action in Zapier
In your Zapier workflow, click Continue after setting up the webhook trigger
Search for and select Slack as the action app
Choose Send Channel Message as the action event
Connect your Slack account if not already connected
Configure the Slack message:
Channel: Select your desired Slack channel (e.g., #marketing-alerts)
Message Text: Use dynamic fields from the webhook payload:
Step 4: Test the Integration
In Zapier, click Test & Continue to test the Slack message
Create a test experiment in Intelligems or trigger a test webhook
Verify that the Slack message appears in your chosen channel
Turn on your Zap to make it live
Additional Integration Examples
Google Sheets Integration
Track experiment results in a Google Sheet:
Use Google Sheets as the Zapier action app
Choose Create Spreadsheet Row as the action
Map webhook fields to spreadsheet columns:
Column A: Experience Name
Column B: Action Type
Column C: Experience Type
Column D: Timestamp
Column E: Experience ID
Column F: Triggered By Email
Email Notifications
Send email alerts to your team:
Use Email by Zapier as the action app
Configure recipient email addresses
Create email templates with experience data
Set up different email templates for different action types
Custom API Integration
Send data to your own API endpoint:
Use Webhooks by Zapier as the action app
Choose POST as the action event
Configure your API endpoint URL
Map webhook payload data to your API format
Add authentication headers if required
Best Practices
1. Webhook Endpoint Design
Respond Quickly: Return HTTP 200 status within 10 seconds
Validate Signatures: Always verify webhook authenticity
Log Events: Keep records of received webhooks for debugging
2. Error Handling
3. Monitoring and Debugging
Test webhooks thoroughly before going live
Troubleshooting
Common Issues
Webhook Not Receiving Data
Verify the endpoint URL is correct and accessible
Check that your server responds with HTTP 200
Ensure firewall settings allow incoming requests
Verify the webhook is enabled for the correct events
Authentication Failures
Confirm webhook signature verification is implemented correctly
Check that the secret key matches your configuration
Verify timestamp tolerance in signature validation
Zapier Integration Issues
Ensure the Zapier webhook URL is correctly configured in Intelligems
Check that your Zap is turned on and active
Verify field mappings in your Zapier action steps
Test the integration with sample data
Last updated
Was this helpful?