Назад в блог

Уведомления о заказах Shopify: push-уведомления на телефон для каждого заказа

Уведомления о заказах Shopify: push-уведомления на телефон для каждого заказа

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

Shopify уже даёт два способа узнавать о заказах, и их стоит знать до того, как что-то добавлять. В этом руководстве описаны оба, а затем настраивается push-уведомление Pocket Alert на каждый заказ с помощью одного вебхука в админке Shopify. Это займёт около пяти минут, и ничего устанавливать в магазине не нужно.

Что Shopify даёт из коробки

Приложение Shopify. На iPhone и Android приложение Shopify может присылать push-уведомления о новых заказах: в приложении откройте Настройки → Уведомления (на Android — Store notifications) и включите push для заказов. На iPhone оно также может показывать количество открытых заказов в виде бейджа. Для вас это работает хорошо. Но каждый, кому нужны такие уведомления, должен войти в приложение Shopify как сотрудник с доступом к заказам.

Email-уведомления для сотрудников. В разделе Настройки → Уведомления → Staff notifications Shopify по умолчанию отправляет владельцу магазина письмо «New order», а получателями можно добавить сотрудников или любые адреса электронной почты. Это бесплатно и надёжно, но это письмо. Оно лежит рядом с рассылками и чеками, и звука на него никто не получает.

Если этих вариантов достаточно, можно остановиться. Push-уведомление Pocket Alert стоит добавить, когда нужно то, чего они не умеют:

  • Телефоны без места в Shopify. Push приходит на каждый телефон, вошедший в ваш аккаунт Pocket Alert, на iOS или Android. Упаковщику или партнёру не нужен сотрудничий аккаунт в вашем магазине.
  • Уровни важности. Обычные заказы могут приходить тихо, а крупный заказ может пробиться через Фокусирование. У каждого уровня свой канал уведомлений на Android, так что один можно отключить, а другой оставить.
  • История, по которой можно искать. Каждое уведомление остаётся в приложении, а в консоли хранится журнал всех запросов, которые присылал Shopify. Это помогает, когда заказ как будто пропал.
  • Одно приложение для всего. Заказы попадают в ту же ленту, что платежи Stripe, проверки доступности и алерты серверов.
  • Кнопки. Push может содержать кнопку Open order, которая ведёт прямо к заказу в админке.

Что понадобится

  • Магазин Shopify и доступ к Настройки → Уведомления.
  • Аккаунт Pocket Alert и приложение на телефоне. Для этого руководства хватит бесплатного тарифа: 50 сообщений в день, одно устройство и один вебхук. Кнопки, больше устройств и вебхуков доступны на платных тарифах.

Шаг 1: создайте вебхук Pocket Alert

В консоли откройте Webhooks и создайте вебхук:

  • Name: Shopify orders. Pocket Alert использует это имя в заголовке push, он будет выглядеть как «Webhook Shopify orders».
  • Default priority: пока Default.
  • Message: шаблон ниже.
%name% · %total_price% %currency% · %customer.first_name%
%line_items.0.title% · %line_items.#% products

Каждое %...% — это путь к данным в JSON, который присылает Shopify. Вот реальные поля полезной нагрузки orders/create:

  • name — название заказа, как его видит покупатель, например #1042. (order_number — то же число без #.)
  • total_price и currency — сумма заказа и валюта магазина.
  • customer.first_name — имя покупателя. Если к заказу не привязан покупатель, как в некоторых продажах через POS, поле будет пустым.
  • line_items.0.title — первый товар, а line_items.# считает строки заказа. Это количество разных товаров, а не общее число единиц.

Сохраните вебхук и скопируйте его адрес для приёма. Он выглядит как https://p4a.me/wh/abc123....

Шаг 2: добавьте вебхук в Shopify

  1. В админке Shopify перейдите в Настройки → Уведомления.
  2. Нажмите Webhooks, затем Create webhook.
  3. Event: Order creation. Событие потом нельзя изменить.
  4. Format: JSON. Pocket Alert принимает только JSON; с XML push не придёт.
  5. URL: ваш адрес для приёма https://p4a.me/wh/....
  6. Webhook API version: выберите самую новую стабильную версию из списка. Поля, которые здесь используются, есть во всех недавних версиях.
  7. Нажмите Save.

Те же экраны есть в мобильном приложении Shopify: Настройки → Уведомления → Webhooks в разделе настроек магазина, если вы не у компьютера.

Теперь нажмите меню ... у нового вебхука и выберите Send test. Shopify отправит пример заказа, и через секунду на телефоне появится:

