Вебхук — це спосіб доставки даних між різними програмами. Це дозволяє надсилати згадки з YouScan в інші програми вручну або автоматично 🙌
Якщо ви не можете знайти потрібну програму в списку доступних інтеграцій , ви можете налаштувати спеціальну інтеграцію за допомогою Webhook. У цій статті ми навчимо вас, як це зробити.
⚠️ Згадки з Reddit не можна запитувати через Webhook.
Налаштування інтеграцій Webhook
Потрібно трохи налаштувати бекенд додатку, з яким ви хочете інтегрувати YouScan.
💡 Ви можете знайти інформацію про налаштування додатку в його базі знань або в розділах підтримки.
У YouScan вам потрібно виконати наступні 2 кроки:
Відкрийте тему «Параметри», перейдіть на вкладку «Інтеграції» та натисніть «Додати» поруч із «Вебхук».
Укажіть 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)Наша інтеграція webhook підтримує базову автентифікацію . Щоб установити ім’я користувача та пароль, використовуйте URL зворотного виклику в такому форматі:
https://user:password@example.com/callback