Webhook — это метод доставки данных между различными приложениями.Это позволяет вам отправлять упоминания из YouScan в другие приложения вручную или автоматически 🙌
Если вы не можете найти нужное приложение в списке доступных интеграций, вы можете настроить пользовательскую интеграцию через Webhook. В этой статье мы научим вас, как это сделать.
⚠️ Есть ли какие-либо ограничения по источникам?
Данные из следующих источников недоступны:
Reddit
Квора
некоторые небольшие источники
Мы ограничиваем данные, которые могут быть доступны для упоминаний, собранных с Twitter. Применены следующие настройки:
Свойства текста упоминания и полного текста удалены
Упоминание URL удалено
URL автора, имя автора и AvatarUrl автора удалены
Идентификатор профиля автора добавлен в информацию об авторе (сам идентификатор является идентификатором профиля Twitter)
ID поста — это ID Твита
Комбинирование идентификатора профиля и идентификатора поста позволяет вам перейти к точному Твиту, который был собран как соответствующее упоминание.
Настройка интеграций Webhook
Требуется немного настройки на заднем плане приложения, которое вы хотите интегрировать с YouScan.
💡 Вы можете найти информацию о настройках приложения в его базе знаний или разделах поддержки.
В YouScan вам необходимо выполнить следующие 2 шага:
Откройте тему «Настройки», перейдите на вкладку Интеграции и нажмите «Добавить» рядом с Webhook.
Укажите URL-адрес назначения для оповещений YouScan.
💡 Уведомления от YouScan необходимо настраивать индивидуально для каждой темы.Вы можете установить одно и то же назначение для каждой темы или добавить несколько Webhook'ов к одной теме.
Работа с интеграцией Webhook
Существует два способа отправки упоминаний через Webhook:
Автоматические уведомления с использованием «Правила»;
Ручная работа в потоке упоминаний.
Упоминание структуры
Вебхук позволяет отправлять параметры упоминания, доступные в YouScan, такие как:
Информация об авторе;
Источник публикации и происхождение поста;
Упоминание текста;
Метрики вовлечения.
Вот полный список параметров, доступных через YouScan:
{
"country":, //author's country
"region":, //author's region
"city":, //author's city
"topicId":,//monitoring topic ID
"topicName":, //name of your monitoring topic
"mentionId":, //mention's order number in the topic
"sourceName":,//name of the source
"author": { //information about the author
"url":, //profile URL
"name":, //author's name
"nickname": //author's username
"avatarUrl":, //author's user picture
"subscribers": //author's audience
},
"channel": { //publication source
"url":, //link to the source page
"name":, // page title
"avatarUrl":, //user picture
"subscribers": //audience
},
"tags": [], // mention tags
"title":, // post title
"text":, // post copy (snippet with keyword)
"url":, // direct URL to the post
"published":, // time of publication
"addedAt":, // time when mention was saved to topic
"sentiment":, // post sentiment
"imageUrl":, // a link to the image contained in the mention
"language":, // the mention's auto-detected language
"postType":, // post type
"resourceType":, // type of publication platform
"spam":, // determines whether the post is considered spam (Y/N)
"postId":, // unique post ID
"parentPostId":, // parent post ID
"discussionId":, // discussion ID
"likes":, // the number of likes on the post
"reposts":, // the number of shares on the post
"comments":, // the number of comments on the post
"engagement": // a total number of engagements (likes, comments, shares)
Наша интеграция вебхуков поддерживает Базовую аутентификацию. Чтобы установить имя пользователя и пароль, используйте URL обратного вызова в следующем формате:
https://user:password@example.com/callback