WebHooks в Athom Homey 2.x

Для чего это

Данная функциональность позволяет простым get-запросом из любого угла необъятной сети Интернет вызвать flow в Колобке.

Например, переход по ссылке

https://здесь_мой_homey-cloud-id.connect.athom.com/api/manager/logic/webhook/ledring?tag=on

с любого подключенного к интернету устройства, включит светодиодный обод на моем Homey.

Мой пример использования

Я использую WebHooks (вебхуки) для того, чтобы достучаться до Homey из HomeAssistant.

Пример кода в HomeAssistant's configuration.yaml:

switch: - platform: command_line switches: homey_led_ring: command_on: curl https://homey-cloud-id.connect.athom.com/api/manager/logic/webhook/ledring?tag=on command_off: curl https://homey-cloud-id.connect.athom.com/api/manager/logic/webhook/ledring?tag=off

Таким образом я получаю в HomeAssistant'е переключатель, который, используя настроенную связку webhook-flow, включает/выключает светодиодный ободок Homey.

Не забудьте, что homey-cloud-id надо заменить на Ваш Homey Cloud ID.

Достаем Homey Cloud ID

Идем в Колобковое приложение, справа-внизу нажимаем More. На открывшемся экране переходим в настройки (значок шестеренки и надпись Settings), а в настройках идем в самый верхний пункт - General.

И там находим эту строчку. Нажатие на ней скопирует идентификатор в буфер обмена, после чего его нужно использовать в составе ссылки. Так сервера Athom поймут к какому именно Колобку перенаправить запрос.

Реализуем сам flow

В поле When... нажимаем Add card и ищем "webhook". Находим, выбираем.При настройке карточки A webhook has been received, в поле event вводим название для действия, которое хотим вызвать (это название надо будет указать в ссылке).Tag - это параметр, который можно передать в ссылке для каждого event. Его можно использовать в условиях и действиях в Вашем flow.Итак, еще раз состав ссылки:

https://homey-cloud-id.connect.athom.com/api/manager/logic/webhook/event?tag=Tag

Их нужно заменять на

Webhook-Говорилка

Приведу еще один пример как можно использовать вебхук и его параметры:

Простейший пример по которому, думается, не должно возникнуть вопросов.В HomeAssistant у меня есть shell_command:

shell_command: ring_homey_doorbell: curl https://my-homey-cloud-id.connect.athom.com/api/manager/logic/webhook/say?tag=кто-то звонит в дверной звонок

При вызове которой Колобок произносит фразу "кто-то звонит в дверной звонок".

В общем-то, на этом и всё. Все возникшие вопросы задаем в комментарии или в профильный чат. 

Удачных всем вебхукизаций!