Рабочие пространства тарифного плана Business Pro поддерживают до 30 000 событий вебхуков в расчётный период. Проверьте ограничения вашего плана перед настройкой автоматизаций с высоким объёмом запросов.
Поддерживаемые события
Вы можете подписать вебхук на любую комбинацию следующих событий:Создание вебхука
1
Перейдите в управление вебхуками
В левой боковой панели перейдите в Интеграции → Управление вебхуками.
2
Аутентифицируйте токен
Нажмите кнопку Управление, чтобы аутентифицировать токен вебхука. Этот токен используется для подписи исходящих данных, чтобы вы могли убедиться, что они отправлены из AgencyHandy.
3
Создайте новый вебхук
Нажмите Создать новый вебхук, чтобы открыть форму настройки вебхука.
4
Введите URL конечной точки
В поле URL конечной точки введите URL внешней системы, которая должна получать данные вебхука. Это должна быть общедоступная конечная точка POST.
5
Выберите тип содержимого
Выберите JSON в качестве типа содержимого. AgencyHandy отправляет все данные вебхуков в формате
application/json.6
Выберите события вебхука
Выберите каждое событие, которое должно инициировать этот вебхук. Вы можете выбирать события из нескольких категорий — например, Заказ: Создан и Счёт: Статус изменён могут указывать на одну и ту же конечную точку.
7
Активируйте вебхук
Переключите радиокнопку Активен. В активном состоянии AgencyHandy доставляет данные для всех выбранных событий на вашу конечную точку в режиме реального времени.
8
Сохраните настройки
Проверьте настройки, затем нажмите Сохранить. Вебхук появится в списке и немедленно начнёт доставлять события.
Тестирование вебхука
После создания вебхука отправьте тестовые данные, чтобы убедиться, что ваша конечная точка доступна и корректно обрабатывает данные.1
Откройте вебхук
В списке управления вебхуками нажмите на вебхук, который вы хотите протестировать.
2
Нажмите «Тестовое событие»
Нажмите кнопку Тестовое событие на странице сведений о вебхуке.
3
Выберите тестовое событие
Выберите образец события из списка событий, настроенных для этого вебхука (например, Заказ: Создан).
4
Отправьте тестовые данные
Нажмите Отправить. AgencyHandy опубликует образец данных на ваш URL конечной точки.
5
Проверьте результат
Проверьте вашу внешнюю систему, чтобы убедиться, что тестовые данные получены и обработаны корректно. Вернувшись в AgencyHandy, откройте вебхук для просмотра его истории — вы можете увидеть полный запрос, ответ вашей конечной точки и повторно доставить любое прошлое событие при необходимости.
Аутентификация данных вебхука
Каждый исходящий запрос вебхука из AgencyHandy содержит заголовок подписи, который ваша конечная точка может использовать для проверки подлинности данных и их целостности.Заголовок подписи
Проверка подписи вебхука
Отправьте следующий запрос для подтверждения подлинности данных:Идентификатор вебхука, получившего событие. Найдите его на странице сведений о вебхуке в AgencyHandy.
Значение заголовка
x-ah-sig из входящего запроса вебхука.Секрет вебхука, отображаемый на странице сведений о вебхуке в AgencyHandy.
Необработанное тело JSON, полученное из запроса вебхука AgencyHandy.
SUCCESS при действительной подписи. FAILED при неудачной проверке (HTTP 403).Success (200)
Failure (403)
Важные замечания
- URL вашей конечной точки должен быть общедоступным HTTPS POST URL.
- Если ваша конечная точка временно недоступна, проверьте панель истории вебхука в AgencyHandy — вы можете повторно доставить любое прошлое событие прямо оттуда.
- Регулярно отслеживайте активность вебхуков для обнаружения сбоев доставки или несанкционированных попыток доступа.
- Вебхуки, которые многократно не срабатывают, могут быть приостановлены AgencyHandy — проверяйте журналы доставки, чтобы выявлять проблемы заблаговременно.

