Вебхук — це спосіб доставки даних між різними програмами. Це дозволяє надсилати згадки з YouScan в інші програми вручну або автоматично 🙌
Якщо ви не можете знайти потрібний додаток у списку доступних інтеграцій, ви можете налаштувати власну інтеграцію через Webhook. У цій статті ми навчимо вас, як це зробити.
⚠️ Чи є якісь обмеження джерела?
Дані з наступних джерел недоступні:
Reddit
Quora
деякі невеликі джерела
Ми обмежуємо дані, до яких можна отримати доступ для згадок, зібраних з Twitter.Застосовуються наступні коригування:
Властивості згадки 'Text' та 'Full Text' видалено
Згадка URL видалена
URL автора, ім'я автора та URL аватара автора видалено
Ідентифікатор профілю автора додано до інформації про автора (сам ідентифікатор є ідентифікатором профілю Twitter)
Ідентифікатор публікації — це ідентифікатор Твіту
Поєднання ID профілю та ID допису дозволяє перейти до конкретного Твіту, який був зібраний як відповідна згадка.
Налаштування інтеграцій Webhook
Потрібно трохи налаштувати бекенд додатку, який ви хочете інтегрувати з YouScan.
💡 Ви можете знайти інформацію про налаштування додатку в його базі знань або у розділах підтримки.
У YouScan потрібно виконати наступні 2 кроки:
Відкрийте тему «Settings», перейдіть на вкладку Integrations і натисніть «Add» поруч із 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