Что такое Webhook?

Webhook это способ оповещения о событии в момент его совершения, в отличие от API, где для получения информации от сервера, его необходимо все время опрашивать. 

Когда происходит нужное нам событие, сервер сам отправляет HTTP-запрос на URL-адрес, указанный нами для приема вебхука. Иными словами, мы "подписываем" сторонний сервис на оповещения о происходящем на нашем сайте.  

Сейчас есть много известных компаний, которые используют вебхуки, однако самым ярким представителем является англоязычный сервис Zapier он создал интерфейс создания вебхуков, понятный и доступный даже новичку. Не так давно, появился его русскоязычный аналог  APIXDrive. PHPShop теперь легко интегрируется с этими сервисами. 

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

1. В админпанели PHPShop версии Pro нужно включить модуль webhook: Модули Управление модулями Разработчикам - WebHooks - Включить. Затем открыть модуль в меню Модули WebHooks.
2. В обзоре WebHooks нажмите Добавить и выберите действие срабатывания веб-хука: Новый заказ.

3. Далее регистрируемся на сервисе-коннекторе ApPIXDrive. Перейдем в раздел Главная - Создать связь. В качестве источника данных нужно выбрать Webhook (источник). Нажимаем кнопку Продолжить.

   

4. На закладке Действие выбираем действие Принять данные. Нажимаем кнопку Продолжить.

   

5. В закладке Настройка выводится URL для приема данных. Копируем этот URL для использования в модуле WebHooks. Нажимаем кнопку Продолжить.

   

6. Теперь активируем наш веб-хук для этого делаем новый заказ из пользовательской части интернет-магазина как обычный покупатель. Переходим обратно в управление APIXDrive и нажимаем кнопку Загрузить тестовые данные из Webhook (источник). На следующем этапе видим сообщение об успешной настройки и нажимаем кнопку Начать настройку приема данных

   

7. В закладке Система выбираем систему Телеграм. Нажимаем кнопку Продолжить.

   

8. В закладке Действие выбираем Отправить сообщение. Нажимаем кнопку Продолжить.

   

9. В закладке Доступ выбираем Подключить аккаунт. В появившемся окне кликните Сохранить. Далее, откроется новое окно, в котором нужно скопировать данные в поле Строка для подключения Телеграм-бота, закрыть это окно, перезагрузить страницу и выбрать созданный аккаунт. В Вашем приложении Телеграм в строке поиска введите apix-drive. Нажмите на профиль бота и кликните Запустить.

   

   Более подробная инструкция по подключению Телеграм-бота доступна по ссылке https://apix-drive.com/ru/help/telegram. Нажимаем кнопку Продолжить.

   

10. В закладке Настройки можно указать какое сообщение будет отправлено в Телеграм. Справа в селекторе можно выбрать данные, полученные от модуля WebHooks из интернет-магазина. Нажимаем кнопку Продолжить.

    

11. В закладке Тест отображается пример сообщения, которое будет отправлено в Телеграм.

    

12. Можно нажать кнопку Отправить тестовые данные в Телеграм и получить это сообщение у себя в Телеграм. Нажимаем кнопку Далее. Настройка Приема Данных успешно завершена. Нажимаем кнопку Включить автообновление. 

Цепочка связей настроена и теперь вы сможете получать оповещение о новом заказе в свой Телеграм от чат-бота ApiX-Drive | Уведомления.