Webhook - это метод доставки данных между различными приложениями.Он позволяет отправлять упоминания из YouScan в другие приложения вручную или автоматически 🙌.
Если вы не нашли нужное приложение в списке доступных интеграций, вы можете настроить пользовательскую интеграцию с помощью Webhook. В этой статье мы расскажем вам, как это сделать.
⚠️ Упоминания с Reddit не могут быть запрошены через Webhook.
Настройка интеграций Webhook
Необходимо выполнить небольшую настройку на серверной части приложения, которое вы хотите интегрировать с YouScan.
💡 Вы можете найти информацию о настройках приложения в его базе знаний или в разделе поддержки.
В YouScan вам нужно выполнить следующие 2 шага:
Откройте тему "Настройки", перейдите на вкладку "Интеграции" и нажмите "Добавить" рядом с Webhook.
Укажите URL-адрес назначения для оповещений YouScan.
💡 Оповещения от YouScan необходимо настраивать отдельно для каждой темы. Вы можете установить одно и то же место назначения для каждой темы или добавить несколько Webhooks к одной теме.
Работа с интеграцией Webhook
Существует два способа отправки упоминаний через Webhook:
Автоматические оповещения с помощью "Правил";
Ручная работа в потоке упоминаний.
Структура упоминания
Webhook позволяет отправлять параметры упоминания, доступные в YouScan, такие как:
Информация об авторах;
Источник публикации и происхождение сообщения;
Упоминание текста;
Показатели вовлечения.
Вот полный список параметров, доступных через YouScan:
{ "страна":, //страна автора "регион":, //регион автора "город":, //город автора "topicId":,//ID темы мониторинга "topicName":, //название вашей темы мониторинга "mentionId":, //порядковый номер упоминания в теме "sourceName":,//название источника "автор": { //информация об авторе "url":, // URL профиля "name":, //имя автора "nickname": //авторское имя пользователя "avatarUrl":, //авторская картинка пользователя "подписчики": //аудитория автора }, "channel": { //источник публикации "url":, //ссылка на страницу источника "name":, //заголовок страницы "avatarUrl":, //изображение пользователя "subscribers": //аудитория }, "tags": [], // теги упоминаний "title":, // заголовок поста "text":, // копия поста (сниппет с ключевым словом) "url":, // прямой URL на пост "published":, // время публикации "addedAt":, // время сохранения упоминания в теме "тональность":, // тональность поста "imageUrl":, // ссылка на изображение, содержащееся в упоминании "language":, // автоопределяемый язык упоминания "postType":, // тип поста "resourceType":, // тип платформы публикации "spam":, // определяет, считается ли пост спамом (Y/N) "postId":, // уникальный ID поста "parentPostId":, // ID родительского поста "discussionId":, // ID обсуждения "likes":, // количество лайков на пост "reposts":, // количество share на пост "comments":, // количество комментариев на пост "engвлечение": // общее количество вовлечений (лайки, комментарии, доли)Наша интеграция с веб-хуком поддерживает базовую аутентификацию. Чтобы задать имя пользователя и пароль, используйте callback URL в таком формате:
https://user:password@example.com/callback