WebHooks
Веб-хуки позволяют по разным событиями (новый заказ, новый пользователь, редактирование заказа и т.д.) отправлять редактируемые данные на сторонние сервисы автоматизации процессов APIXDrive и Zapier.
Модуль доступен в административной панели магазина в меню Модули → Управление модулями → Разработчикам - WebHooks - Включить. Затем открыть модуль в меню Модули → WebHooks. Добавление нового веб-хука находится в закладке Обзор WebHooks.
В обзоре WebHooks нажмите ➕ Добавить и выберите действие срабатывания веб-хука:
Новый заказ
Изменение заказа
Списание товара со склада
Новый товар
Изменение товара
Новый пользователь
Изменение пользователя
В поле URL WebHook указывается уникальный адрес внешнего сервиса приема данных, например: https://s1.apix-drive.com/web-hooks/62652/lc56dfkhbq89f
Поле Название служит для комментария назначения веб-хука. Метод передачи POST или GET задается сервисом приема данных.
В Обзоре WebHooks отображаются все созданные веб-хуки.
В разделе Журнал операций отображаются все запросы со статусом ответа.
По ссылке имени действия в колонке Действие отобразится полный лог переданных данных.
[parameters] => Array([name] => 24-14[sum] => 800[date] => 25-09-2020[comment] =>[adress] =>[fio] =>[tel] => (926) 969-6636[tracking] =>[paid] =>[status] => Новый заказ[email] => [email protected].ru[payment] => Наличная оплата[positions] => Array([0] => Array([name] => Футболка Springfold 37 бледно-голубой[quantity] => 1[uid] =>[price] => 800[discount] => 0[vat] => 18)))[response] => данные приняты
Для анализа получаемых данных от веб-хуков рекомендуем использовать сервис https://webhook.site
ApixDrive - это простой способ «подружить» разные приложения и сервисы между собой без программирования и специальных знаний.
Для регистрации в APIXDrive достаточно перейти на официальный сайт и заполнить форму нового пользователя.
С помощью модуля WebHooks и сервиса APIXDrive создадим функцию передачи сообщения о новом заказе в Telegram.
Перейдем в раздел Главная - ➕ Создать связь. В качестве источника данных нужно выбрать Webhook (источник). Нажимаем кнопку Продолжить.
На закладке Действие выбираем действие Принять данные. Нажимаем кнопку Продолжить.
В закладе Доступ выбираем свой аккаунт. Нажимаем кнопку Продолжить.
В закладке Настройка выводится URL для приема данных. Копируем этот URL для использования в модуле WebHooks. Нажимаем кнопку Продолжить.
В закладке Фильтр нажимаем кнопку Продолжить.
Далее нам нужно перейти в модуль WebHooks и создать новый веб-хук с URL адресом для приема данных, показанным на предыдущем шаге в закладке Настройка. В качестве действия веб-хука следует выбрать Навый заказ.
Далее необходимо активировать этот веб-хук на действие нового заказа, для этого делаем новый заказ из пользовательской части интернет-магазина как обычный покупатель.
Переходим обратно в управление APIXDrive и нажимаем кнопку Загрузить тестовые данные из Webhook (источник). Появляется таблица данных нового заказа - это значит веб-хук сработал и передал данные в APIXDrive. Если таблицы с данными нет, то веб-хук не сработал и следует проверить его настройки. Нажимаем кнопку Далее.
На следующем этапе видим сообщение об успешной настройки и нажимаем кнопку Начать настройку приема данных.
В закладке Система выбираем систему Телеграм. Нажимаем кнопку Продолжить.
В закладке Действие выбираем Отправить сообщение. Нажимаем кнопку Продолжить.
В закладке Доступ выбираем Подключить аккаунт. В появившемся окне кликните Сохранить.
Далее, откроется новое окно, в котором нужно скопировать данные в поле Строка для подключения Телеграм-бота, закрыть это окно, перезагрузить страницу и выбрать созданный аккаунт. В Вашем приложении Телеграм в строке поиска введите apix-drive. Нажмите на профиль бота и кликните Запустить.
Более подробная инструкция по подключению Телеграм-бота доступна по ссылке https://apix-drive.com/ru/help/telegram. Нажимаем кнопку Продолжить.
В закладке Настройки можно указать какое сообщение будет отправлено в Телеграм. Справа в селекторе можно выбрать данные, полученные от модуля WebHooks из интернет-магазина. Нажимаем кнопку Продолжить.
У вас новый заказ №{name:none:80537} на сумму {sum:none:80537} руб.
В закладке Тест отображается пример сообщения, которое будет отправлено в Телеграм.
Можно нажать кнопку Отправить тестовые данные в Телеграм и получить это сообщение у себя в Телеграм. Нажимаем кнопку Далее.
Настройка Приема Данных успешно завершена. Нажимаем кнопку Включить автообновление.
Цепочка связей настроена и теперь вы сможете получать оповещение о новом заказе в свой Телеграм от чат-бота ApiX-Drive | Уведомления.
Zapier - это англоязычная платформа для передачи данных между любимыми веб-приложениями с помощью программного обеспечения, поддерживающего более 300 приложений.
Для регистрации в Zapier достаточно перейти на официальный сайт и заполнить форму нового пользователя.
С помощью модуля WebHooks и сервиса Zapier создадим функцию передачи сообщения о новом заказе в Gmail.
Перейдем в раздел Главная - ➕ MAKE A ZAP. В качестве Choose App нужно выбрать Webhooks by Zapier. В качестве Choose Triger Event нужно выбрать Catch hook. Нажимаем кнопку COUNTINUE.
На втором шаге Customize Request появится Custom Webhook URL, который нам нужно скопировать в настройки модуля Webkooks. Нажимаем кнопку COUNTINUE.
Далее нам нужно перейти в модуль WebHooks и создать новый веб-хук с Custom Webhook URL, показанным на предыдущем шаге в закладке Customize Request . В качестве действия веб-хука следует выбрать Навый заказ.
Далее необходимо активировать этот веб-хук на действие нового заказа, для этого делаем новый заказ из пользовательской части интернет-магазина как обычный покупатель.
На третьем шаге Find Data мы должны протестировать связь, для этого нажимаем кнопку Test triger.
Если тест пройден, то появляется таблица принятых данных из нового заказа. Если тест не прошел, то требуется проверить правильность заполнения полей в настройках модуля Webhooks. Нажимаем кнопку COUNTINUE.
На следующем этапе Choose App & Event выбираем приложение Gmail в качестве Choose App и Send Email в качестве Choose Action Event. Нажимаем кнопку COUNTINUE.
Далее выбираем свой Gmail account, с которого будет рассылаться почта. Нажимаем кнопку COUNTINUE.
Далее следует настроить параметры почтового сообщения. В качестве поля To выбираем поле Email из данных, которые пришли на этапе тестирования. В поле From выбираем свой Gmail аккаунт.
В поле Body вводим текст сообщения, которое будет отправляться покупателю. За место номера заказа и суммы заказа выбираем поля Name и Sum из предложенного списка. В поле Subject заполняем заголовок письма "Спасибо за покупку".
Спасибо за ваш заказ №{{100459341__name}} на сумму {{100459341__sum}} руб.
На следующем этапе Send Data жмем кнопку TEST & CONTINUE и затем TERN ON ZAP.
На указанный email покупателя поступит сообщение с данными заказа.
Модуль доступен для версии PHPShop 6.0.9+ и только для редакции PHPShop Pro.
