Что такое Webhook и зачем он нужен
Webhook — это HTTP-запрос, который Auralix отправляет на ваш сервер или в CRM в момент события. Самое частое событие — новая заявка (лид): пользователь оставил контакт в чате.
Webhook позволяет:
- Автоматически создавать сделки в CRM (AmoCRM, Bitrix24, HubSpot, Notion и др.)
- Отправлять уведомления в Telegram или Slack
- Запускать автоматизацию в Make (Integromat) или n8n
- Писать в любую базу данных через API
Шаг 1: Получите URL Webhook из вашей CRM
В большинстве CRM и сервисов автоматизации есть готовый Webhook URL.
Примеры:
- AmoCRM: Настройки → Интеграции → Webhooks → Добавить
- Bitrix24: CRM → Настройки → Интеграции → Входящий webhook
- Make / n8n: создайте сценарий с триггером «Webhook» — система выдаст URL
- Telegram-бот для уведомлений: используйте сервис вроде n8n для приёма и пересылки
Скопируйте полученный URL.
Шаг 2: Добавьте Webhook в Auralix
- Войдите в Auralix → ваш проект
- Перейдите в Интеграции → Webhook
- Нажмите Добавить Webhook
- Вставьте URL из CRM
- Выберите событие: Новый лид
- Нажмите Сохранить
Шаг 3: Изучите формат данных
Auralix отправляет POST-запрос с JSON-телом:
{
"event": "lead.created",
"project_id": "uuid",
"created_at": "2026-05-31T10:00:00Z",
"lead": {
"name": "Иван Петров",
"phone": "+79001234567",
"email": "ivan@example.com",
"message": "Хочу узнать о тарифах",
"channel": "telegram",
"conversation_id": "uuid"
}
}
Используйте эти поля для маппинга в вашей CRM.
Шаг 4: Протестируйте интеграцию
- В Auralix нажмите Тест рядом с Webhook — система отправит тестовый запрос
- Проверьте в вашей CRM или Make, что данные получены
- Проведите реальный диалог: оставьте тестовую заявку и убедитесь, что она появилась в CRM
Частые ошибки
| Проблема | Решение |
|---|---|
| CRM не получает данные | Проверьте, что URL доступен из интернета (не localhost) |
| Поля пустые | Убедитесь, что в диалоге действительно собирались контактные данные |
| Дублирование заявок | Проверьте, нет ли двух активных Webhook для одного события |
| Ошибка 401/403 | CRM требует авторизационный заголовок — добавьте его в настройках Webhook |
FAQ
Можно ли добавить заголовки авторизации к Webhook?
Да. В настройках Webhook Auralix есть поле для произвольных HTTP-заголовков, например Authorization: Bearer token.
Что происходит, если CRM недоступна? Auralix делает повторные попытки с экспоненциальной задержкой. Все события логируются в разделе Интеграции → Лог.
Можно ли отправлять данные на несколько Webhook одновременно? Да. Вы можете добавить несколько Webhook для одного события.
Поддерживается ли GraphQL или только REST? Только REST (HTTP POST с JSON). Для GraphQL используйте промежуточный слой через Make или n8n.
Итог
Webhook-интеграция — это мост между вашим AI-агентом и любой системой учёта клиентов. Настройте один раз — и каждый лид будет автоматически появляться в CRM без ручного переноса.
Ещё не собираете заявки? Настройте сбор лидов →