Дискорд хук — это система уведомлений в Дискорде, которая позволяет отправлять уведомления на сервер Дискорда из внешних приложений или сайтов.
Если вы хотите использовать Дискорд хук в своем приложении или на своем сайте, то существует два способа его настройки:
1. Настройка вручную
Для настройки Дискорд хука вручную вам необходимо выполнить следующие шаги:
1. Создайте новый сервер в своем Дискорд аккаунте.
2. Найдите в настройках сервера вкладку «Интеграции» и кликните на неё.
3. Перейдите к созданию новой интеграции и выберите тип «Вебхуки».
4. Укажите имя, аватарку и канал, на который будут отправляться уведомления.
5. Скопируйте полученный URL вебхука и сохраните его в своем приложении или на своем сайте.
6. Настройте код своего приложения или сайта, чтобы он отправлял уведомления на указанный URL вебхука.
Пример кода для отправки уведомления на адрес вебхука:
php $url = ‘https://discordapp.com/api/webhooks/1234567890/abc123def456ghi789jklmno’; $data = array(‘username’ => ‘Имя пользователя’, ‘content’ => ‘Текст уведомления’); $options = array(‘http’ => array(‘method’ => ‘POST’, ‘header’ => ‘Content-Type: application/json’, ‘content’ => json_encode($data))); $context = stream_context_create($options); $result = file_get_contents($url, false, $context);
2. Настройка через сторонние пакеты
Как писать от имени бота с рамками текста? / Вебхуки Дискорд
Существует множество сторонних пакетов, которые позволяют легко настроить Дискорд хук в своем приложении или на своем сайте. Один из таких пакетов — Discord PHP Webhook.
Для использования Discord PHP Webhook вам необходимо сделать следующее:
1. Установить пакет с помощью Composer.
composer require teamreflex/discordphpwebhook
2. Создать экземпляр класса DiscordWebhook, указав при этом URL вебхука и имя пользователя.
php use TeamReflexDiscordWebhookDiscordWebhook; $webhook = new DiscordWebhook(‘https://discordapp.com/api/webhooks/1234567890/abc123def456ghi789jklmno’, ‘Имя пользователя’);
3. Отправлять уведомления через метод sendMessage(), указав при этом текст сообщения и другие необязательные параметры, такие как автор, цвет сообщения, иконка и др.
php $webhook->sendMessage(‘Текст сообщения’, [‘color’ => ‘#FF0000’, ‘icon_url’ => ‘https://example.com/icon.png’]);
Таким образом, использование Дискорд хука позволит вам эффективно оповещать пользователей и администраторов о различных событиях в вашем приложении или на вашем сайте.
Источник: progery.ru
Вебхук
Вебхук — это способ оповещения клиента о произошедшем в системе событии с помощью пользовательских обратных вызовов по HTTP.
Это термин из мира WEBа и программирования. Вебхук запускается, когда на вашем сайте, в CRM, чат-боте или иной системе происходит какое-то событие. Например, человек написал комментарий или в товароучетную систему добавили новый товар. Когда происходит такое событие, сервер создает HTTP-вызов и отправляет его на адрес, указанный клиентом для получения вебхуков. Клиент вовремя получает свежие данные — клиент доволен.
Discord вебхук — что это?! [Лучший гайд]
Пользователь может настроить веб-хук так, чтобы события на одних сайтах вызывали действия на другом. Например, человек создает в интернет-магазине заказ → система отправляет вебхук в приложение владельца → приложение уведомляет владельца и отправляет человеку смету.
Зачем нужен вебхук, если есть API
Большинство API работает по принципу «Спроси меня и я отвечу». То есть для получения свежих данных, программному клиенту нужно постоянно отправлять запросы на сервер. Вебхуки работают иначе. Они как бы говорят: «Дружище, больше не нужно названивать. Если произойдет что-то для тебя важное, я сам сообщу». Схема запроса обратной связи по API.
Программный клиент регулярно опрашивает сервер о наличии изменений. Если их нет, сервер дает отрицательный ответ. Если есть — оповещает об изменениях
Если простыми словами, вебхук — как бы подписка на обновления для определенных событий. Сервер будет оповещать клиента только о тех изменениях, которые ему по-настоящему важны. Он сам сообщит об этих событиях при настройке вебхука.
Это упрощает процесс обмена данными и для программного клиента, и для провайдера. Не забываем, что вебхук — это обратный вызов по HTTP. При настройке не потребуется громоздкая инфраструктура из кода. Схема передачи данных в случае применения вебхука. Сервер сам оповещает клиента, если появится интересующая его информация. Постоянно отправлять запросы не нужно
Обычно вебхук запрашивает данные у сервера в форме POST-запроса, а программный клиент интерпретирует его самостоятельно. Для этого на клиентской стороне строится интерфейс взаимодействия с POST-запросом. Пользователь самостоятельно определяет случаи, при которых сервер должен оповестить об изменениях, вебхук захватывает данные и передает клиенту, а тот их идентифицирует и интерпретирует.
Когда применяется API, адреса для запроса данных формируются и предоставляются клиенту самим сервером. Программный клиент вызывает эти адреса и получает интересующие его изменения. Или не получает, если их нет. Пример запросов к API от клиентского приложения. Клиент запрашивает данные о созданных и прочитанных сообщениях и комментариях
Вебхук работает в обратном порядке: URLы для отправки запроса формируется клиентом. А сервер, если на его стороне происходит важное для пользователя событие, использует эти URLы для отправки оповещения программному клиенту.
Представим, что пользователь хочет получать уведомления всякий раз, когда на его площадке появляется новое сообщение. Он создает необходимый интерфейс и настраивает вебхуки. Затем:
- Какой-то пользователь публикует сообщение
- Сообщение появляется в базе данных сервера
- Сервер вызывает адрес вебхука
- Программный клиент получает уведомление о том, что доступно новое сообщение
Как выглядит вебхук
По сути, вебхук — это программный код. Обычно он состоит из двух частей — переменной и самих данных. Например, как здесь. «First name» — это переменная, а «Anton» — это данные, которые передаются с помощью вебхука, которые постоянно меняются и подставляются системой. Количество переменных определяется софтом, на события в котором реагирует вебхук
Предпринимателю, маркетологу и другому обывателю не нужно понимать, а тем более составлять код. Почти всегда система сама составляет код и отправляет его в виде запроса на указанный клиентом адрес. А там этот код отображается уже в графическом интерфейсе в виде набора данных.
Как используют вебхуки на практике
Сегодня вебхуки используются повсеместно. Вот несколько примеров на скорую руку:
- Github — веб-сервис для хостинга IT-проектов и их совместной разработки, использует вебхуки, чтобы оповещать владельцев аккаунтов о новых сообщениях, выпущенных обновлениях, иных события
- Мой склад — отечественная систему управления торговлей, использует вебхуки для оповещения клиентов о создании покупателями заказов и изменении их статусов, изменении цены товара, обновлении номера телефона контрагента и т.д.
- Callibri — система коллтрекинга, использует вебхуки для оповещения сторонних систем клиента о совершенных звонках, полученном электронном письме, заявке, сообщении в чате
Чтобы упростить работу с вебхуками, поставщики данных предоставляют пользователям готовые интерфейсные панели. На них можно создать новый вебхук, указать URL, на который будет отправлен вызов, выбрать событие и передаваемые параметры. Пользователю не нужно возиться с кодом — он заполняет простую форму, а за программную часть работы отвечает поставщик данных. Панель для создания и управления вебхуками от сервиса Callibri. Пользователь указывает адрес для отправки запроса, задает событие и его параметры. А все остальное делает сам сервис
Создаем тестовый вебхук
Кажется, что работать с вебхуками, при наличии программной панели от поставщика данных, просто. Перейдем от теории к практике — посмотрим, как это работает на примере.
Чтобы создать тестовый вебхук, не нужен свой сайт или приложение. Проверить работоспособность входящего запроса можно с помощью специального сервиса — Webhook.site. Он генерирует для вас тестовый урл, который можно использовать для отправки POST-запроса и проверки его содержимого на этом же сайте. Показываем, как это работает. Для проверки будем использовать свой репозиторий на Github.
- Переходим на Webhook.site. Получаем сгенерированный урл, копируем его в буфер обмена
- Оставляем страницу сервиса открытой. Скопированный адрес передаем провайдеру данных. Для этого используем свой репозиторий на Github. В нем переходим в раздел настроек, выбираем раздел с вебхуками и настраиваем новый
- Заполняем открывшуюся форму. Вставляем скопированный адрес для отправки запроса. В строке Content type ставим application/json. А затем выбираем события, на которые будет реагировать сервис и отправлять вебхук. Для тестирования инструмента выбираем в качестве интересующего события выбираем публикацию или изменение комментариев к нашему репозиторию. Сохраняем вебхук
- Оставляем комментарий к коммиту и смотрим на Webhook.site, что получилось
- Видим, что сразу после публикации комментария поставщик данных отправил на вставленную нами ссылку POST-запрос. Слева размещено оповещение про сам запрос, а справа — детализация. Изучив информацию увидим, что провайдер отправил нам исчерпывающую информацию даже для такого простого события, публикация комментария
Если вы пользуетесь сервисом, который дает возможность отправлять уведомления с помощью вебхуков, протестируйте его похожим образом. Например, если используете Dropbox, можно протестировать отправку уведомлений для события «внесение изменения в файл».
Помощь в отладке вебхуков
Вебхуки являются ассинхронной моделью программирования, поэтому их ручная отладка часто вызывает сложности. Мы поговорили с нашим отделом разработки и они рассказали нам про несколько сервисов, которые сильно упрощают процесс отладки. Если вы программируете и отлаживаете вебхуки самостоятельно или планируете это делать, вам будет полезно знать про:
- Pipedream — собирает запросы вебхуков и проверяет их удобным вам способом. Создает общедоступную конечную точку, чтобы получать и проверять HTTP-запросы из любого источника, а также легко проверять заголовки, полезную нагрузку и другие данные
- Postman — моделирует REST и POST-запросы
- ngrok — локальный сервер для тестирования программного кода на вашем компьютере
- httpresponder — сервис для создания конечных точек сбора и ответов на вебхуки в формате JSON или XML-файлов
Безопасно ли пользоваться вебхуками
Обычно механизм использования вебхуков предусматривает доставку данных программному клиенту через публичные адреса URL. Это небезопасно: любой может перехватить эти адреса и подменить передаваемые данные в своих корыстных целях. Но этого можно избежать. Есть несколько способов:
- Использовать HTTPS — это расширение протокола HTTP для поддержки шифрования в целях повышения безопасности
- Генерировать URLы для отправки вебхуков с уникальными токенами. Например, вот такие: http:suite/index.php?tkn=9e1891552fa7b0c0686b336, где 9e1891552fa7b0c0686b336 — уникальный идентификатор
- Реализовать базовую идентификацию доступа по технологии HTTP Basic authentication. При получении POST-запроса программный клиент запросит имя пользователя и пароль
- Работать с поставщиками данных, которые подписывают отправляемые с сервера запросы специальным ключом и проверяют подлинность подписи. Например, тот же Github использует для проверки целостности переданной информации код идентификации HMAC
О чем нужно помнить, если используешь вебхуки
Возможна потеря данных. Бывает, что доставив запрос с данными программному клиенту, вебхук перестает отвечать. Обычно это связано с ошибкой на стороне сервиса. С чем бы это ни было связано, из-за такой ошибки всегда есть риск потерять данные. Поэтому мы советуем заранее готовиться к тому, что приложение или сайт могут упасть.
Узнайте заранее, как поставщик данных обрабатывает ответы и создает ли он резервные копии на случай, если сервис ляжет.
Приложение может не выдержать нагрузку. В зависимости от вида вашей деятельности и настроенных триггеров, события на стороне сервера могут происходить слишком часто. Чем больше триггеров для отправки вебхука вы задаете, тем чаще программный клиент будет получать POST-запросы. Убедитесь, что ваше приложение готово к получению запрашиваемого объема данных.
Если на сервере возникнет высокая активность, клиентское приложение может не выдержать нагрузки. Так бывает, например, при DDoS-атаках.
Не стоит передавать через вебхуки данные. Технически технология вебхук позволяет передавать программному клиенту объемные массивы данных. Но делать этого не стоит. Используйте вебхуки лишь для уведомления об изменении состояния на сервере. А когда сигнал получен — вызывайте API,запрашивайте данные и получайте настоящую нагрузку.
Такой способ позволяет надежнее обрабатывать данные и не перегружать систему.
Коротко про вебхук
- Вебхук — это способ оповещения клиента о произошедшем в системе событии с помощью пользовательских обратных вызовов по HTTP
- Вебхук — это альтернатива API. Для проверки изменения данных в API программный клиент должен самостоятельно направлять запросы на сервер и ждать ответ. Вебхук работает в обратном порядке. Пользователь указывает адрес, на который отправляется запрос в случае возникновения важного события
- Вебхуки используют повсеместно. Чаще всего их применяют разработчики полезного клиентского софта для отправки клиентам различных оповещений об изменениях в системе. Например, о получении сообщения или добавлении нового товара
- Чтобы клиентам было легко запускать вебхуки, разработчики софта дают доступ к специальной панели, на которой можно добавить нужный адрес, задать событие и параметры
- Использовать вебхуки не всегда безопасно. Чтобы обеспечить конфиденциальность, используют протоколы HTTPS и другие инструменты безопасности
Источник: okocrm.com
Что такое вебхук, как и зачем его использовать
На официальных сайтах владельцы компаний часто размещают уведомления о новых событиях для сотрудников, дилеров и посетителей. К ним относятся акции, распродажи, расширение ассортимента, появление структурных подразделений и открытие филиалов и представительств в новых городах. Важно также организовать обмен информацией со сторонними ресурсами, например, с партнерскими сайтами. Интегрировать данные и выбирать их получателей поможет вебхук. Рассказываем, как он работает и как его создать.
Что такое webhook
Вебхук (webhook) – это способ отправки уведомлений пользователю сайта. Если данные на сайте меняются, сервер создает HTTP-вызов и отправляет информацию получателю через вебхук. В данных будет указан тип события и ссылка на объект. Например, в товароучетную систему внесли новый продукт. Система сформирует уведомление и отправит его пользователю через вебхук.
Как выглядит
- Посетитель сайта публикует комментарий.
- Это сообщение заносится в базу данных сервера.
- Сервер вызывает URL вебхука.
- Клиент получает уведомление о том, что появился свежий комментарий.
В чем разница между API и вебхуками
Информацию об изменениях в системе можно получать через API или вебхук. Оба способа помогают одной программе взаимодействовать с другой.
Принцип работы АПИ – отправка циклических запросов и получение данных в ответ. То есть пользователю нужно постоянно запрашивать информацию у сервера, чтобы получить новые данные.
Вебхук же работает по принципу подписки: вы однократно настраиваете оперативное уведомление для посетителей сайта, а система автоматически оповещает их о новых событиях в компании.
Когда нужно использовать API, а когда – вебхук
Вебхук только уведомляет об изменениях в системе. Он полезен, когда нужно:
- сформировать заказы клиентов и обновить их статусы;
- изменить цену продукта;
- обновить номер телефона.
Для работы с базами данных нужен API. Он позволяет создавать, читать, изменять и удалять информацию.
Чтобы оценить эффективность вашей рекламной кампании и оптимизировать бюджет на маркетинг, пользуйтесь специальными сервисами. Подключите сквозную аналитику Calltouch. Программа отследит все лиды, заявки и продажи, выведет на удобные дашборды статистику по рекламным доходам и расходам. Вы сможете скорректировать свою маркетинговую стратегию и отказаться от убыточных рекламных вложений.
Сквозная аналитика Calltouch
- Анализируйте воронку продаж от показов до денег в кассе
- Автоматический сбор данных, удобные отчеты и бесплатные интеграции
Примеры использования webhook
Вебхуками пользуются на всех крупных площадках. Например:
- Github. Сервис для разработки и хостинга IT-проектов – сайтов, программ, приложений. С помощью вебхуков авторизированных пользователей оповещают об обновлениях программы, полученных сообщениях и других событиях. Например, администратору могут приходить уведомление каждый раз, когда происходит резервное копирование данных.
- Мой склад. Это система управления торговлей. Когда покупатель создает или оплачивает заказ или в магазине меняется цена товара, система через вебхуки оповещает администратора об этих событиях.
Как создать тестовый вебхук
Для создания тестового вебхука иметь свою площадку необязательно. Воспользуйтесь сервисом Webhook.site. Действуйте следующим образом:
- Перейдите на сайт. Система сгенерирует уникальный URL для вебхука. Скопируйте его в буфер обмена, кликнув на кнопку рядом со ссылкой. Не закрывайте страницу.
- Перейдите на нужном вам сайте в раздел настроек, найдите опцию «Вебхук». Появится форма для настройки.
- В строку для URL вставьте скопированную ссылку. В поле «Тип контента» или «Content type» выберите «application/json». Выберите события, о которых вы хотите получать уведомления.
- Сохраните вебхук.
- Вернитесь во вкладку Webhook.site. Если вы все сделали правильно, поставщик данных отправит ответ на ваш запрос. Слева будет оповещение, а справа – детализация запроса.
Calltouch Лидс
Увеличивайте % в продажи
с автоматизированной платформой
Безопасность использования
Вебхуки доставляют данные через публичные URL. Адреса могут перехватить, подменить в них данные.
Чтобы избежать подобных рисков, воспользуйтесь советами:
- Используйте расширение HTTP – HTTPS. Оно поддерживает шифрование и может обезопасить от посторонних манипуляций с данными.
- Создавайте URLы с уникальными идентификаторами.
- Идентифицируйте доступ к вебхуку по технологии HTTP Basic authentication. Программа запросит имя пользователя и пароль.
- Работайте с поставщиками данных, которые защищают данные кодом идентификации, например, HMAC.
Подключите сервис Антифрод Calltouch. Программа защитит вашу компанию от накрутки звонков недобросовестными рекламными подрядчиками. Сервис проанализирует количество звонков с одного и того же номера, проверит его активность после звонка. Он выявит сомнительные звонки, классифицирует и посчитает их. Благодаря Антифроду вы сэкономите время сотрудников на обработку нецелевых обращений, отключите убыточные площадки и сэкономите бюджет.
Автоматически выявляет некачественные звонки, которые не приводят к продажам, а просто расходуют бюджет.
- Выявляет и тегирует сомнительные звонки от недобросовестных рекламных подрядчиков или спам
- Позволяет учитывать в отчетах только качественные обращения
- Упрощает контроль подрядчиков
Ограничения при работе с вебхуками
Если вы решили использовать вебхуки, учтите:
- их может настраивать только администратор сайта;
- работать можно только через JSON API.
Как проверить, что вебхук работает
Работоспособность вебхука можно проверить через специальный сервис. Он создаст тестовый URL и покажет нужный вам тип уведомлений.
- Откройте сайт. Скопируйте ссылку из строки с подписью «Your unique URL (Please copy it from here, not from the address bar!)»
- Создайте вебхук. В теге «URL» укажите сгенерированную ссылку.
- Создайте новое событие (в своей программе). Вы можете ввести его через JSON API – файл с объектами данных и их атрибутами.
Проверьте наличие уведомления по вашей уникальной ссылке.
Коротко о главном
Вебхук помогает посетителям сайта узнать об изменениях, которые происходят в системе. Их часто используют разработчики софта, чтобы оповещать клиентов о новых действиях в системе. Создайте вебхук и уведомляйте пользователей о новинках, изменении цены товара, новых сообщениях. Настроить вебхук несложно, но важно позаботиться о безопасности передачи данных.
Маркетинг
«Будьте вежливы и решайте проблемы своих клиентов»: эксперт по социальным медиа Андрей Фрольченков о SMM в новой реальности
«Будьте вежливы и решайте проблемы своих клиентов»: эксперт по социальным медиа Андрей Фрольченков о SMM в новой реальности
Источник: www.calltouch.ru