Webhook – это способ доставки оповещений между системами. Он позволяет отправлять информацию по ручному или автоматическому запросу из YouScan в другую систему 🙌

Если вы не нашли необходимый сервис в списке готовых интеграций, настройте интеграцию через Webhook. В статье расскажем, как это сделать :)

Настройка Webhook-интеграции

Часть настройки нужно сделать на стороне системы, с которой вы интегрируете YouScan.
💡 Разобраться в настройках интегрируемой системы вам может помочь её База знаний или Поддержка.

В YouScan необходимо выполнить следующих 2 шага.

  1. Откройте «Настройки» темы, подраздел «Интеграции» и нажмите «Добавить» напротив Webhook.

  2. Укажите адрес, на который YouScan будет отправлять оповещения.

💡 Отправка оповещений из YouScan настраивается для каждой темы. Вы можете указать один адрес в нескольких темах и добавить несколько вариантов вебхуков в одну тему.

Работа с Webhook-интеграцией

Два способа отправки упоминаний:

Структура упоминаний

По Webhook передаются параметры упоминаний доступные в интерфейсе. Среди них:

  • информация об авторе;

  • место и источник публикаций;

  • текст упоминания;

  • информация о вовлечении.

Полный перечень полей, который доступен при отправке из YouScan:

{
  "country":, //страна автора
  "region":, //область автора
  "city":, //город автора
  "topicId":,//номер темы мониторинга *
  "topicName":, //название темы *
  "mentionId":, //номер упоминания в теме *
  "sourceName":,//названия источника
  "author": { //информация об авторе
    "url":, //ссылка на профиль
    "name":, //имя
    "nickname": //никнейм
    "avatarUrl":, //ссылка на аватар
    "subscribers": //аудитория
  },
  "channel": { //карточка страницы публикации
    "url":, //ссылка на страницу
    "name":, // название
    "avatarUrl":, //ссылка на аватар
    "subscribers": //аудтория
  },
"tags": [], // теги упоминаний
  "title":, // заголовок сообщений
  "text":, // текст упоминания (сниппет с ключевым словом)
  "url":, // ссылка на сообщение *
  "published":, // время публикации *
"addedAt":, // время сохранения упоминания в тему
  "sentiment":, // тональность упоминания
  "imageUrl":, // ссылка на картинку в сообщении
  "language":, // язык сообщения
  "postType":, // тип публикации *
  "resourceType":, // тип площадки, на которой размещена публикации *
  "spam":, // оценка сообщения как спам (да/нет) *
  "postId":, // уникальный номер публикации упоминания
  "parentPostId":, // номер родительской публикации для данного упоминания
  "discussionId":, //номер дисскусии публикации
  "likes":, // количество лайков
  "reposts":, // количество репостов
  "comments":, // количество комментариев
  "engagement": // сумма всех реакций
}
* – обязательные поля в YouScan, будут у каждого упоминания

Вы нашли ответ?