Підключіть FastComments до Zapier

Підключення вашого облікового запису

1. У Zapier додайте крок FastComments до Zap або відкрийте сторінку застосунку FastComments у Zapier App Directory.
2. Виберіть Sign in to FastComments. Zapier спочатку запитає ваш регіон: оберіть United States, якщо ваш обліковий запис не було створено в регіоні ЄС (eu.fastcomments.com).
3. Відкриється вікно FastComments. Увійдіть, якщо ви ще не авторизовані.
4. Перегляньте сторінку згоди. На ній показано застосунок Zapier, обліковий запис, до якого буде здійснено підключення, та запитувані дозволи (читання і запис). Виберіть Approve.
5. Zapier зберігає підключення та підписує його назвою вашого сайту і іменем користувача.

Підключення використовує OAuth. API-ключ не копіюється в Zapier, а токен, який зберігає Zapier, діє лише для облікового запису, який ви схвалили.

Хто може підключати

Особа, яка схвалює підключення, повинна бути API admin в обліковому записі FastComments. Власники облікових записів мають цей дозвіл; іншим учасникам команди його можна надати на сторінці Users. Той, хто не має цього дозволу, побачить сторінку «у вас немає дозволу» замість форми згоди.

Підключення правильного сайту

Сторінка згоди підключає обліковий запис, у який ви зараз авторизовані. Якщо ви керуєте кількома обліковими записами, перемкніться на потрібний через перемикач облікових записів перед схваленням або скористайтеся посиланням switch account на сторінці згоди. Мітка підключення в Zapier показує назву сайту, тому помилковий вибір легко помітити.

Перегляд і відкликання доступу

Кожне підключення відображається в розділі Connected Apps на панелі керування FastComments, разом із дозволами, якими воно володіє, і часом останнього використання. Відкликання там негайно відключає Zapier; будь-який Zap, що використовує це підключення, зупиняється, доки його не буде підключено знову. Ви також можете видалити підключення з боку Zapier у розділі My Apps.

Тригери

Тригери запускають Zap, коли в FastComments відбувається якась подія. Усі три працюють миттєво: FastComments доставляє подію до Zapier через вебхук у момент її виникнення. Ніщо не опитує ваш обліковий запис і не витрачаються кредити API в очікуванні.

Кожен тригер повертає повний коментар: id, URL сторінки та URL‑ID, ім’я та електронну пошту коментатора, текст коментаря у форматі markdown та HTML, кількість голосів, прапорці схвалення та спаму, локаль, домен та будь‑які згадки. Поля відповідають навантаженню вебхука, задокументованому у розділі Webhooks, Data Structures.

Параметри

Domain. Кожен тригер має необов’язковий фільтр домену, у якому перераховані домени, налаштовані у вашому обліковому записі. Залиште його порожнім, щоб отримувати події з усіх доменів.

Include Unapproved and Spam Comments. Тільки для тригера Новий коментар. Коментарі, які утримуються на модерації або позначені як спам, за замовчуванням пропускаються. Коли такий коментар пізніше схвалюється, тригер Оновлений коментар спрацьовує для нього, тому Zap, який має реагувати на кожен коментар, що стає видимим, використовує Оновлений коментар з фільтром за полем approved.

Як працює доставка

Увімкнення Zap створює підписку на вебхук у вашому обліковому записі, видиму на сторінці Webhooks з джерелом API. Вимкнення Zap видаляє її. На кількість подій, які Zapier приймає за хвилину, діють власні обмеження Zapier; FastComments повторно намагається доставити неуспішну доставку, збільшуючи затримку, і вимикає підписку, яка продовжує провалюватися протягом шести днів. Вимкнену підписку можна повторно ввімкнути зі сторінки Webhooks, або просто вимкнути та знову увімкнути Zap, щоб створити нову.

Обліковий запис може містити до 50 підписок API. Кожен Zap, що використовує тригер FastComments, використовує одну.

Дії та пошуки

Дії створюють дані у FastComments; пошуки шукають дані, щоб наступний крок міг їх використати. Кожна дія викликає REST API FastComments і витрачає ту саму кількість API-кредитів, яку коштував би виклик з вашого власного коду: один кредит за виклик, якщо не вказано інше.

Створити коментар

Публікує коментар на сторінці.

Створити або оновити сторінку

Створює запис сторінки до появи на ній будь-яких коментарів, щоб її можна було перелічити та обмежити. Приймає URL ID, заголовок, URL та, за бажанням, ідентифікатори SSO-груп, яким дозволено її бачити. Якщо сторінка з таким URL ID вже існує, вона оновлюється наданими полями, тому Zap може запускатися для однієї й тієї ж сторінки повторно.

Створити або оновити SSO-користувача

Створює користувача єдиного входу. Приймає ваш власний ідентифікатор користувача, ім'я користувача та електронну пошту, а також необов'язкове відображуване ім'я, відображувану мітку, аватар, вебсайт, ідентифікатори груп та прапорці сповіщень і приватності. Якщо користувач з таким ідентифікатором вже існує, він оновлюється. Адміністративні ролі не можуть бути надані через Zapier.

