Подключите FastComments к Zapier
Приложение FastComments для Zapier соединяет ваши комментарии с тысячами других приложений без написания кода.
Используйте его, чтобы отправлять сообщение в Slack, когда кто‑то комментирует, фиксировать каждый комментарий в таблице, создавать
комментарий из отправки формы или добавлять комментаторов в вашу CRM. Триггеры срабатывают в момент, когда происходит событие,
поскольку они работают на основе веб‑хуков, а не опроса, а действия вызывают API FastComments от вашего
имени.
В этом руководстве предполагается, что у вас есть аккаунт 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-администратором аккаунта FastComments. Владельцы аккаунта обладают этим разрешением; другие участники команды могут получить его на странице Users. Пользователь без этого разрешения увидит страницу «у вас нет прав доступа» вместо формы согласия.
Подключение нужного сайта
Страница согласия подключает аккаунт, в который вы сейчас вошли. Если вы управляете несколькими аккаунтами, переключитесь на нужный через переключатель аккаунтов перед одобрением или воспользуйтесь ссылкой switch account на странице согласия. Название подключения в Zapier отображает имя сайта, поэтому неправильный выбор легко заметить.
Просмотр и отзыв доступа
Каждое подключение отображается в разделе Connected Apps в панели управления FastComments с указанием его разрешений и времени последнего использования. Отзыв доступа там немедленно отключает Zapier; любой Zap, использующий это подключение, остановится до повторного подключения. Вы также можете удалить подключение со стороны Zapier в разделе My Apps.
Триггеры
Триггеры
Триггеры запускают Zap, когда в FastComments происходит событие. Все три работают мгновенно: FastComments доставляет событие в Zapier через вебхук в момент его возникновения. Никакие запросы к вашему аккаунту не выполняются, и не тратятся кредиты API в ожидании.
| Триггер | Срабатывает когда |
|---|---|
| New Comment | Комментарий опубликован. По умолчанию срабатывают только одобренные, не являющиеся спамом комментарии. |
| Updated Comment | Комментарий отредактирован, одобрен, проголосован, закреплён, заблокирован или иным образом изменён. |
| Deleted Comment | Комментарий удалён. |
Параметры
Domain. Каждый триггер имеет необязательный фильтр домена, перечисляющий домены, настроенные в вашем аккаунте. Оставьте пустым, чтобы получать события со всех доменов.
Include Unapproved and Spam Comments. Только для триггера New Comment. Комментарии, находящиеся в модерации или помеченные как спам, по умолчанию пропускаются. Когда такой комментарий позже одобряется, срабатывает триггер Updated Comment, поэтому Zap, который должен реагировать на каждый комментарий, ставший видимым, использует Updated Comment с фильтром по полю approved.
Как работает доставка
Включение Zap создаёт подписку на вебхук в вашем аккаунте, видимую на странице Webhooks с источником API. Отключение Zap удаляет её. На количество событий, принимаемых 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. |
| Commenter Name | Yes | Имена уникальны для каждого email, поэтому повторное использование имени с другим 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 | Отключено по умолчанию. |
Создать или обновить страницу
Создаёт запись страницы до появления на ней комментариев, чтобы её можно было отображать и ограничивать. Принимает URL‑идентификатор, заголовок, URL и, при желании, идентификаторы групп SSO, которым разрешён доступ. Если страница с этим URL‑идентификатором уже существует, она обновляется указанными полями, поэтому Zap может многократно запускаться для одной и той же страницы.
Создать или обновить SSO‑пользователя
Создаёт пользователя единого входа (SSO). Принимает ваш собственный идентификатор пользователя, имя пользователя и email, а также необязательные отображаемое имя, метку, аватар, веб‑сайт, идентификаторы групп и флаги уведомлений и конфиденциальности. Если пользователь с таким идентификатором уже существует, он обновляется. Административные роли нельзя назначать через Zapier.
Создать запись в ленте
Создаёт запись в ленте FastComments из HTML‑контента. Требуется идентификатор пользователя‑автора (идентификатор FastComments или SSO); заголовок, теги и один предварительный просмотр ссылки являются необязательными.
Создать или обновить хеш‑тег
Создаёт хеш‑тег, который могут использовать комментаторы, с необязательным URL, на который он ссылается. Если такой тег уже существует, он обновляется.
Пометить комментарий
Помечает комментарий для проверки модератором. Требуется идентификатор пользователя, который ставит пометку; подходит идентификатор автора, возвращённый при создании комментария.
Поиски
| Search | Input | Returns |
|---|---|---|
| Find Comment | Comment ID | Комментарий, либо ничего. |
| Find SSO User | SSO‑пользователь, либо ничего. | |
| Find Page | URL ID | Страница, либо ничего. |
Поиск, который ничего не находит, не приводит к ошибке Zap. Find SSO User и Find Page предлагают опцию Zapier «создать, если не существует», которая запускает соответствующее создание, когда ничего не найдено.
Примеры Zaps
Примеры Zaps
Несколько сценариев, настройка которых занимает считанные минуты.
Получайте уведомления о новых комментариях. 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 на странице Users, или подключитесь как владелец.
Подключение помечено неверным сайтом. Страница согласия подключает тот аккаунт, в который вы были вошли
в тот момент. Отключите в Zapier, переключите аккаунты в панели FastComments и подключитесь снова.
События перестали приходить. Проверьте страницу Webhooks в панели. Подписка, чей endpoint не работал шесть дней, автоматически отключается и показывает причину. Включите её снова там, или выключите и включите Zap заново.
Если подписка полностью отсутствует, кто‑то её удалил; выключение и включение Zap создаст её заново.
Zapier сообщает, что аккаунт нужно переподключить. Соединение было отозвано на странице Connected Apps, пользователь, который его одобрил, потерял разрешение API, или аккаунт был удалён. Переподключите из Zapier.
Действие завершается ошибкой "does not have write access". Соединение было одобрено только с правами чтения. Переподключите и одобрите оба разрешения.
Ограничения скорости и кредиты. Действия и поиски расходуют API‑кредиты вашего плана и подпадают под те же ограничения скорости, что и REST API. Триггеры не расходуют кредиты. Zap, достигший лимита, будет повторно выполнен Zapier после задержки, о которой сообщает FastComments.
Выпадающий список доменов пуст. Доменов появляется после их настройки на странице Domains в панели FastComments. Оставьте поле пустым, чтобы получать события для всех доменов.