Что делает вебхук
Вебхук отправляет данные о событии в вашем магазине в другое место в момент, когда оно происходит. Вы выбираете событие и куда его отправлять:
- API: Storeep отправляет данные события на веб-адрес (URL) вашего сервера, CRM, сценария Zapier или Make или сервиса отслеживания рекламы.
- Эл. почта: Storeep отправляет данные события на адрес электронной почты, например чтобы получать письмо о каждом новом заказе.
Откройте Настройки > Вебхуки. Нужно разрешение Настройки.
Для многих сервисов уже есть готовое приложение, и это проще: Google Sheets, курьерские сети и рекламные пиксели. Сначала проверьте магазин приложений.
Создание вебхука
Нажмите Добавить новый вебхук, заполните форму и нажмите Добавить.
- Активировать: отмечено по умолчанию. Когда отмечено, события отправляются сразу. Снимите отметку, чтобы сохранить вебхук, но приостановить его.
- Имя: подпись для списка, например "CRM новые заказы".
- Тип: API или Эл. почта.
- Событие:
- Заказ создан: покупатель оформляет новый заказ.
- Заказ обновлён: меняется статус или данные заказа.
- Сессия создана: на магазин приходит новый посетитель. Только для типа API.
- Формат: Json.
- URL (тип API): адрес для отправки. Часть
https://добавляется автоматически, поэтому введите остальное, напримерapi.example.com/orders. - Адрес электронной почты (тип Эл. почта): куда отправляется письмо.
Вебхук Эл. почта отправляет только события заказов. Если выбрать Эл. почта с Сессия создана, ничего не отправляется.
Данные заказа в URL
Любое поле данных события можно вставить в URL в двойных фигурных скобках, {{field_name}}. Например:
example.com/postback?cid={{fbclid}}&payout={{order_total}}
Так вы отправляете ID клика Facebook и сумму заказа на платформу отслеживания рекламы или партнерскую платформу без дополнительного сервера. Несуществующее поле становится пустым. Чтобы узнать названия полей, создайте вебхук Эл. почта для того же события и посмотрите полученные данные.
Список вебхуков
В каждой строке показаны Имя, URL / Эл. почта, Тип, Событие, Формат и Статус (Активировано или Деактивирован). Нажмите на строку, чтобы изменить вебхук. Отметьте строки и выберите Удалить вебхуки, чтобы удалить их навсегда. Число вебхуков на магазин ограничено, и при достижении лимита вы увидите сообщение.
Для одного события можно создать несколько вебхуков, например один в CRM и один в трекер рекламы.
Когда доставка не удалась
- Ваш сервер должен быстро ответить кодом успеха (2xx). Медленный ответ считается сбоем.
- Если ваш сервер недоступен или перегружен (ответ 5xx или 429 либо нет ответа), Storeep повторяет попытку несколько раз в течение следующих минут. Повторно отправляются только вебхуки, которые не сработали, поэтому остальные не получают дублей.
- Если ваш сервер отклоняет запрос (ответ 4xx, например 404 или 403), Storeep не повторяет попытку, потому что неверен адрес или его защита.
- Когда вебхук несколько раз подряд не срабатывает, владелец магазина получает одно письмо: "Требуется действие: ваш вебхук Storeep не работает", с названием вебхука, адресом, событием и последним кодом ошибки. После того как вебхук снова заработает, новая проблема может прислать новое предупреждение. Это письмо можно отключить в разделе Уведомления.
- Вебхуки Эл. почта отправляются один раз, без повторных попыток.
Вебхуки, приостановленные из-за неоплаченного баланса
Если у магазина есть неоплаченная сумма к оплате, а кошелька не хватает, чтобы ее покрыть, вебхуки ждут. Они отправляются после того, как вы пополните кошелек и сумма будет погашена. См. Кошелек и оплата.
Советы
- Если вашему серверу нужен пароль или ключ, передайте его в параметрах URL, например
?key=yoursecret. - Сессия создана срабатывает для каждого посетителя, а в оживленном магазине это может быть очень много. Используйте это событие, только если ваш сервер справится с нагрузкой.
- Чтобы сервис мог читать заказы и товары в любое время, используйте вместо этого токен доступа.