Свържете FastComments с Zapier
Приложението FastComments за Zapier свързва вашите коментари с хиляди други приложения без писане на код.
Използвайте го, за да публикувате съобщение в Slack, когато някой коментира, записвате всеки коментар в електронна таблица, създавате коментар от изпращане на форма или добавяте коментатори към вашата CRM. Тригърите се задействат в момента, в който нещо се случи, тъй като са базирани на уебхукове, а не на полинг, а действията извикват FastComments API от ваше име.
Това ръководство предполага, че имате FastComments акаунт. Можете да създадете такъв тук.
Свържете вашия акаунт 
Свържете вашия акаунт
- В Zapier добавете стъпка FastComments към Zap, или отворете страницата на приложението FastComments в директорията на приложенията на Zapier.
- Изберете Sign in to FastComments. Zapier първо ви пита за вашия регион: изберете United States, освен ако вашият акаунт не е създаден в EU региона (
eu.fastcomments.com). - Отваря се прозорец на FastComments. Влезте, ако все още не сте влезли.
- Прегледайте страницата за съгласие. Тя показва приложението Zapier, акаунта, към който ще бъде свързано, и заявените разрешения (четене и писане). Изберете Approve.
- 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 чрез 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 кредити, които би струвало извикването от вашия собствен код: един кредит за извикване, освен ако не е посочено друго.
Създаване на Коментар
Публикува коментар на страница.
| Поле | Задължително | Бележки |
|---|---|---|
| Page URL ID | Да | URL идентификаторът, който уиджетът за коментари използва на страницата. Коментарите се групират по него. |
| Page URL | Да | Пълният URL на страницата, използван в имейл известия. |
| Comment | Да | Тялото на коментара във FastComments markdown. |
| Commenter Name | Да | Имената са уникални за всеки имейл, затова повторното използване на име с различен имейл се проваля. |
| Commenter Email | Не | Потребител се създава за имейла, ако все още не съществува. |
| User ID | Не | Съществуващ SSO потребителски идентификатор. Има предимство пред името и имейла. |
| Parent Comment ID | Не | Задайте, за да публикувате отговор. |
| Approved, Verified | Не | И двете по подразбиране са true. Неодобрени коментари остават скрити, докато не бъдат модерирани. |
| Posted At | Не | По подразбиране е текущото време. |
| Avatar URL, Page Title, Locale | Не | Локалът по подразбиране е en_us. |
| Show Live In Widget | Не | Изпраща коментара към зрителите в реално време. Стои 2 кредита вместо 1. |
| Run Spam Check, Send Emails | Не | Изключено по подразбиране. |
Създаване на Страница
Създава запис за страница преди да има коментари върху нея, за да може да бъде изброена и ограничена. Приема URL ID, заглавие, URL и по избор SSO групови идентификатори, които имат достъп до нея.
Създаване на SSO Потребител
Създава потребител за единично влизане (single sign-on). Приема ваш собствен потребителски идентификатор, потребителско име и имейл, плюс по избор име за показване, етикет за показване, аватар, уебсайт, групови идентификатори и флагове за известия и поверителност. Административни роли не могат да бъдат предоставени от Zapier.
Създаване на Feed Публикация
Създава публикация във FastComments feed от HTML съдържание, с по избор заглавие, автор, тагове и един преглед на връзка.
Създаване на Хаш Таг
Създава хаш таг, който коментаторите могат да използват, с по избор URL, към който води.
Маркиране на Коментар
Маркира коментар за преглед от модератор. Предоставете идентификатора на потребителя, който маркира, или оставете празно, за да маркирате като Zapier интеграцията.
Търсения
| Търсене | Вход | Връща |
|---|---|---|
| Find Comment | Comment ID | Коментарът, или нищо. |
| Find SSO User | SSO потребителят, или нищо. | |
| Find Page | URL ID | Страницата, или нищо. |
Търсене, което не намира нищо, не проваля Zap. Комбинирайте търсене със създаване в режим „find or create“ на 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" с пълния коментар за съхранение съгласно изискванията за запазване.
Отстраняване на проблеми
Отстраняване на проблеми
"You do not have permission" при свързване. Вписаният потребител не е API администратор в акаунта.
Помолете собственика на акаунта да предостави API разрешение на страницата Потребители, или се свържете като собственик.
Връзката е етикетирана с грешен сайт. Страницата за съгласие свързва акаунта, в който сте били вписани
по това време. Прекъснете връзката в Zapier, сменете акаунтите в таблото на FastComments и се свържете отново.
Събитията спряха да пристигат. Проверете страницата Webhooks в таблото. Абонамент, чийто крайна точка продължи
да се проваля шест дни, се изключва автоматично и показва причината. Включете го отново там, или изключете и включете Zap отново
отново. Ако абонаментът липсва изцяло, някой го е изтрил; изключването и включването на Zap го създава отново.
Zapier казва, че акаунтът трябва да бъде свързан отново. Връзката беше оттеглена от страницата Свързани приложения
, потребителят, който я одобри, загуби API разрешението, или акаунтът беше изтрит. Свържете отново от Zapier.
Действие се проваля с "does not have write access". Връзката беше одобрена с read-only
permission. Свържете отново и одобрете и двете разрешения.
Ограничения на скоростта и кредити. Действията и търсенията използват API кредити от вашия план и са подложени на
същите ограничения на скоростта като REST API. Тригери не използват кредити. Zap, който достигне лимит, се опитва отново от Zapier
след закъснението, което FastComments съобщава.
Падащото меню Domain е празно. Домейните се появяват, след като бъдат конфигурирани на страницата Domains в
таблото на FastComments. Оставете полето празно, за да получавате събития за всеки домейн.