Webhook Shopify orders
#9999 · 404.95 USD · John
Aviator sunglasses · 5 products

Это тестовые данные Shopify. Следующий настоящий заказ придёт так же, но с реальными значениями.

Шаг 3: сделайте лучше

Выберите уровень

В полезной нагрузке Shopify нет поля level, поэтому каждое уведомление получает приоритет вебхука по умолчанию. Выбирайте его по количеству заказов:

  • Несколько заказов в день: High. На iPhone уведомление срочное и проходит через Фокусирование.
  • Десятки заказов в день: Low. Они тихо собираются в приложении, и вы читаете их, когда удобно, а остальные оповещения остаются громкими.

Изменить уровень можно в любой момент, отредактировав вебхук в консоли. В документации по уровням приоритета описано, что делает каждый уровень на iOS и Android.

Добавьте кнопку Open order

Адрес заказа в админке Shopify выглядит как https://admin.shopify.com/store/<store>/orders/<id>, где <store> — часть до .myshopify.com, а <id> — числовой id заказа, который есть в полезной нагрузке вебхука. Этого достаточно для кнопки.

В консоли пока нет поля для кнопок, поэтому задайте их одним вызовом API. Нужен API-ключ из раздела API Keys. Найдите tid вебхука:

curl -s https://api.pocketalert.app/v1/webhooks -H 'Token: YOUR_API_KEY' \
  | jq -r '.[] | "\(.tid)  \(.name)"'

Затем добавьте кнопку, заменив your-store на ваш идентификатор магазина:

curl -X PUT https://api.pocketalert.app/v1/webhooks/WEBHOOK_TID \
  -H 'Token: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"actions": "[{\"type\":\"view\",\"label\":\"Open order\",\"value\":\"https://admin.shopify.com/store/your-store/orders/%id%\"}]"}'

actions — это JSON-строка, поэтому внутренние кавычки экранированы. Плейсхолдер %id% подставляется из каждого заказа. На Android кнопка подписана «Open order»; на iOS для кнопок этого типа показывается стандартная подпись Open. Кнопки доступны на платных тарифах. На бесплатном тарифе push всё равно придёт, только без кнопки.

Отмены и возвраты

В Shopify для этого есть отдельные события. Создайте вебхук Pocket Alert для каждого (на бесплатном тарифе один вебхук, на тарифе Starter — пять), затем добавьте вебхук Shopify с подходящим событием:

Событие ShopifyНазвание в Pocket AlertШаблон
Order cancellationShopify cancelled%name% cancelled · %cancel_reason% · %total_price% %currency%
Refund createShopify refundRefund %transactions.0.amount% on order %order_id% · %note%

В полезной нагрузке возврата нет названия заказа, только числовой order_id, поэтому быстрее всего понять, о каком заказе речь, с той же кнопкой Open order, где вместо %order_id% стоит %id%. У возврата может быть несколько транзакций; шаблон показывает первую. Поставьте вебхук возвратов на High, чтобы он выделялся среди продаж.

Крупные заказы и низкий остаток с Shopify Flow

Шаблон Pocket Alert умеет показывать поля, но не умеет их сравнивать, поэтому он не может решить, что заказ на 500 громче заказа на 20. Shopify Flow может. Это бесплатное приложение Shopify, а действие Send HTTP request доступно на тарифах Grow, Advanced и Plus. На тарифе Basic Flow есть, но этого действия нет, поэтому этот раздел там не сработает.

Flow может вызывать API Pocket Alert напрямую, что позволяет задать свой заголовок, уровень и кнопку. Сначала в Flow → Settings добавьте секрет с именем pocketalert и вашим API-ключом в качестве значения.

Громкий push для крупных заказов

  1. Новый воркфлоу, триггер Order created.
  2. Условие: order.totalPriceSet.shopMoney.amount больше или равно 500.
  3. Действие Send HTTP request:
    • Method: POST
    • URL: https://api.pocketalert.app/v1/messages
    • Headers: Token = {{secrets.pocketalert}}, Content-Type = application/json
    • Body:
{
  "title": "Big order {{order.name}}",
  "message": "{{order.totalPriceSet.shopMoney.amount}} {{order.totalPriceSet.shopMoney.currencyCode}} · {{order.customer.firstName}}",
  "level": "high",
  "actions": [
    {"type": "view", "label": "Open order",
     "value": "https://admin.shopify.com/store/your-store/orders/{{order.legacyResourceId}}"}
  ]
}

