Webhooks

Premium Feature

Webhooks are available with a premium license. See Free vs Premium for details.

Webhooks let you send chat events to external services in real time. Use them to connect Inqyra with automation platforms, CRMs, or custom applications.

Navigate to: Inqyra > Webhooks

The Webhooks page with webhook management and delivery logs

Supported Events

Event	When It Fires
Conversation Started	A visitor sends their first message
Conversation Ended	No new messages for 30+ minutes
Message Received	The AI responds to a visitor message
Lead Captured	Contact information (email, phone) is detected in a conversation
Escalation Requested	A visitor requests to speak with a human
Appointment Requested	A visitor asks to schedule an appointment

Creating a Webhook

1. Enter a Name for identification (e.g., "Zapier - New Lead")
2. Enter the URL — the HTTPS endpoint that will receive the webhook payload
3. Select which Events should trigger this webhook
4. Optionally add Custom Headers (e.g., authentication tokens)
5. Click Save Webhook

Creating a new webhook with event selection and custom headers

Integration Examples

• Zapier: Use a Zapier "Catch Hook" trigger URL
• Make.com: Use a Make.com "Custom Webhook" URL
• Custom API: Any HTTPS endpoint that accepts POST requests

Managing Webhooks

The webhooks table shows:

Column	Description
Name	Webhook identifier
URL	Destination endpoint
Events	Subscribed events (shown as badges)
Status	Active or Disabled
Actions	Toggle, Test, Edit, Delete

Testing a Webhook

Click Test to send a sample payload to the webhook URL. This helps verify that your endpoint is receiving and processing data correctly before relying on it for production events.

Enabling / Disabling

Click the Toggle button to enable or disable a webhook without deleting it. Disabled webhooks do not fire.

Delivery Logs

Switch to the Delivery Logs tab to view the history of webhook deliveries.

Delivery logs show the status of each webhook call

Each log entry shows:

• Timestamp
• Webhook name
• Event type
• HTTP response status
• Response body (for debugging)
• Retry information (if delivery failed)

Retry Behavior

If a webhook delivery fails (non-2xx response or timeout), Inqyra automatically retries:

Attempt	Delay
1st retry	1 minute
2nd retry	5 minutes
3rd retry	30 minutes

After 3 failed retries, the delivery is marked as failed and no further attempts are made.

Webhook Payload

Webhook payloads are sent as JSON via POST. Each payload includes:

• event — The event type
• timestamp — When the event occurred
• data — Event-specific data (conversation details, message content, etc.)

A HMAC-SHA256 signature is included in the headers for payload verification.