Підключіть FastComments до Zapier
FastComments‑додаток для Zapier підключає ваші коментарі до тисяч інших додатків без написання коду.
Використовуйте його, щоб надсилати повідомлення в Slack, коли хтось коментує, записувати кожен коментар у електронну таблицю, створювати
коментар із надсилання форми або додавати коментаторів у вашу CRM. Тригери спрацьовують в момент, коли щось відбувається,
оскільки вони працюють на основі вебхукiв, а не опитування, і дії викликають API FastComments від вашого
імені.
Цей посібник передбачає, що у вас є обліковий запис FastComments. Ви можете створити його тут.
Підключіть свій обліковий запис 
Підключіть свій обліковий запис
- У Zapier додайте крок FastComments до Zap, або відкрийте сторінку програми FastComments у каталозі додатків Zapier.
- Виберіть Sign in to FastComments. Zapier спочатку запитує ваш регіон: виберіть United States, якщо ваш обліковий запис не був створений у регіоні ЄС (
eu.fastcomments.com). - Відкривається вікно FastComments. Увійдіть, якщо ви ще не ввійшли.
- Перегляньте сторінку згоди. Вона показує додаток Zapier, обліковий запис, до якого буде підключено, та запитувані дозволи (читання та запис). Виберіть Approve.
- Zapier зберігає підключення та позначає його назвою вашого сайту та ім'ям користувача.
З’єднання використовує OAuth. Жоден API‑ключ не копіюється в Zapier, і токен, який зберігає Zapier, працює лише для облікового запису, який ви схвалили.
Хто може підключитися
Особа, яка схвалює підключення, повинна бути API admin у обліковому записі FastComments. Власники облікових записів мають цей дозвіл; іншим членам команди його можна надати на сторінці Користувачі. Хтось без цього дозволу побачить сторінку «you do not have permission» замість форми згоди.
Підключення правильного сайту
Сторінка згоди підключає обліковий запис, у який ви зараз ввійшли. Якщо ви керуєте кількома обліковими записами, переключіться на потрібний за допомогою перемикача облікових записів перед схваленням або використайте посилання 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‑кредити, які б коштувала виклик з вашого коду: один кредит за виклик, якщо не зазначено інше.
Створити коментар
Публікує коментар на сторінці.
| Field | Required | Notes |
|---|---|---|
| Page URL ID | Yes | Ідентифікатор URL, який використовується віджетом коментарів на сторінці. Коментарі групуються за цим ідентифікатором. |
| Page URL | Yes | Повний URL сторінки, використовується у сповіщеннях електронною поштою. |
| Comment | Yes | Тіло коментаря у форматі FastComments markdown. |
| Commenter Name | Yes | Імена унікальні для кожного електронного листа, тому повторне використання імені з іншим електронним листом призводить до помилки. |
| Commenter Email | No | Користувач створюється для електронного листа, якщо він ще не існує. |
| User ID | No | Існуючий ідентифікатор SSO користувача. Має пріоритет над іменем та електронною поштою. |
| Parent Comment ID | No | Встановити, щоб опублікувати відповідь. |
| Approved, Verified | No | Обидва за замовчуванням true. Не затверджені коментарі залишаються прихованими до модерації. |
| Posted At | No | За замовчуванням — поточний час. |
| Avatar URL, Page Title, Locale | No | Locale за замовчуванням en_us. |
| Show Live In Widget | No | Відправляє коментар глядачам у реальному часі. Вартість 2 кредити замість 1. |
| Run Spam Check, Send Emails | No | Вимкнено за замовчуванням. |
Створити сторінку
Створює запис сторінки до того, як на ній з'являться коментарі, щоб її можна було перелічити та обмежити. Приймає ідентифікатор URL, назву, URL та, за бажанням, ідентифікатори груп SSO, яким дозволено її переглядати.
Створити SSO користувача
Створює користувача єдиного входу (SSO). Приймає ваш власний ідентифікатор користувача, ім'я користувача та електронну пошту, а також необов'язкові відображуване ім'я, мітку, аватар, веб‑сайт, ідентифікатори груп та прапорці сповіщень і конфіденційності. Адміністративні ролі не можна надати через Zapier.
Створити запис у стрічці
Створює запис у стрічці FastComments з HTML‑вмісту, з необов'язковою назвою, автором, тегами та попереднім переглядом одного посилання.
Створити хештег
Створює хештег, яким можуть користуватися коментатори, з необов'язковим URL, на який він посилається.
Позначити коментар
Позначає коментар для перегляду модератором. Вкажіть ідентифікатор користувача, який виконує позначення, або залиште порожнім, щоб позначити від імені інтеграції Zapier.
Пошуки
| Search | Input | Returns |
|---|---|---|
| Find Comment | Comment ID | Коментар, або нічого. |
| Find SSO User | SSO користувач, або нічого. | |
| Find Page | URL ID | Сторінка, або нічого. |
Пошук, який нічого не знаходить, не призводить до помилки Zap. Поєднайте пошук зі створенням у режимі Zapier «знайти або створити», щоб створити сторінку або користувача, якщо їх немає.
Приклади Zap'ів
Приклади Zap'ів
Кілька робочих процесів, які займають кілька хвилин для налаштування.
Отримуйте сповіщення про нові коментарі. New Comment, then Slack "Send Channel Message" or Discord "Send Channel Message". Відобразіть ім'я коментатора, текст коментаря та URL сторінки у повідомленні. Додайте фільтр домену, щоб сповіщати різний канал для кожного сайту.
Ведіть журнал кожного коментаря. New Comment, then Google Sheets "Create Spreadsheet Row". Додайте Deleted Comment як другий Zap, який додає рядок з ідентифікатором коментаря, тож лист слугує аудиторським журналом.
Надсилайте електронний лист автору, коли коментар схвалено. Updated Comment with a Zapier filter on Approved is true, then Gmail "Send Email". Оскільки Updated Comment спрацьовує при кожній зміні, фільтр забезпечує, що цей Zap реагує лише на схвалення.
Додавайте коментаторів у вашу CRM або список розсилки. New Comment, then HubSpot "Create or Update Contact" or Mailchimp "Add or Update Subscriber" using the commenter email. Дотримуйтесь вашої політики конфіденційності та місцевого законодавства перед додаванням когось до маркетингового списку.
Створюйте коментар з форми. Typeform or Google Forms "New Response", then FastComments Create Comment with the page URL ID your site uses for testimonials. Залиште Approved незакресленим, щоб переглянути кожен коментар перед його появою.
Публікуйте оголошення у стрічці. RSS by Zapier "New Item in Feed", then Create Feed Post with the item's title, content, and link.
Надавайте членам доступ як користувачам SSO. Memberstack, Memberful, or your own webhook, then Find SSO User followed by Create SSO User in "find or create" mode.
Ескалюйте повідомлені коментарі. Updated Comment, filtered on a flag count above zero, then Trello "Create Card" or Linear "Create Issue" with the comment id and a link to the moderation page.
Публікуйте сторінки, коли вони стають активними. WordPress or Ghost "New Post", then Create Page with the post URL, so the page is listed and restricted before the first comment.
Архівуйте видалені коментарі. Deleted Comment, then Airtable "Create Record" with the full comment for compliance retention.
Усунення неполадок
Усунення неполадок
"У вас немає дозволу" під час підключення. Користувач, який ввійшов, не є адміністратором API в обліковому записі.
Попросіть власника облікового запису надати API‑доступ на сторінці Користувачі, або підключіться як власник.
З’єднання позначено неправильним сайтом. Сторінка згоди підключає обліковий запис, у який ви були ввійшли в той момент. Від’єднайте в Zapier, змініть обліковий запис у панелі FastComments, і підключіться знову.
Події перестали надходити. Перевірте сторінку Webhooks у панелі. Підписка, чий кінцевий пункт постійно помилявся протягом шести днів, автоматично вимикається і показує причину. Увімкніть її знову там, або вимкніть і ввімкніть Zap ще раз. Якщо підписка повністю відсутня, хтось її видалив; вимкнення і ввімкнення Zap створює її заново.
Zapier повідомляє, що обліковий запис потрібно підключити знову. З’єднання було відкликано на сторінці Підключені додатки, користувач, який його схвалив, втратив API‑доступ, або обліковий запис був видалений. Підключіться знову через Zapier.
Дія завершується помилкою "не має прав запису". З’єднання було схвалено лише з правами лише для читання. Підключіться знову і схваліть обидва дозволи.
Обмеження швидкості та кредити. Дії та пошуки витрачають API‑кредити вашого плану і підпадають під ті ж обмеження швидкості, що й REST API. Тригери не витрачають їх. Zap, який досягає ліміту, повторно виконується Zapier після затримки, яку повідомляє FastComments.
Випадаючий список Доменів порожній. Домени з’являються після їх налаштування на сторінці Доменів у панелі FastComments. Залиште поле порожнім, щоб отримувати події для всіх доменів.