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