Webhook - это метод доставки данных между различными приложениями.Он позволяет отправлять упоминания из YouScan в другие приложения вручную или автоматически 🙌.
Если вы не можете найти нужное приложение в списке доступных интеграций, вы можете настроить индивидуальную интеграцию через Webhook. В этой статье мы научим вас, как это сделать.
⚠️ Есть ли какие-либо ограничения источника?
Данные из следующих источников недоступны:
Reddit
Quora
некоторые небольшие источники
Мы ограничиваем данные, которые могут быть доступны для упоминаний, собранных с Twitter.Применяются следующие корректировки:
Свойства текста и полного текста упоминания удалены
Упоминание URL удалено
URL автора, имя автора и URL аватара автора удалены
Идентификатор профиля автора добавлен в информацию об авторе (сам идентификатор является идентификатором профиля в Twitter)
ID сообщения — это ID твита
Объединение ID профиля и ID поста позволяет перейти к точному твиту, который был собран как соответствующее упоминание.
Настройка интеграций Webhook
Требуется небольшая настройка на серверной части приложения, которое вы хотите интегрировать с YouScan.
💡 Вы можете найти информацию о настройках приложения в его базе знаний или в разделе поддержки.
В YouScan вам нужно выполнить следующие 2 шага:
Откройте тему «Настройки», перейдите на вкладку Интеграции и нажмите «Добавить» рядом с Webhook.
Укажите URL назначения для оповещений YouScan.
💡 Оповещения от YouScan нужно настраивать индивидуально для каждой темы.Вы можете установить одно и то же назначение для каждой темы или добавить несколько Webhooks к одной теме.
Работа с интеграцией 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влечение": // общее количество вовлечений (лайки, комментарии, доли)Наша интеграция веб-хука поддерживает Основную аутентификацию. Чтобы установить имя пользователя и пароль, используйте URL-адрес обратного вызова в этом формате:
https://user:password@example.com/callback