Интеграция WhatsApp Business API с Shopify через Tyntec
Настроили автоматические уведомления в WhatsApp при оформлении заказа. Покупатель сразу получает сообщение в мессенджере.
Краткая информация
- Платформа Shopify
- Мессенджер WhatsApp Business API
- Провайдер Tyntec
- Интеграция Webhook + API
- Срок 5-7 дней
Задача
Клиент Игорь обратился с запросом: есть магазин на Shopify и инструкция от Tyntec (провайдер для работы с WhatsApp Business API).
Проблема: стандартными средствами Shopify нельзя отправить сообщение в WhatsApp при заказе. Нужна дополнительная интеграция.
Цель: при оплате или создании заказа покупатель автоматически получает уведомление в WhatsApp. Это позволяет сразу начать диалог с клиентом.
Из переписки с клиентом
«Без настройки этой интеграции я вообще не могу получать сообщения от пользователей на свой номер. Цель — как можно раньше захватывать контакт клиента и побуждать его к ответу».
Детали проекта
В документации Tyntec много сценариев: активация аккаунта, доставка, отмена заказа. Спросили клиента, с чего начать.
Решили начать с одного шаблона — уведомление об оплате или размещении заказа. Если всё работает, потом можно добавить «Передан в доставку», «Брошенная корзина» и другие.
Техническое решение
Для работы интеграции недостаточно установить плагин. WhatsApp Business API требует серверной обработки.
Как это работает
- Покупатель оформляет заказ в Shopify
- Shopify отправляет Webhook (сигнал с данными) на внешнее приложение
- Приложение обрабатывает данные и отправляет запрос в API Tyntec
- Tyntec отправляет сообщение в WhatsApp клиенту
Важный нюанс
Клиент спросил, можно ли использовать его Shopify Developer аккаунт. Да, можно. Для API нет разницы, тестовый это магазин или боевой. Главное — доступ к вебхукам и активный аккаунт в Tyntec.
Что сделали
- Изучили документацию Tyntec (API Reference)
- Развернули хостинг для скрипта-обработчика
- Настроили прием Webhook от Shopify (событие
orders/createилиorders/paid) - Реализовали отправку запроса в Tyntec по утвержденному шаблону
Технические детали
WhatsApp Business API (WABA)
Это официальный API для бизнеса. Отличается от обычного WhatsApp тем, что позволяет отправлять автоматические сообщения по шаблонам.
Шаблоны нужно заранее утверждать в WhatsApp. Нельзя просто взять и отправить произвольный текст — это защита от спама.
Tyntec как провайдер
Tyntec — посредник между вашим приложением и WhatsApp. Они предоставляют API для отправки сообщений, берут на себя техническую часть.
Нужно зарегистрировать аккаунт в Tyntec, подключить номер WhatsApp Business, получить API-ключи.
Webhook от Shopify
Webhook — это автоматическое уведомление. Когда в магазине происходит событие (создан заказ, оплачен заказ), Shopify отправляет POST-запрос на указанный URL.
В настройках Shopify указываем адрес нашего скрипта и выбираем события: orders/create, orders/paid.
Серверный скрипт
Скрипт принимает данные от Shopify, извлекает нужную информацию (номер телефона клиента, сумму заказа, номер заказа) и формирует запрос к Tyntec API.
Tyntec отправляет сообщение в WhatsApp по утвержденному шаблону, подставляя переменные (имя клиента, номер заказа).
Результат
Клиент получил работающую связку. Теперь при оформлении заказа информация сразу попадает в WhatsApp покупателя.
Уведомления не теряются в почте. Клиент видит сообщение в мессенджере, где он проводит большую часть времени.
Это первый шаг к полноценной коммуникации через WhatsApp. Дальше можно добавить уведомления о доставке, возможность задать вопрос о заказе прямо в чате.