Подключите FastComments к Zapier
Приложение FastComments для Zapier соединяет ваши комментарии с тысячами других приложений без написания кода.
Используйте его, чтобы отправлять сообщение в Slack, когда кто‑то оставляет комментарий, фиксировать каждый комментарий в таблице, создавать комментарий из отправки формы или добавлять комментаторов в вашу CRM. Триггеры срабатывают в момент, когда что‑то происходит, потому что они работают на основе вебхуков, а не опроса, а действия вызывают API FastComments от вашего имени.
Это руководство предполагает, что у вас есть аккаунт FastComments. Вы можете создать его здесь.
Подключите ваш аккаунт 
Подключите свою учетную запись
- В Zapier добавьте шаг FastComments к Zap'у или откройте страницу приложения FastComments в каталоге приложений Zapier.
- Выберите Войти в FastComments. Zapier сначала запрашивает ваш регион: выберите United States, если только ваша учетная запись не была создана в регионе ЕС (
eu.fastcomments.com). - Откроется окно FastComments. Войдите, если вы ещё не вошли в систему.
- Просмотрите страницу согласия. На ней отображается приложение Zapier, учетная запись, к которой будет выполнено подключение, и запрашиваемые разрешения (чтение и запись). Выберите Одобрить.
- Zapier сохраняет подключение и помечает его именем вашего сайта и именем пользователя.
Подключение использует OAuth. API‑ключ не копируется в Zapier, и токен, хранящийся в Zapier, работает только для одобренной вами учетной записи.
Кто может подключать
Лицо, одобряющее подключение, должно быть API admin в учетной записи FastComments. Владельцы учетных записей имеют это разрешение; другим членам команды его можно предоставить на странице Users. Пользователь без этого разрешения увидит страницу «you do not have permission» вместо формы согласия.
Подключение правильного сайта
Страница согласия подключает ту учетную запись, в которой вы сейчас вошли. Если вы управляете несколькими учетными записями, переключитесь на нужную с помощью переключателя учетных записей перед одобрением или используйте ссылку 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, что и вызов из вашего собственного кода: один кредит за вызов, если не указано иначе.
Создать комментарий
Публикует комментарий на странице.
| Поле | Обязательно | Примечания |
|---|---|---|
| Идентификатор URL страницы | Да | Идентификатор URL, который использует виджет комментариев на странице. Комментарии группируются по нему. |
| URL страницы | Да | Полный URL страницы, используется в уведомительных письмах. |
| Комментарий | Да | Тело комментария в разметке FastComments. |
| Имя комментатора | Да | Имена уникальны для каждого email, поэтому повторное использование имени с другим email приводит к ошибке. |
| Email комментатора | Нет | Пользователь создаётся для данного email, если он ещё не существует. |
| ID пользователя | Нет | Существующий SSO ID пользователя. Имеет приоритет над именем и email. |
| ID родительского комментария | Нет | Установите, чтобы опубликовать ответ. |
| Одобрено, Проверено | Нет | По умолчанию оба значения true. Неодобренные комментарии остаются скрытыми до модерации. |
| Дата публикации | Нет | По умолчанию — текущий момент. |
| URL аватара, Заголовок страницы, Локаль | Нет | Локаль по умолчанию en_us. |
| Показать в реальном времени в виджете | Нет | Отправляет комментарий зрителям в реальном времени. Стоит 2 кредита вместо 1. |
| Запуск проверки спама, Отправка писем | Нет | По умолчанию отключено. |
Создать страницу
Создаёт запись страницы до появления на ней комментариев, чтобы её можно было перечислять и ограничивать. Принимает идентификатор URL, заголовок, URL и, при желании, идентификаторы групп SSO, которым разрешён доступ.
Создать SSO‑пользователя
Создаёт пользователя единого входа (SSO). Принимает ваш собственный ID пользователя, имя пользователя и email, а также необязательные отображаемое имя, метку, аватар, веб‑сайт, идентификаторы групп и флаги уведомлений и конфиденциальности. Административные роли нельзя предоставить через Zapier.
Создать запись в ленте
Создаёт запись в ленте FastComments из HTML‑контента, с необязательным заголовком, автором, тегами и одним предварительным просмотром ссылки.
Создать хеш‑тег
Создаёт хеш‑тег, который комментаторы могут использовать, с необязательным URL, на который он ссылается.
Пометить комментарий
Помечает комментарий для проверки модератором. Укажите ID пользователя, который ставит пометку, или оставьте пустым, чтобы пометить от имени интеграции Zapier.
Поиски
| Поиск | Ввод | Возвращает |
|---|---|---|
| Найти комментарий | ID комментария | Комментарий или ничего. |
| Найти SSO‑пользователя | Пользователь SSO или ничего. | |
| Найти страницу | ID URL | Страница или ничего. |
Поиск, который ничего не находит, не приводит к ошибке Zap. Сочетайте поиск с созданием в режиме «найти или создать» Zapier, чтобы создать страницу или пользователя, если их нет.
Примеры Zaps
Примеры Zaps
Несколько рабочих процессов, которые настраиваются за считанные минуты.
Получать уведомления о новых комментариях. 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 с фильтром Zapier, где Approved = 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 на странице 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. Оставьте поле пустым, чтобы получать события для всех доменов.