What Is a Webhook and Why Use One
A Webhook is an HTTP request that Auralix sends to your server or CRM the moment an event occurs. The most common event is a new lead: a user has left their contact details in the chat.
With a Webhook you can:
- Automatically create deals in your CRM (AmoCRM, Bitrix24, HubSpot, Notion, etc.)
- Send notifications to Telegram or Slack
- Trigger automation in Make (Integromat) or n8n
- Write to any database via API
Step 1: Get the Webhook URL from Your CRM
Most CRMs and automation platforms provide a ready-made Webhook URL.
Examples:
- HubSpot: Settings → Integrations → Webhooks → Add
- Pipedrive: Tools → Webhooks → Add new webhook
- Make / n8n: Create a scenario with a "Webhook" trigger — the system generates a URL
- Telegram notification bot: use n8n to receive and forward the payload
Copy the URL.
Step 2: Add the Webhook in Auralix
- Log in to Auralix → your project
- Go to Integrations → Webhook
- Click Add Webhook
- Paste the URL from your CRM
- Select the event: New Lead
- Click Save
Step 3: Understand the Payload Format
Auralix sends a POST request with a JSON body:
{
"event": "lead.created",
"project_id": "uuid",
"created_at": "2026-05-31T10:00:00Z",
"lead": {
"name": "John Smith",
"phone": "+12025551234",
"email": "john@example.com",
"message": "I'd like to know about pricing",
"channel": "telegram",
"conversation_id": "uuid"
}
}
Use these fields to map data in your CRM.
Step 4: Test the Integration
- In Auralix, click Test next to the Webhook — the system sends a test request
- Check your CRM or Make to confirm the data arrived
- Run a real conversation: leave a test lead and verify it appears in the CRM
Common Mistakes
| Problem | Solution |
|---|---|
| CRM not receiving data | Make sure the URL is reachable from the internet (not localhost) |
| Fields are empty | Confirm that contact data was actually collected during the conversation |
| Duplicate leads | Check that you don't have two active Webhooks for the same event |
| 401/403 errors | Your CRM requires an auth header — add it in Webhook settings |
FAQ
Can I add authorization headers to the Webhook?
Yes. Auralix Webhook settings include a field for custom HTTP headers, e.g. Authorization: Bearer token.
What happens if my CRM is unavailable? Auralix retries with exponential backoff. All events are logged under Integrations → Log.
Can I send data to multiple Webhooks simultaneously? Yes — you can add multiple Webhooks for a single event.
Is GraphQL supported, or only REST? REST only (HTTP POST with JSON). For GraphQL use an intermediary like Make or n8n.
Summary
Webhook integration is the bridge between your AI agent and any CRM or client management system. Set it up once — and every lead appears in your CRM automatically, with no manual transfer.
Not collecting leads yet? Set up lead collection →