Shopify и WhatsApp: Интеграция, которая заняла у нас 6 месяцев

Что реально охватывает интеграция

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

Кроме этого, необходимо, чтобы каталог продуктов был доступен внутри WhatsApp-диалога, чтобы ИИ мог ответить на вопрос «какие размеры есть в синей курте?», не вынуждая клиента покидать WhatsApp и идти на сайт. Для этого нужна синхронизация каталога, которая остаётся актуальной по мере изменения запасов.

Типичные ошибки, которые вас тормозят

Первая ошибка — ненадёжность webhook'ов. Shopify отправляет webhook'и при событиях заказа: заказ оформлен, заказ отправлен, заказ доставлен, возврат создан. Но webhook'и могут не доходить. Система доставки на принимающей стороне должна обрабатывать повторные попытки, дедупликацию и журналирование ошибок. Большинство разработчиков сначала строят «счастливый путь» и обнаруживают режимы сбоев через шесть недель, когда клиент жалуется, что так и не получил уведомление об отправке.

Вторая ошибка — несоответствие форматов номеров заказов. Идентификаторы заказов Shopify числовые. Ваш бренд может отображать клиентам форматированный номер заказа вида #RL-2847. Система должна обрабатывать поиск по обоим форматам, потому что клиент воспользуется тем, что у него перед глазами.

Третья ошибка — задержка при одобрении шаблонов WhatsApp. Каждое исходящее WhatsApp-сообщение, которое не является прямым ответом на сообщение клиента, требует предварительно одобренного шаблона. Процесс одобрения Meta занимает от 24 до 72 часов, а отказы при первой подаче — обычное дело. Это проблема планирования: шаблоны нужно подавать заблаговременно, а не за неделю до запуска.

Первые три месяца мы использовали сторонний коннектор. Каждый раз, когда Shopify обновлял API, что-то ломалось. Мы перешли на нативную интеграцию, и нагрузка на обслуживание упала практически до нуля.

Почему нативная интеграция важнее сторонних коннекторов

Сторонних коннекторов для интеграции Shopify-WhatsApp много, и они часто дешёвые. Для простых случаев они работают хорошо: отправка подтверждений заказа и уведомлений об отправке. Но для всего более сложного они не справляются.

Конкретная проблема коннекторов в том, что они не предоставляют ИИ-слою полную модель данных Shopify. Коннектор может отправить уведомление об отправке. Он не может ответить на вопрос «каков срок возврата товара, который я заказал в прошлом месяце?», потому что у него нет контекстных данных о товаре, связанных с данными заказа, связанными с данными клиента.

Нативная интеграция означает, что ваш ИИ имеет живой доступ к полному объекту заказа, объекту клиента, объекту продукта и объекту выполнения. Именно этот контекст делает возможными по-настоящему полезные диалоги, а не просто отправку уведомлений.

Как работает синхронизация каталога (и что идёт не так)

WhatsApp Commerce позволяет загрузить каталог продуктов, доступный в диалогах. Каталог синхронизируется через Meta Commerce API. Каждому товару нужны заголовок, описание, цена, URL изображения и уникальный идентификатор контента, связанный с вашим SKU в Shopify.

Синхронизация должна выполняться по расписанию, соответствующему темпу изменений вашего инвентаря. Для большинства D2C-брендов достаточно синхронизации раз в 2–4 часа. Для брендов, проводящих флеш-распродажи или ограниченные дропы, важна синхронизация в режиме, близком к реальному времени. Ничто не подрывает доверие быстрее, чем WhatsApp-бот, предлагающий товар, который три часа как закончился.

Самая распространённая ошибка при синхронизации каталога — протухание URL изображений. Изображения товаров в Shopify имеют CDN-адреса. Когда вы меняете изображение товара в Shopify, старый URL перестаёт работать. Если синхронизация каталога не подхватывает новый URL, в WhatsApp-каталоге отображаются сломанные изображения. Решение — забирать изображения из объекта товара Shopify во время синхронизации, а не хранить URL статически.

Что мы сделали бы иначе, начиная с нуля

Мы бы сначала построили обработку ошибок, а потом «счастливый путь». Каждый webhook-эндпоинт, каждый вызов API, каждое задание синхронизации каталога должны иметь логирование и оповещения до выхода в продакшн. Обнаружить сбой синхронизации через три дня по жалобе клиента — разрешимая проблема, но это гораздо больший стресс, чем поймать её в мониторинге через пять минут после возникновения.

Мы бы также подали все шаблоны WhatsApp в первую неделю проекта, а не в последнюю. Сроки одобрения от вас не зависят. Всё остальное может подождать. Шаблоны — нет.