Свържете FastComments с Zapier
FastComments приложението за Zapier свързва вашите коментари с хиляди други приложения без писане на код.
Използвайте го, за да публикувате съобщение в Slack, когато някой коментира, записвате всеки коментар в електронна таблица, създавате коментар от подаване на форма или добавяте коментаторите към вашата CRM. Тригърите се задействат в момента, в който нещо се случи, защото са базирани на уебхукове, а не на полинг, а действията извикват FastComments API от ваше име.
Това ръководство предполага, че имате FastComments акаунт. Можете да създадете такъв тук.
Това ръководство обхваща използването на Zapier приложението. Крайните точки, които извиква, заедно с формати за заявки и отговори и OAuth потока зад връзката, са документирани в API справка.
Свържете вашия акаунт 
Свържете акаунта си
- В Zapier добавете стъпка FastComments към Zap или отворете страницата на приложението FastComments в Zapier App Directory.
- Изберете Sign in to FastComments. Zapier първо пита за вашия регион: изберете United States, освен ако акаунтът ви не е създаден в EU региона (
eu.fastcomments.com). - Отваря се прозорец на FastComments. Влезте, ако все още не сте влезли.
- Прегледайте страницата за съгласие. Тя показва приложението Zapier, акаунта, към който ще бъде свързано, и исканите разрешения (четене и запис). Изберете Approve.
- Zapier съхранява връзката и я етикетира с името на сайта и потребителското ви име.
Връзката използва OAuth. Няма копиран API ключ в Zapier, а токенът, който Zapier притежава, работи само за акаунта, който сте одобрили.
Кой може да свърже
Лицето, одобряващо връзката, трябва да бъде API admin в акаунта на FastComments. Собствениците на акаунти имат това разрешение; на други членове на екипа може да бъде предоставено от страницата Users. Някой без това разрешение вижда страница „нямате разрешение" вместо формата за съгласие.
Свързване на правилния сайт
Страницата за съгласие свързва акаунта, в който сте влезли в момента. Ако управлявате няколко акаунта, превключете към правилния от превключвателя на акаунти, преди да одобрите, или използвайте линка switch account на страницата за съгласие. Етикетът на връзката в Zapier показва името на сайта, така че грешният избор лесно се забелязва.
Преглед и отмяна на достъпа
Всяка връзка се показва под Connected Apps в дашборда на FastComments, с разрешенията, които притежава, и кога е използвана за последно. Отмяната ѝ там веднага прекъсва Zapier; всеки Zap, използващ тази връзка, спира, докато не бъде свързан отново. Можете също да премахнете връзката от страната на Zapier под My Apps.
Тригери
Тригери
Тригери стартират Zap, когато се случи нещо във FastComments. Всички три са незабавни: FastComments доставя събитието до Zapier чрез webhook в момента, в който се случи. Нищо не проверява вашия акаунт и не се харчат API кредити, докато се чака.
| Тригер | Стартира, когато |
|---|---|
| Нов коментар | Коментар е публикуван. По подразбиране се задействат само одобрени, не‑спам коментари. |
| Обновен коментар | Коментар е редактиран, одобрен, гласуван, закачен, заключен или по друг начин променен. |
| Изтрит коментар | Коментар е изтрит. |
Всеки тригер връща пълния коментар: id, URL на страницата и URL ID, име и имейл на коментатора, текстът на коментара като markdown и като HTML, брой гласове, флагове за одобрение и спам, локалът, домейнът и всички споменавания. Полетата съвпадат с payload‑а на webhook, документиран в раздел Webhooks, Data Structures.
Опции
Домейн. Всеки тригер има незадължителен филтър за домейн, изброяващ домейните, конфигурирани във вашия акаунт. Оставете го празен, за да получавате събития от всеки домейн.
Включване на неодобрени и спам коментари. Само за тригера Нов коментар. Коментари, задържани за модерация или маркирани като спам, се пропускат по подразбиране. Когато такъв коментар бъде одобрен по‑късно, тригерът Обновен коментар се задейства за него, така че Zap, който трябва да реагира на всеки коментар, който стане видим, използва Обновен коментар с филтър върху полето approved.
Как работи доставката
Активирането на Zap създава абонамент за webhook във вашия акаунт, видим на страницата Webhooks с източник API. Деактивирането на Zap премахва абонамента. Ограниченията на Zapier се прилагат за броя събития, които приема в минута; FastComments опитва отново доставката, която е неуспешна, с нарастваща забавка, и деактивира абонамент, който продължава да се проваля шест дни. Деактивиран абонамент може да бъде повторно активиран от страницата Webhooks, или просто изключете и включете Zap отново, за да създадете нов.
Един акаунт може да съдържа до 50 API абонамента. Всеки Zap, използващ тригер от FastComments, използва един.
Действия и търсения
Действия и Търсения
Действията създават данни във FastComments; търсенията извличат данни, за да може следваща стъпка да ги използва. Всяко действие извиква FastComments REST API и изразходва същите API кредити, които би струвало извикването от вашия собствен код: един кредит за извикване, освен ако не е посочено друго.
Създаване на Коментар
Публикува коментар на страница.
| Поле | Задължително | Бележки |
|---|---|---|
| ID на URL на страницата | Да | ID‑то на URL, което уиджетът за коментари използва на страницата. Коментарите се групират по него. |
| URL на страницата | Да | Пълният URL на страницата, използван в имейл известия. |
| Коментар | Да | Тялото на коментара във FastComments markdown. |
| Име на коментатора | Да | Имената са уникални за всеки имейл, затова повторното използване на име с различен имейл не успява. |
| Имейл на коментатора | Не | Потребител се създава за имейла, ако все още не съществува. |
| ID на потребител | Не | Съществуващо SSO ID на потребител. Има предимство пред името и имейла. |
| ID на родителски коментар | Не | Задайте, за да публикувате отговор. |
| Одобрен, Потвърден | Не | И двете по подразбиране са true. Неодобрените коментари остават скрити, докато не бъдат модерирани. |
| Публикувано на | Не | По подразбиране е текущото време. |
| URL на аватар, Заглавие на страницата, Локал | Не | Локалът по подразбиране е en_us. |
| Показване на живо в уиджет | Не | Изпраща коментара към зрителите в реално време. Стои 2 кредита вместо 1. |
| Проверка за спам, Изпращане на имейли | Не | По подразбиране изключено. |
Създаване или Обновяване на Страница
Създава запис за страница преди да има коментари върху нея, за да може да бъде изброена и ограничена. Приема URL ID, заглавие, URL и по избор SSO групови ID‑та, които имат достъп до нея. Ако страница с това URL ID вече съществува, тя се обновява с предоставените полета, така че Zap‑ът може да се изпълнява многократно за същата страница.
Създаване или Обновяване на SSO Потребител
Създава потребител за единично влизане (single sign-on). Приема ваш собствен потребителски ID, потребителско име и имейл, плюс по избор име за показване, етикет за показване, аватар, уебсайт, групови ID‑та и флагове за известия и поверителност. Ако потребител с този ID вече съществува, той се обновява вместо това. Административни роли не могат да се предоставят от Zapier.
Създаване на Публикация във Фийд
Създава публикация във FastComments фийд от HTML съдържание. ID‑то на автора е задължително (FastComments или SSO потребителско ID); заглавието, етикетите и едно предварително преглеждане на връзка са по избор.
Създаване или Обновяване на Хаш Таг
Създава хаш таг, който коментаторите могат да използват, с по избор URL, към който води. Ако тагът вече съществува, той се обновява вместо това.
Маркиране на Коментар
Маркира коментар за преглед от модератор. ID‑то на потребителя, който маркира, е задължително; ID‑то на автора, върнато от Създаване на Коментар, работи.
Търсения
| Търсене | Вход | Връща |
|---|---|---|
| Намери Коментар | ID на Коментар | Коментарът, или нищо. |
| Намери SSO Потребител | Имейл | SSO потребителят, или нищо. |
| Намери Страница | URL ID | Страницата, или нищо. |
Търсене, което не намери нищо, не проваля Zap‑а. Намери SSO Потребител и Намери Страница предлагат опцията на 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 е истина, then Gmail "Send Email". Тъй като Updated Comment се задейства при всяка промяна, филтърът е това, което кара този Zap да реагира само на одобрения.
Добавете коментаторите към вашата CRM или имейл листа. New Comment, then HubSpot "Create or Update Contact" or Mailchimp "Add or Update Subscriber", използвайки имейла на коментатора. Спазвайте вашата политика за поверителност и местното законодателство, преди да добавяте някого към маркетинг листа.
Създайте коментар от форма. Typeform or Google Forms "New Response", then FastComments Create Comment с ID‑то на URL‑то на страницата, което вашият сайт използва за отзиви. Оставете Approved без отметка, за да преглеждате всеки коментар преди да се публикува.
Публикувайте обявления във фийд. RSS by Zapier "New Item in Feed", then Create Feed Post с заглавието, съдържанието и връзката на елемента.
Осигурете членове като 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" с идентификатора на коментара и връзка към страницата за модериране.
Публикувайте страници, когато станат активни. WordPress or Ghost "New Post", then Create Page с URL‑то на публикацията, така че страницата да бъде листната и ограничена преди първия коментар.
Архивирайте изтритите коментари. Deleted Comment, then Airtable "Create Record" с пълния коментар за съхранение съгласно изискванията за запазване.
Отстраняване на проблеми
Отстраняване на неизправности
„Нямате разрешение" при свързване. Влезлият потребител не е API администратор на акаунта. Поискайте от собственика на акаунта да предостави API разрешение на страницата Users, или се свържете като собственик.
Връзката е етикетирана с грешен сайт. Страницата за съгласие свързва акаунта, в който сте били влезли по това време. Прекъснете връзката в Zapier, превключете акаунти в таблото на FastComments и се свържете отново.
Събитията спряха да пристигат. Проверете страницата Webhooks в таблото. Абонамент, чиято крайна точка е продължила да се проваля шест дни, се деактивира автоматично и показва причината. Активирайте го отново там, или изключете и включете Zap-а. Ако абонаментът липсва напълно, някой го е изтрил; изключването и включването на Zap-а го пресъздава.
Zapier казва, че акаунтът трябва да бъде свързан отново. Връзката е била отнета от страницата Connected Apps, потребителят, който я е одобрил, е загубил API разрешението, или акаунтът е бил изтрит. Свържете отново от Zapier.
Действие се проваля с „няма права за запис". Връзката е била одобрена с разрешение само за четене. Свържете отново и одобрете двете разрешения.
Лимити и кредити. Действията и търсенията харчат API кредити от вашия план и подлежат на същите лимити като REST API. Тригерите не харчат нищо. Zap, който срещне лимит, се опитва отново от Zapier след забавянето, което FastComments съобщава.
Падащият списък Domain е празен. Домейните се появяват, след като бъдат конфигурирани на страницата Domains в таблото на FastComments. Оставете полето празно, за да получавате събития за всеки домейн.