Webhook Configuration
Set up webhooks to receive real-time notifications and integrate eeV.ai with external systems.
Webhook Overview
What are Webhooks?
Webhooks are HTTP callbacks that eeV.ai sends to your specified endpoints when certain events occur in the platform.
Webhook Benefits
- Real-time Notifications: Instant event notifications
- System Integration: Connect with external applications
- Automated Workflows: Trigger automated processes
- Data Synchronization: Keep systems in sync
Webhook Events
Conversation Events
- conversation.created: New conversation started
- conversation.updated: Conversation status changed
- conversation.closed: Conversation completed
- conversation.escalated: Escalated to human agent
- conversation.transferred: Transferred between agents
Ticket Events
- ticket.created: New support ticket created
- ticket.updated: Ticket information modified
- ticket.resolved: Ticket marked as resolved
- ticket.reopened: Resolved ticket reopened
- ticket.assigned: Ticket assigned to agent
Agent Events
- agent.response: AI agent provided response
- agent.escalation: Agent escalated conversation
- agent.error: Agent encountered error
- agent.training: Agent training completed
System Events
- system.maintenance: Maintenance mode activated
- system.error: System error occurred
- system.backup: Backup process completed
- system.update: System update deployed
Webhook Setup
Configuration Process
- Navigate to Settings > Webhooks
- Click "Add Webhook" button
- Enter webhook details:
- Name: Descriptive webhook name
- URL: Target endpoint URL
- Events: Select events to monitor
- Secret: Optional webhook secret
- Test webhook connection
- Save webhook configuration
Webhook Properties
Basic Configuration
- Webhook URL: Target endpoint for notifications
- HTTP Method: POST (default) or PUT
- Content Type: application/json
- Timeout: Request timeout (default: 30 seconds)
Security Settings
- Secret Key: Webhook signature verification
- SSL Verification: Verify SSL certificates
- IP Whitelist: Restrict webhook sources
- Authentication: Bearer token or basic auth
Best Practices
Implementation Guidelines
- Idempotency: Handle duplicate webhook deliveries
- Async Processing: Process webhooks asynchronously
- Error Recovery: Implement robust error handling
- Monitoring: Track webhook performance and reliability
Security Recommendations
- Always Verify: Verify all webhook signatures
- Use HTTPS: Secure webhook endpoints
- Limit Scope: Minimal webhook permissions
- Regular Rotation: Rotate webhook secrets regularly
