Все коллекции
Интеграции и API
API и вебхук
Как использовать интеграцию с вебхуками?
Как использовать интеграцию с вебхуками?

Отправляйте упоминания тем другим приложениям с помощью HTTP POST-запросов

Kateryna Gordienko avatar
Автор: Kateryna Gordienko
Обновлено больше недели назад

Webhook - это метод доставки данных между различными приложениями. Она позволяет отправлять упоминания из YouScan в другие приложения вручную или автоматически 🙌.

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

⚠️ Упоминания из Reddit не могут быть запрошены через Webhook.

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

Для интеграции с YouScan необходимо выполнить небольшую настройку приложения.

💡 Информацию о настройках приложения можно найти в разделах База знаний или Поддержка.

В программе YouScan необходимо выполнить следующие 2 действия:

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

  2. Укажите URL-адрес назначения для оповещений YouScan.

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

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

Существует два способа отправки упоминаний через Webhook:

  • Автоматические оповещения с помощью "Правил";

  • Ручная работа в потоке упоминаний.

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

Webhook позволяет отправлять параметры упоминания, доступные в YouScan, такие как:

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

  • Источник публикации и происхождение сообщения;

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

  • Показатели вовлечения.

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

{ "страна":, //страна автора "регион":, //регион автора "город":, //город автора "topicId":,//идентификатор темы мониторинга "topicName":, //название вашей темы мониторинга "mentionId":, //порядковый номер упоминания в теме  "sourceName":, //название источника "автор": { //информация об авторе "url":, // URL профиля  "name":, //имя автора "nickname": //авторское имя пользователя "avatarUrl":, //авторская картинка пользователя "subscribers": //аудитория автора }, "channel": { //источник публикации "url":, //ссылка на страницу источника "name":, //заголовок страницы  "avatarUrl":, //изображение пользователя "subscribers": //аудитория }, "tags": [], // теги упоминаний "title":, // заголовок поста "text":, // копия поста (сниппет с ключевым словом) "url":, // прямой URL на пост "published":, // время публикации "addedAt":, // время сохранения упоминания в теме "тональность":, // тональность поста "imageUrl":, // ссылка на изображение, содержащееся в упоминании "язык":, // автоматически определяемый язык упоминания "postType":, // тип поста "resourceType":, // тип платформы публикации "spam":, // определяет, считается ли пост спамом (Y/N) "postId":, // уникальный ID поста  "parentPostId":, // ID родительского поста  "discussionId":, // ID обсуждения "likes":, // количество лайков на пост "reposts":, // количество share на пост "comments":, // количество комментариев на пост "engвлечение": // общее количество вовлечений (лайков, комментариев, акций)

Наша интеграция с вебхуками поддерживает базовую аутентификацию. Чтобы задать имя пользователя и пароль, используйте URL-адрес обратного вызова в таком формате:

https://user:password@example.com/callback
Нашли ответ на свой вопрос?