Как создать вебхук с телефона
Пользователи, которые только начинают свой путь в ведении Дискорд-сервера, часто сталкиваются с проблемой, когда всех пользователей или конкретного персонажа нужно о чем-то уведомить. Когда начинающий владелец сервера захочет решить эту проблему, он наткнется на Дискорд вебхуки. Сначала такая информация может показаться сложной, но на деле все довольно просто, и, следуя инструкции, разобраться сможет человек с любым уровнем навыков.
Для чего нужны вебхуки и их особенности
Вебхук – один из основных инструментов автоматизации сервера. Он позволяет автоматически оповещать пользователей о любых событиях и обмениваться информацией со сторонними ресурсами. Например, это может быть новое видео на каком-либо канале или информация по поводу сервера, ролей на нем. В вебхук можно поместить информацию какого угодно типа, настроить ее получателей и интеграцию на другие сайты.
Как пользоваться
Чтобы использовать вебхук, сначала нужно создать его и настроить:
На этом базовая настройка вебхука завершена, но даже на этой стадии его можно назвать волшебным ботом. Таким способом можно вручную уведомлять о какой-либо информации. Более детальная настройка потребует немного больше времени:
Такие возможности можно использовать по-разному. Например, делать красивое оформление для постов. Также с настройкой сервера и автопостингом может помочь Magic Bot.
Интеграция Дискорда с другим сервисом
Так можно создать интеграцию с любым другим сервисом – выбор на сайте очень большой.
Для чего можно использовать отправку вебхука?
Например, лиды оставляют заявку у вас на сайте, их контактные данные попадают в вашу CRM-систему и синхронизируются с SendPulse. По этим лидам стартует цепочка Automation 360 для дальнейшего прогрева. Вы хотите прозванивать всех, кто открыл третье письмо из цепочки. Для этого необходимо изменить статус лидов в вашей CRM. Именно с помощью вебхука вы можете это сделать, отправив в вашу систему данные о свершившемся событии для подписчика.
Как включить отправку вебхука в авторассылку
Укажите название вебхука и URL, на который будет отправляться вебхук. В названии вебхука разрешено использовать только цифры и латинские символы.
Настройте отправку ключа в ответ на первый вебхук, чтобы снять лимит на отправку вебхуков. Иначе сервис позволит отправлять максимум один вебхук в час.
Когда цепочка авторассылки готова, кликните «Сохранить и выйти», чтобы сохранить ее, или «Сохранить и запустить», чтобы сохранить рассылку и запустить ее.
Структура вебхука
Вебхук передает такие данные:
- ID цепочки;
- название вебхука
- дата срабатывания вебхука;
- email адрес и номер телефона подписчика, для которого сработала отправка вебхука;
- данные переменных.
В зависимости от того, по чем стартует авторассылка, в вебхуке отправляются переменные из адресной книги или события.
Как отследить отписки и жалобы на спам
Отслеживание отписок пользователей и жалоб на спам можно включить в настройках аккаунта.
В сфере веб-разработки наряду с API распространилось понятие вебхук (англ. webhook). Рост популярности этого стандарта связан с тем, что всё больше действий в вебе можно описать в терминах событий. Триггерами, запускающими вебхук, могут служить, например, отправка кода в репозиторий или публикация комментария.
Чем вебхуки отличаются от API?
В типичных API для получения информации от сервера его необходимо постоянно опрашивать. В случае вебхуков сервер как бы говорит клиенту: «Теперь тебе не придется названивать. Я сам позвоню, когда появится что-то новое».
Для вебхуков ситуация обратная: уже приложение клиента предоставляет приложению сервера адреса для вызова. А приложение сервера в свою очередь использует эти URL, когда на стороне сервера происходит какое-либо интересующее клиента событие.
Допустим, мы хотим, чтобы сервер уведомлял приложение клиента при добавлении нового комментария. Всякий раз, когда новый комментарий публикуется в базе данных на стороне сервера, приложение сервера должно (после публикации комментария в базе данных) вызывать URL вебхука, чтобы клиент знал, что доступен новый комментарий.
Примеры использования вебхуков
Оглянувшись вокруг, мы увидим, что многие компании внедрили вебхуки в своей практике. Несколько примеров:
Попробуйте свои силы
Лучший способ понять технологию применения вебхуков — это попробовать ее в деле. Давайте поэтапно рассмотрим процесс настройки и получения вебхука на реальном примере.
Даже если у вас нет приложения и соответствующих URL, можно попробовать технологию вебхуков в деле. Для таких задач создан ресурс webhook.site. Он генерирует уникальную ссылку для проверки входящих POST-запросов.
Скопируем сгенерированную ссылку, и, оставив страницу открытой, передадим URL провайдеру вебхука. Например, настроим вышеупомянутый вебхук в GitHub. Для этого перейдем в каком-либо из своих репозиториев в раздел Settings/Webhooks и нажмем кнопку Add webhook.
Заполнение открывшейся формы является процессом настройки вебхука. В поле Payload URL вставим запасенную ссылку с webhook.site. В качестве Content type выберем application/json. Далее отметим события, при которых GitHub будет отправлять запрос, например, комментарий коммита.
В конце списка нажимаем кнопку активации вебхука. Оставляем в репозитории комментарий к коммиту, чтобы протестировать механизм.
При этом GitHub в соответствии с вебхуком сразу же отправит POST-запрос на нашу ссылку. Вернувшись на страницу webhook.site, увидим, что в списке запросов добавился новый. В панели справа мы можем видеть детали запроса, заголовки и сам JSON-объект (для удобства чтения выберите пункт Format JSON).
Изучив JSON, вы заметите, что GitHub отправляет исчерпывающую информацию даже для такой простой операции, как комментарий коммита. Для сравнения в новой вкладке браузера перейдите по той же тестовой ссылке для приема запросов. Вы увидите, какую информацию дает «пустой» GET-запрос.
Аналогично можно протестировать другие интересные вам ресурсы. Например, подробное пособие есть у Slack. А Dropbox умеет высылать уведомления на универсальный идентификатор ресурса, когда пользователь вашего приложения вносит изменения в файл.
Отладка вебхуков
Вебхуки являются асинхронным методом, поэтому их отладка может оказаться довольно утомительной. К счастью, есть инструменты, упрощающие этот процесс:
Безопасность использования вебхуков
Важные замечания
При использовании вебхуков нужно помнить о нескольких важных деталях.
После доставки запроса с данными вебхуки могут перестать отвечать. Это означает, что если в приложении произойдет ошибка, данные могут быть потеряны. Поэтому, чтобы подготовиться к возможным падениям приложения, разберитесь, как провайдер вебхука обрабатывает ответы.
Если на стороне провайдера события происходят часто, такая нагрузка может закончиться падением приложения (как в результате DDoS-атаки). Убедитесь, что клиентское приложение способно обработать ожидаемый масштаб запросов.
Хотя технически вебхуки могут использоваться для передачи массивов данных, рекомендуется использовать их лишь как сигнал изменения состояния. Как только уведомление получено, нужно вызывать безопасный интерфейс API для получения настоящей нагрузки. Такое разделение позволяет повысить масштабируемость и надежность систем обработки данных.
Некоторые сайты, такие как GitHub, CircleCI или DataDog, в своем интерфейсе уже имеют подобную привязку. И все, что вам нужно сделать — это связать сайты и бота на канале. Подробная инструкция находится на официальном сайте Discord'a. На ней мы задерживаться не будем. Ведь нас интересуют ресурсы, у которых изначально нет такой фишки.
В этом случае на помощь приходят сайты, которые послужат посредником между нашими сервисами. Один из самых простых — IFTTT. С его помощью мы и настроим Webhook для необходимой платформы.
- Перейдите на IFTTT и зарегистрируйстесь/войдите в систему
- Кликните на иконку пользователя и нажмите "Create"
- Выберите из списка социальную сеть. В нашем случае это будет Twitter
- Выберите "New tweet by a specific user"
- Ввведите Twitter пользователя, за которым вы будете следить, и кликните на "Create trigger"
- Перейдите на сервер Discord и откройте настройки сервера
Перейдите во вкладку Вебхуки и нажмите на Создать вебхук
Поменяйте ему имя и выберите канал, в котором хотите, чтобы он писал (также загрузите аватарку по желанию). После этого скопируйте URL вебхука и вернитесь на IFTTT
- Заполните поля:
- В URL введите ссылку на ваш URL вебхука
- В Method выберите Post
- В Content type выберите application/json
- В Body скопируйте и вставьте следующий текст:
"username":"replace_with_bot_displayname", "icon_url":"replace_with_userimage_url",
"content":"@> tweeted this at >: >"
Вот и все. Теперь на нашем канале будут появляться посты из закрепленного Twitter-аккаунта. По аналогии делается привязка к Twitch-трансляциям и каналу на YouTube.
Читайте также: