Підключіть FastComments до Zapier
The FastComments app for Zapier підключає ваші коментарі до тисяч інших додатків без написання коду.
Використовуйте його, щоб надсилати повідомлення в Slack, коли хтось коментує, записувати кожен коментар у електронну таблицю, створювати коментар з надсилання форми або додавати коментаторів у вашу CRM. Тригери спрацьовують у момент, коли щось відбувається, оскільки вони працюють на основі вебхук, а не опитування, а дії викликають FastComments API від вашого імені.
Цей посібник передбачає, що у вас є обліковий запис FastComments. Ви можете створити його тут.
Цей посібник охоплює використання додатку Zapier. Концеві точки, які він викликає, разом із форматами запитів і відповідей та процесом OAuth, що стоїть за з’єднанням, задокументовані в довіднику API.
Підключіть свій обліковий запис 
Підключіть свій обліковий запис
- У 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, використовує одну.
Дії та пошуки
Actions and Searches
Дії створюють дані у FastComments; пошуки шукають дані, щоб пізніший крок міг їх використати. Кожна дія викликає REST API FastComments і витрачає ті ж API‑кредити, які б коштували виклик у вашому коді: один кредит за виклик, якщо не зазначено інше.
Create Comment
Posts a comment on a page.
| Field | Required | Notes |
|---|---|---|
| Page URL ID | Yes | Ідентифікатор URL, який використовується віджетом коментарів на сторінці. Коментарі групуються за цим ідентифікатором. |
| Page URL | Yes | Повний URL сторінки, використовується у сповіщеннях електронною поштою. |
| Comment | Yes | Тіло коментаря у форматі FastComments markdown. |
| Commenter Name | Yes | Імена унікальні для кожного електронного листа, тому повторне використання імені з іншим email не вдається. |
| Commenter Email | No | Користувач створюється для цього email, якщо він ще не існує. |
| User ID | No | Існуючий ідентифікатор SSO‑користувача. Має пріоритет над ім'ям та email. |
| Parent Comment ID | No | Встановіть, щоб опублікувати відповідь. |
| Approved, Verified | No | Обидва за замовчуванням true. Не затверджені коментарі залишаються прихованими до модерації. |
| Posted At | No | За замовчуванням — поточний час. |
| Avatar URL, Page Title, Locale | No | Локаль за замовчуванням en_us. |
| Show Live In Widget | No | Надсилає коментар глядачам у реальному часі. Вартує 2 кредити замість 1. |
| Run Spam Check, Send Emails | No | Вимкнено за замовчуванням. |
Create or Update Page
Створює запис сторінки до появи будь‑якого коментаря, щоб її можна було відображати у списках та обмежувати доступ. Приймає ідентифікатор URL, назву, URL та, за потреби, ідентифікатори SSO‑груп, яким дозволено її переглядати. Якщо сторінка з таким ідентифікатором URL вже існує, вона оновлюється переданими полями, тому Zap може виконуватись для однієї й тієї ж сторінки кілька разів.
Create or Update SSO User
Створює користувача єдиного входу (SSO). Приймає ваш власний ідентифікатор користувача, ім'я користувача та email, а також необов’язкові відображуване ім'я, мітку, аватар, веб‑сайт, ідентифікатори груп та прапорці сповіщень і конфіденційності. Якщо користувач з таким ідентифікатором вже існує, він оновлюється. Адміністративні ролі не можна надати через Zapier.
Create Feed Post
Створює запис у стрічці FastComments з HTML‑вмісту. Ідентифікатор користувача‑автора обов’язковий (ідентифікатор FastComments або SSO); назва, теги та один попередній перегляд посилання — необов’язкові.
Create or Update Hash Tag
Створює хештег, яким можуть користуватися коментатори, з необов’язковим URL, на який він посилається. Якщо хештег вже існує, він оновлюється.
Flag Comment
Позначає коментар для перегляду модератором. Потрібен ідентифікатор користувача, який ставить прапорець; підходить ідентифікатор автора, який повертається у Create Comment.
Searches
| Search | Input | Returns |
|---|---|---|
| Find Comment | Comment ID | Коментар або нічого. |
| Find SSO User | SSO‑користувач або нічого. | |
| Find Page | URL ID | Сторінка або нічого. |
Пошук, який нічого не знаходить, не призводить до помилки Zap. Find SSO User та Find Page пропонують опцію 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. Залиште поле порожнім, щоб отримувати події для всіх доменів.