Переменные Flow используют имена из GraphQL Admin API, поэтому здесь они записаны в camelCase, а в шаблоне вебхука — в snake_case. legacyResourceId — это тот же числовой ID, который вебхук называет id.

Хорошая комбинация: обычный вебхук оставьте на Low, а крупные заказы пусть присылает Flow с High. Для заказа, на который нужно реагировать немедленно, используйте critical. На платных тарифах уведомление проходит через режим «Не беспокоить»; на бесплатном оно отправляется как high.

Низкий остаток

Используйте триггер Product variant inventory quantity changed с двумя условиями, чтобы получить одно уведомление в момент, когда остаток пересёк границу, а не по одному на каждую продажу ниже неё:

  • productVariant.inventoryQuantity меньше 5
  • inventoryQuantityPrior больше или равно 5

Затем то же действие HTTP-запроса с таким телом:

{
  "title": "Low stock: {{product.title}}",
  "message": "{{productVariant.title}}: {{productVariant.inventoryQuantity}} left",
  "level": "default"
}

Одно предупреждение для обоих тел: Flow подставляет значения как есть. Название товара с двойной кавычкой сломает JSON, и API отклонит запрос. Держите названия без спецсимволов или уберите это поле.

Честные ограничения

  • Pocket Alert не проверяет подпись Shopify. Shopify подписывает каждый вебхук HMAC-заголовком. Pocket Alert принимает любой JSON, отправленный на ваш адрес для приёма, поэтому сам адрес и есть секрет. Не публикуйте его нигде открыто. Если нужна проверка подписи, поставьте между ними небольшую функцию, которая её проверит, а затем вызовет API Pocket Alert.
  • Бесплатный тариф ограничен 50 сообщениями в день. После этого Pocket Alert отвечает Shopify ошибкой, пока лимит не обновится. Shopify повторяет неудачные доставки, а если вебхук постоянно падает, Shopify его удаляет. Если заказов больше примерно 40 в день, перейдите на платный тариф, иначе вебхук может исчезнуть.
  • Заголовки вебхуков фиксированы. Push от вебхука всегда имеет заголовок «Webhook» и название вебхука. Чтобы задать свой заголовок, используйте Flow и API, как показано выше.
  • Подписи кнопок на iOS общие. Android показывает ваш текст, iOS показывает Open.

Если ничего не приходит

  • Откройте историю вебхука в консоли. Там есть каждый запрос, который отправил Shopify: заголовки, тело, отрендеренное сообщение и статус. Если список пуст, Shopify не обращался к адресу: проверьте, что он вставлен полностью.
  • Ищите «Invalid JSON». Формат вебхука Shopify задан как XML. Отредактируйте вебхук в Shopify и переключите формат на JSON.
  • Пустые поля в push. Путь неверный или поля нет в этом заказе. Сравните шаблон с телом запроса в истории; например, customer может быть пустым у заказов из POS.
  • Вебхук пропал из Shopify. Он слишком много раз подряд завершился ошибкой, обычно из-за неверного адреса или дневного лимита. Устраните причину и добавьте вебхук заново.
  • Запрос Flow не выполнился. Откройте журнал запусков воркфлоу. Ошибка 401 означает, что в секрете неверный ключ; ошибка 400 обычно значит, что тело не является корректным JSON.

FAQ

Работает ли это на тарифе Shopify Basic?

Да. Основная настройка использует только страницу вебхуков в Настройки → Уведомления. Только раздел Flow требует тарифа Grow, Advanced или Plus.

Могут ли сотрудники получать push о заказах без аккаунта Shopify?

Да. Push приходит на телефоны, вошедшие в ваш аккаунт Pocket Alert, а Shopify участвует только в отправке вебхука. На бесплатном тарифе одно устройство; платные тарифы допускают больше.

Можно ли отправлять заказы из двух магазинов?

Создайте вебхук для каждого магазина и дайте каждому своё название, например «Shopify EU» и «Shopify US». Название появляется в заголовке push, так что их легко различить, и можно направлять каждый в отдельное приложение Pocket Alert.

А Stripe или WooCommerce?

Для Stripe есть отдельное руководство: уведомления о платежах Stripe. Для других платформ страница уведомлений о заказах интернет-магазина показывает тот же подход, а любой сервис, который отправляет JSON-вебхук, работает с инструментом для вебхуков.

Создайте бесплатный аккаунт, вставьте один адрес в Shopify и получите следующий заказ на телефон.

Поделиться статьёй