# Отправляйте события в свои системы с помощью вебхуков

> Вебхук сообщает вашей системе о событии в магазине в тот же момент, например о новом заказе или изменении остатка. Добавьте URL эндпоинта в разделе Настройки > Вебхуки, выберите события, отправьте тест и смотрите каждую доставку и ответ на нее.

Центр помощи / Интеграции - Обновлено 2 ноября 2026 г.

Вебхук отправляет сообщение на выбранный вами веб-адрес в тот момент, когда в магазине что-то происходит. Например, новый заказ может сразу попасть в вашу систему комплектации, изменение остатка в складскую таблицу, а новый клиент в CRM. Вашим системам не нужно постоянно опрашивать Shoprocket об изменениях.

Нужно место, куда будут приходить сообщения: адрес на вашем сервере или инструмент, который его предоставляет, например платформа автоматизации. Настройка принимающей стороны обычно работа разработчика.

## Перед началом

- Вебхуки доступны на тарифе **Growth** и выше. На более низком тарифе экран покажет, какой тариф их включает.
- Они входят в приложение **Инструменты разработчика** вместе с **API-ключи**. Если в боковом меню в разделе **Настройки** нет пункта **Вебхуки**, откройте **Приложения**, найдите **Инструменты разработчика** в разделе **Разработчикам** и нажмите **Добавить**. См. [Добавление и удаление приложений](https://shoprocket.io/ru/help/the-apps-page.md).

## Добавьте эндпоинт

1. В панели управления откройте **Настройки > Вебхуки** и нажмите **Добавить эндпоинт**.
2. Введите **Имя**. Назовите его по системе, в которую он отправляет данные, чтобы знать, что сломается, если его удалить.
3. Введите **URL эндпоинта**. Он должен начинаться с `https://`.
4. Оставьте **Эндпоинт тестового режима** выключенным для эндпоинта, который обслуживает ваш реальный бизнес. Включите его для эндпоинта, который должен получать только тестовые заказы.
5. Выберите события для отправки. Отмечайте события по одному, используйте **Выбрать все** для группы или **Подписаться на все события**. Лучше выбирать только те события, которые использует ваша система. Нажмите **Пример** рядом с событием, чтобы увидеть сообщение, которое оно отправляет.
6. Нажмите **Добавить эндпоинт**.

![Панель добавления эндпоинта вебхука: имя Fulfilment, https-адрес эндпоинта, тестовый режим выключен, отмечено order.created с открытым примером данных](https://shoprocket.io/img/help/webhooks/add-endpoint.webp)

## События

| Группа | События |
|---|---|
| **Заказы** | Создан, обновлен, оплачен, возвращен, выполнен, частично выполнен, удален |
| **Клиенты** | Создан, обновлен, удален |
| **Товары** | Создан, обновлен, удален |
| **Склад** | Остаток обновлен |
| **Скидки** | Создана, обновлена, удалена |
| **Категории** | Создана, обновлена, удалена |
| **Подписки** | Создана, продлена, продление не удалось, приостановлена, возобновлена, отменена, истекла |
| **Лицензионные ключи** | Назначен, приостановлен, восстановлен, истек, отозван |

## Отправьте тест

Нажмите **Отправить тест** у эндпоинта. Shoprocket сразу отправит тестовое событие и сообщит, принял ли его эндпоинт и что ответил ваш сервер, например «Ответ 200 за 140 мс», или что до него вообще не удалось достучаться.

## Посмотрите, что было отправлено

Карточка **Недавние доставки** под эндпоинтами перечисляет каждое событие, которое Shoprocket пытался отправить: когда, какой код ответа дал ваш сервер и сколько понадобилось попыток. Доставка бывает в состоянии **Доставлено**, **В очереди**, **Повторная попытка** или **Не удалось**. Исправив проблему на своей стороне, нажмите **Отправить повторно** у любой доставки, чтобы отправить ее снова.

![Недавние доставки эндпоинта: доставленные события с HTTP 200, одно в состоянии Повторная попытка с HTTP 500 и кнопка Отправить повторно](https://shoprocket.io/img/help/webhooks/recent-deliveries.webp)

## Когда доставки не проходят

Ваш сервер должен отвечать на каждое сообщение любым кодом 2xx. Если этого не происходит, Shoprocket продолжает попытки примерно в течение суток.

Если доставки на один эндпоинт не проходят 20 раз подряд, эндпоинт отключается с указанием причины. Исправьте эндпоинт и нажмите **Включить сейчас**. Все, что накопилось в очереди, пока он был выключен, будет отправлено. Перед отключением, пока ошибки накапливаются, эндпоинт предупреждает вас, например «3 доставки подряд не удались. После 20 мы автоматически отключим этот эндпоинт».

## Измените или удалите эндпоинт

Нажмите кнопку редактирования эндпоинта, чтобы изменить имя, адрес или события, затем **Сохранить**. Чтобы навсегда прекратить отправку на него, нажмите **Удалить** и подтвердите.

## Для разработчиков

Каждое сообщение подписывается секретом подписи эндпоинта, чтобы ваш сервер мог проверить, что оно действительно от Shoprocket. Нажмите **Показать секрет подписи** у эндпоинта, чтобы скопировать его. Каждое сообщение также содержит название события и ID доставки, чтобы ваш сервер мог отсеивать повторы. В руководстве разработчика есть проверка подписи, данные каждого события и подробности о повторных попытках. См. [Вебхуки](https://shoprocket.io/docs/webhooks.md).

## Связанные статьи

- [Создайте API-ключ](https://shoprocket.io/ru/help/api-keys.md)
- [Zapier](https://shoprocket.io/ru/help/zapier.md)
- [Тестовый и рабочий режим](https://shoprocket.io/ru/help/test-mode-vs-live.md)

[Открыть Вебхуки в панели управления](https://app.shoprocket.io/go/settings/webhooks)

---

- HTML version: https://shoprocket.io/ru/help/webhooks
- Language: Русский (ru)
- Also in: [العربية](https://shoprocket.io/ar/help/webhooks.md), [Deutsch](https://shoprocket.io/de/hilfe/ereignisse-mit-webhooks-senden.md), [Ελληνικά](https://shoprocket.io/el/help/webhooks.md), [English](https://shoprocket.io/help/webhooks.md), [Español](https://shoprocket.io/es/ayuda/envia-eventos-con-webhooks.md), [Français](https://shoprocket.io/fr/aide/envoyer-des-evenements-avec-les-webhooks.md), [עברית](https://shoprocket.io/he/help/webhooks.md), [हिन्दी](https://shoprocket.io/hi/help/webhooks.md), [Bahasa Indonesia](https://shoprocket.io/id/bantuan/webhook.md), [Italiano](https://shoprocket.io/it/aiuto/invia-eventi-con-i-webhook.md), [日本語](https://shoprocket.io/ja/help/webhooks.md), [Lietuvių](https://shoprocket.io/lt/pagalba/webhookai.md), [Norsk](https://shoprocket.io/nb/hjelp/webhooks.md), [Nederlands](https://shoprocket.io/nl/hulp/webhooks.md), [Polski](https://shoprocket.io/pl/pomoc/webhooki.md), [Português](https://shoprocket.io/pt/ajuda/envie-eventos-com-webhooks.md), [Română](https://shoprocket.io/ro/ajutor/webhooks.md), [ไทย](https://shoprocket.io/th/help/webhooks.md), [Türkçe](https://shoprocket.io/tr/yardim/webhooklar.md), [中文](https://shoprocket.io/zh/help/webhooks.md)
