Вебхук — це спосіб доставки даних між різними програмами. Це дозволяє надсилати згадки з YouScan в інші програми вручну або автоматично 🙌
Якщо ви не можете знайти потрібну програму в списку доступних інтеграцій , ви можете налаштувати спеціальну інтеграцію за допомогою Webhook. У цій статті ми навчимо вас, як це зробити.
⚠️ Згадки з Reddit не можна запитувати через Webhook.
Налаштування інтеграції Webhook
Потрібно трохи налаштувати серверну частину програми, яку ви хочете інтегрувати з YouScan.
💡 Ви можете знайти інформацію про налаштування програми в її розділах «База знань» або «Підтримка».
У YouScan вам потрібно виконати наступні 2 кроки:
Відкрийте тему «Параметри», перейдіть на вкладку «Інтеграції» та натисніть «Додати» поруч із «Вебхук».
Укажіть URL-адресу призначення для сповіщень YouScan.
💡 Сповіщення від YouScan потрібно налаштовувати окремо для кожної теми. Ви можете встановити те саме місце призначення для кожної теми або додати кілька веб-хуків до однієї теми.
Робота з інтеграцією Webhook
Є два способи надіслати згадки через Webhook:
Автоматичні сповіщення за допомогою «Правил» ;
Ручна робота в потоці згадок.
Структура згадки
Webhook дозволяє надсилати параметри згадування, доступні в YouScan, наприклад:
Відомості про автора;
Джерело публікації та джерело публікації;
Текст згадки;
Показники залучення .
Ось повний список параметрів, доступних через YouScan:
{ "country":, //країна автора "region":, //регіон автора "місто":, //місто автора "topicId":,//моніторинг ідентифікатора теми "topicName":, //назва вашої теми моніторингу "mentionId":, //порядковий номер згадки в темі "sourceName":,//назва джерела "author": { //інформація про автора "url":, //URL профілю "name":, //ім'я автора "нік": //ім'я користувача автора "avatarUrl":, //фото користувача автора "підписники": //аудиторія автора }, "channel": { //джерело публікації "url":, //посилання на вихідну сторінку "name":, // назва сторінки "avatarUrl":, //зображення користувача "підписники": //аудиторія }, "tags": [], // згадати теги "title":, // назва публікації "text":, // опублікувати копію (фрагмент із ключовим словом) "url":, // пряма URL-адреса публікації "published":, // час публікації "addedAt":, // час, коли згадка була збережена в темі "sentiment":, // настрій публікації "imageUrl":, // посилання на зображення, яке міститься у згадці "language":, // автоматично визначена мова згадки "postType":, // тип публікації "resourceType":, // тип платформи публікації "spam":, // визначає, чи вважається повідомлення спамом (Так/Ні) "postId":, // унікальний ідентифікатор публікації "parentPostId":, // ідентифікатор батьківської публікації "discussionId":, // ідентифікатор дискусії "likes":, // кількість лайків публікації "reposts":, // кількість поширень допису "comments":, // кількість коментарів до публікації "залучення": // загальна кількість залучень (лайки, коментарі, поширення)Наша інтеграція webhook підтримує базову автентифікацію . Щоб установити ім’я користувача та пароль, використовуйте URL зворотного виклику в такому форматі:
https://user:password@example.com/callback