Вебхуки — авто-уведомления внешних систем
Вебхуки — это способ автоматически сообщать вашей CRM, бухгалтерской программе или любой другой системе о том, что что-то произошло в сервисе (например, создана новая запись клиента или закрыт наряд). Как только событие происходит, CarsEXP сам отправляет короткое сообщение на указанный вами адрес, без ручных действий. Каждое сообщение защищено цифровой подписью, так что принимающая система может убедиться, что данные пришли именно от CarsEXP.
Как открыть
Ещё (нижняя панель навигации) → пункт Вебхуки.
Раздел доступен только на тарифе PRO. Если у вашего сервиса другой тариф, при нажатии на пункт «Вебхуки» появится диалог (paywall) с предложением перейти на PRO — отдельный экран не открывается, навигация не происходит.
URL в браузере: app.carsexp.com/webhooks
Что на экране
Экран состоит из трёх зон, расположенных сверху вниз:
- Заголовок — надпись «Вебхуки» в шапке.
- Информационная строка (синяя плашка под заголовком) — краткая подсказка: _«Вебхуки — авто-уведомления вашим системам (CRM/учёт) при событиях (новая запись, закрытие наряда) по HTTP с подписью.»_
- Список вебхуков — карточки всех настроенных подключений. Если подключений ещё нет, по центру экрана отображается надпись «Вебхуков пока нет».
- Кнопка «Создать вебхук» — плавающая кнопка в правом нижнем углу.
Каждая карточка в списке показывает:
- Адрес (URL) — ссылка, куда CarsEXP отправляет уведомления (одна строка, длинный адрес обрезается).
- Список событий — мелким шрифтом под адресом: на какие события подписан вебхук (например,
appointment.created, repair_order.closed). - Две кнопки справа: тест и удаление (описаны в таблице ниже).
Каждая кнопка и действие
| Элемент | Где находится | Что делает | Кому доступно |
|---|---|---|---|
| Создать вебхук (плавающая кнопка с иконкой «+») | Правый нижний угол экрана | Открывает диалог создания нового вебхука | Owner, Manager (PRO-тариф) |
| Иконка-конверт со стрелкой (кнопка «Тест») | Справа на карточке каждого вебхука | Отправляет тестовое уведомление на адрес вебхука, чтобы убедиться, что принимающая система работает | Owner, Manager (PRO-тариф) |
| Иконка корзины (красная) | Правее кнопки «Тест» на карточке вебхука | Немедленно удаляет вебхук без дополнительного подтверждения | Owner, Manager (PRO-тариф) |
| Пункт меню Вебхуки в разделе «Ещё» | Нижняя навигация → Ещё | Открывает экран вебхуков; на не-PRO тарифе показывает экран апгрейда | Owner, Manager |
Диалоги и подэкраны
Диалог «Создать вебхук»
Открывается при нажатии кнопки «Создать вебхук».
Поля диалога:
| Поле | Что вводить | Ограничения |
|---|---|---|
| URL | Полный адрес вашего сервера, куда CarsEXP будет слать уведомления. Поле сразу в фокусе, открывается клавиатура для ввода адреса. | Должен начинаться с https:// (поле типа «адрес сайта»); обязательное поле — без него кнопка «Создать вебхук» не сработает |
| События: | Список флажков (чекбоксов) — выберите, о каких событиях присылать уведомления | Нужно отметить хотя бы одно событие; если снять все флажки, кнопка «Создать вебхук» не сработает |
Доступные события для подписки:
| Событие | Когда срабатывает |
|---|---|
appointment.created | Клиент записался на ремонт (новая запись в журнале) |
appointment.rescheduled | Запись перенесена на другое время |
repair_order.closed | Наряд закрыт (работы завершены) |
invoice.issued | Выставлен счёт клиенту |
review.created | Клиент оставил отзыв |
По умолчанию при открытии диалога флажок appointment.created уже отмечен.
Кнопки диалога:
| Кнопка | Что делает |
|---|---|
| Отмена | Закрывает диалог без сохранения |
| Создать вебхук | Сохраняет вебхук и открывает следующий диалог с секретом подписи. Пока идёт сохранение — кнопка и флажки недоступны (защита от двойного нажатия) |
Диалог «Вебхук создан» — секрет подписи
Открывается сразу после успешного создания вебхука.
Содержимое:
- Заголовок «Вебхук создан».
- Предупреждение: _«Сохраните секрет подписи — он показывается один раз.»_ — это важно: после закрытия этого окна секрет нигде больше не появится.
- Секрет подписи — длинная строка символов. Её можно выделить и скопировать прямо с экрана.
Кнопки диалога:
| Кнопка | Что делает |
|---|---|
| Копировать (иконка двух листов) | Копирует секрет подписи в буфер обмена |
| OK | Закрывает диалог; после закрытия секрет больше не доступен |
Что происходит при нажатии «Тест»
Немедленно отправляется тестовое уведомление на адрес вебхука. Через секунду-две в нижней части экрана появляется короткое сообщение:
- «Доставлено ✓» — принимающий сервер ответил успехом.
- «Доставка не удалась» — сервер недоступен, ответил ошибкой или не ответил за 8 секунд.
Что происходит при нажатии «Удалить» (корзина)
Вебхук удаляется сразу, без дополнительного подтверждения. Список обновляется. Если удаление не удалось (нет сети), в нижней части экрана появляется сообщение «Повторить».
Что если…
На экране написано «Вебхуков пока нет»
— вы ещё не создали ни одного вебхука или только что удалили последний. Нажмите «Создать вебхук» и заполните форму.
При нажатии «Тест» появляется «Доставка не удалась»
— проверьте, что ваш сервер доступен из интернета и адрес в вебхуке написан без ошибок. CarsEXP ждёт ответа не более 8 секунд; если сервер отвечает дольше — тест тоже провалится.
Экран показывает «Не удалось загрузить аналитику. Проверьте вход и сеть.»
— приложение не смогло получить список вебхуков. Проверьте подключение к интернету и попробуйте снова.
Кнопка «Создать вебхук» в форме не нажимается
— значит, поле URL пустое или не выбрано ни одно событие. Заполните адрес и отметьте хотя бы один флажок.
При нажатии на «Вебхуки» появился диалог с предложением перейти на PRO
— ваш тариф не PRO. Вебхуки доступны только на тарифе PRO. Обратитесь к владельцу сервиса для перехода на нужный тариф.
Вопрос-ответ
Зачем сохранять секрет подписи и что будет, если я его потеряю?
Секрет — это как пароль, которым CarsEXP «подписывает» каждое уведомление. Ваша CRM или учётная система с его помощью проверяет, что сообщение точно пришло от CarsEXP, а не от кого-то постороннего. Если потеряете секрет — придётся удалить этот вебхук и создать новый; прежний секрет нигде больше не хранится и не восстанавливается.
В: Можно ли подписаться сразу на несколько событий в одном вебхуке?
О: Да. В форме создания отметьте столько флажков, сколько нужно — хоть все пять. Уведомления по всем отмеченным событиям будут приходить на один и тот же адрес.
В: Как понять, что уведомление точно дошло до нашей системы?
О: Нажмите иконку-конверт со стрелкой (кнопка «Тест») рядом с нужным вебхуком. Если ваш сервер принял запрос правильно, снизу появится «Доставлено ✓». Если что-то не так — «Доставка не удалась».
В: Мой приёмщик хочет настроить вебхуки. Он может?
О: Только если у него роль «Менеджер» — у менеджера есть доступ к настройкам организации. Приёмщик (Advisor) и механик этого раздела не видят.
В: Что значат события в списке?
О: appointment.created — кто-то записался (онлайн или через кабинет); appointment.rescheduled — запись перенесена; repair_order.closed — мастер закрыл наряд, работы готовы; invoice.issued — выставлен счёт на оплату; review.created — клиент оставил отзыв о работе.
В: Можно ли изменить адрес уже созданного вебхука?
О: Нет, редактирование существующего вебхука не предусмотрено. Удалите старый и создайте новый с нужным адресом.