Створити публікацію у стрічці

Створює публікацію у стрічці FastComments з HTML-контенту. Ідентифікатор користувача-автора є обов'язковим (ідентифікатор користувача FastComments або SSO); заголовок, теги та один попередній перегляд посилання є необов'язковими.

Створити або оновити хеш-тег

Створює хеш-тег, який коментатори можуть використовувати, з необов'язковою URL-адресою, на яку він посилається. Якщо тег уже існує, він оновлюється.

Позначити коментар

Позначає коментар для перевірки модератором. Потрібен ідентифікатор користувача, який позначає; підходить ідентифікатор автора, повернутий дією Create Comment.

Пошуки

Пошук, який нічого не знаходить, не призводить до збою Zap. Find SSO User та Find Page пропонують опцію Zapier «створити, якщо не існує», яка запускає відповідну дію створення, коли нічого не знайдено.

Приклади Zap'ів

Кілька робочих процесів, налаштування яких займає кілька хвилин.

Отримуйте сповіщення про нові коментарі. New Comment, потім Slack "Send Channel Message" або Discord "Send Channel Message". Зіставте ім'я коментатора, текст коментаря та URL сторінки з повідомленням. Додайте фільтр домену, щоб надсилати сповіщення на різні канали для різних сайтів.

Ведіть журнал усіх коментарів. New Comment, потім Google Sheets "Create Spreadsheet Row". Додайте Deleted Comment як другий Zap, який додає рядок з ідентифікатором коментаря, щоб таблиця також слугувала журналом аудиту.

Надсилайте листа автору, коли коментар схвалено. Updated Comment з фільтром Zapier на Approved is true, потім Gmail "Send Email". Оскільки Updated Comment спрацьовує при кожній зміні, саме фільтр забезпечує реакцію цього Zap'а лише на схвалення.

Додавайте коментаторів до CRM або списку розсилки. New Comment, потім HubSpot "Create or Update Contact" або Mailchimp "Add or Update Subscriber" з використанням email коментатора. Дотримуйтеся політики конфіденційності та місцевого законодавства, перш ніж додавати когось до маркетингового списку.

Створюйте коментар із форми. Typeform або Google Forms "New Response", потім FastComments Create Comment з ідентифікатором URL сторінки, який ваш сайт використовує для відгуків. Залиште Approved непозначеним, щоб переглядати кожен коментар перед його публікацією.

Публікуйте оголошення у стрічці. RSS by Zapier "New Item in Feed", потім Create Feed Post із заголовком, вмістом та посиланням елемента.

Надавайте учасникам статус користувачів SSO. Memberstack, Memberful або ваш власний webhook, потім Find SSO User, а за ним Create SSO User у режимі "find or create".

Ескалуйте повідомлені коментарі. Updated Comment з фільтром за кількістю прапорців більше нуля, потім Trello "Create Card" або Linear "Create Issue" з ідентифікатором коментаря та посиланням на сторінку модерації.

Публікуйте сторінки в міру їх запуску. WordPress або Ghost "New Post", потім Create Page з URL публікації, щоб сторінка була в списку та обмежена до першого коментаря.

Архівуйте видалені коментарі. Deleted Comment, потім Airtable "Create Record" з повним коментарем для зберігання відповідно до вимог.

Усунення неполадок

"У вас немає дозволу" під час підключення. Користувач, який ввійшов, не є адміністратором API в обліковому записі.
Попросіть власника облікового запису надати API‑доступ на сторінці Користувачі, або підключіться як власник.

З’єднання позначено неправильним сайтом. Сторінка згоди підключає обліковий запис, у який ви були ввійшли в той момент. Від’єднайте в Zapier, змініть обліковий запис у панелі FastComments, і підключіться знову.

Події перестали надходити. Перевірте сторінку Webhooks у панелі. Підписка, чий кінцевий пункт постійно помилявся протягом шести днів, автоматично вимикається і показує причину. Увімкніть її знову там, або вимкніть і ввімкніть Zap ще раз. Якщо підписка повністю відсутня, хтось її видалив; вимкнення і ввімкнення Zap створює її заново.

Zapier повідомляє, що обліковий запис потрібно підключити знову. З’єднання було відкликано на сторінці Підключені додатки, користувач, який його схвалив, втратив API‑доступ, або обліковий запис був видалений. Підключіться знову через Zapier.

Дія завершується помилкою "не має прав запису". З’єднання було схвалено лише з правами лише для читання. Підключіться знову і схваліть обидва дозволи.

Обмеження швидкості та кредити. Дії та пошуки витрачають API‑кредити вашого плану і підпадають під ті ж обмеження швидкості, що й REST API. Тригери не витрачають їх. Zap, який досягає ліміту, повторно виконується Zapier після затримки, яку повідомляє FastComments.

Випадаючий список Доменів порожній. Домени з’являються після їх налаштування на сторінці Доменів у панелі FastComments. Залиште поле порожнім, щоб отримувати події для всіх доменів.