Povežite FastComments sa Zapier-om
FastComments апликација за Zapier повезује ваше коментаре са хиљадама других апликација без писања кода.
Користите је да пошаљете Slack поруку када неко коментарише, забележите сваки коментар у табелу, креирате коментар из подношења форме, или додате коментаторе у ваш CRM. Окидачи се активирају у тренутку када се нешто деси, јер су засновани на вебхук-овима уместо на поллингу, а акције позивају FastComments API у ваше име.
Овај водич претпоставља да имате FastComments налог. Можете га креирати овде.
Povežite svoj nalog 
Повежите ваш налог
- У Zapier-у, додајте FastComments корак у Zap, или отворите страницу FastComments апликације у Zapier App Directory.
- Изаберите Пријавите се у FastComments. Zapier прво тражи ваш регион: изаберите United States осим ако је ваш налог креиран у EU региону (
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.
Okidači
Окидачи
Окидачи покрећу Zap када се нешто деси у FastComments. Сва три су тренутна: FastComments испоручује догађај Zapier‑у преко вебхука у тренутку када се деси. Ништа не испитује ваш налог и не троше се API кредити док се чека.
| Окидач | Окида се када |
|---|---|
| Нови коментар | Коментар је објављен. Подразумевано само одобрени, не‑спам коментари окидају. |
| Ажурирани коментар | Коментар је уређен, одобрен, гласао, закачен, закључан или на неки други начин измењен. |
| Обрисани коментар | Коментар је обрисан. |
Сваки окидач враћа цео коментар: id, URL странице и URL ID, име и имејл коментатора, текст коментара као markdown и као HTML, број гласа, ознаке за одобрење и спам, локал, домен и све помиње. Поља се подударају са payload‑ом вебхука документованим у одељку Webhooks, Data Structures.
Опције
Домен. Сваки окидач има опциони филтер домена, који наводи домене подешене на вашем налогу. Оставите празно да бисте примали догађаје са свих домена.
Укључи неодобрени и спам коментаре. Само на окидачу Нови коментар. Коментари који су задржани за модерацију или означени као спам се подразумевано прескачу. Када се такав коментар касније одобри, окидач Ажурирани коментар се покреће за њега, па Zap који треба да реагује на сваки коментар који постане видљив користи Ажурирани коментар са филтером на пољу одобрено.
Како функционише испорука
Укључивање Zap‑а креира претплату на вебхук на вашем налогу, видљиву на страници Webhooks са извором API. Искључивање Zap‑а уклања претплату. Ограничења Zapier‑а се примењују на број догађаја које прихвата по минуту; FastComments поново покушава испоруку која не успе, са растућим кашњењем, и онемогућава претплату која не успева шест дана. Онемогућену претплату можете поново омогућити са странице Webhooks, или једноставно искључити и поново укључити Zap да бисте креирали нову.
Налог може имати до 50 API претплата. Сваки Zap који користи FastComments окидач користи једну.
Akcije i pretrage
Радње и Претраге
Радње креирају податке у FastComments; претраге траже податке тако да их каснији корак може користити. Свака радња позива FastComments REST API и троши исте API кредите колико би позив коштао из вашег кода: један кредит по позиву осим ако је наведено другачије.
Креирање Коментара
Објављује коментар на страници.
| Поље | Обавезно | Белешке |
|---|---|---|
| ID URL-а странице | Да | ID URL-а који користи widget за коментаре на страници. Коментари се групишу према њему. |
| URL странице | Да | Пуни URL странице, користи се у обавештајним имејловима. |
| Коментар | Да | Тело коментара у FastComments markdown-у. |
| Име коментатора | Да | Имена су јединствена по имејлу, па поновно коришћење имена са другим имејлом не успева. |
| Имејл коментатора | Не | Корисник се креира за имејл ако још не постоји. |
| ID корисника | Не | Постојећи SSO ID корисника. Има предност над именом и имејлом. |
| ID родитељског коментара | Не | Подесите за објављивање одговора. |
| Одобрено, Верификовано | Не | Оба подразумевано су true. Неодобрени коментари остају скривени док се не модерирају. |
| Објављено у | Не | Подразумевано је тренутно време. |
| URL аватара, Наслов странице, Локал | Не | Локал подразумевано је en_us. |
| Прикажи уживо у widget-у | Не | Гурка коментар гледаоцима у реалном времену. Коштује 2 кредита уместо 1. |
| Покрени проверу спама, Пошаљи имејлове | Не | Подразумевано искључено. |
Креирање Странице
Креира запис странице пре него што постоји било какав коментар на њој, тако да може бити листана и ограничена. Потребни су ID URL-а, наслов, URL, и по избору SSO ID група којима је дозвољено да виде страницу.
Креирање SSO Корисника
Креира корисника за једнократну пријаву (single sign-on). Потребни су ваш сопствени ID корисника, корисничко име и имејл, као и по избору име за приказ, ознака за приказ, аватар, вебсајт, ID група, и заставице за обавештења и приватност. Административне улоге не могу бити додељене из Zapier-а.
Креирање Поставке у Фиду
Креира поставку у FastComments фиду из HTML садржаја, са по избору насловом, аутором, ознакама и једним прегледом линка.
Креирање Хеш Тагова
Креира хеш таг који коментатори могу користити, са по избору URL-ом на који води.
Означавање Коментара
Означава коментар за преглед модератора. Наведите ID корисника који означава, или оставите празно да означите као Zapier интеграција.
Претраге
| Претрага | Улаз | Враћа |
|---|---|---|
| Пронађи коментар | ID коментара | Коментар, или ништа. |
| Пронађи SSO корисника | Имејл | SSO корисник, или ништа. |
| Пронађи страницу | ID URL-а | Страница, или ништа. |
Претрага која не пронађе ништа не доводи до грешке у Zap-у. Комбинујте претрагу са креирањем у режиму "нађи или креирај" у Zapier-у да бисте креирали страницу или корисника када недостаје.
Primeri Zapova
Примери Zap-ова
Неки радни токови који се постављају за пар минута.
Будите обавештени о новим коментарима. Нови коментар, затим Slack „Send Channel Message“ или Discord „Send Channel Message“. Мапирајте име коментатора, текст коментара и URL странице у поруку. Додајте филтер домена да обавестите различит канал по сајту.
Водите евиденцију сваког коментара. Нови коментар, затим Google Sheets „Create Spreadsheet Row“. Додајте „Deleted Comment“ као други Zap који додаје ред са ID-ом коментара, тако да лист служи и као ревизорски запис.
Пошаљите имејл аутору када се коментар одобри. Ажурирани коментар са Zapier филтером где је Approved истинито, затим Gmail „Send Email“. Пошто се Ажурирани коментар покреће при свакој измени, филтер је оно што овај Zap чини реактивним само на одобрења.
Додајте коментаторе у ваш CRM или листу за слање мејлова. Нови коментар, затим HubSpot „Create or Update Contact“ или Mailchimp „Add or Update Subscriber“ користећи имејл коментатора. Поштујте вашу политику приватности и локалне законе пре него што некога додате у маркетиншку листу.
Креирајте коментар из форме. Typeform или Google Forms „New Response“, затим FastComments Create Comment са ID-ом URL-а странице коју ваш сајт користи за тестимонијале. Оставите „Approved“ непроверено да бисте прегледали сваки коментар пре него што се појави.
Објавите обавештења у фид. RSS од Zapier „New Item in Feed“, затим Create Feed Post са насловом, садржајем и линком ставке.
Обезбедите чланове као SSO кориснике. Memberstack, Memberful или ваш сопствени вебхук, затим Find SSO User, а потом Create SSO User у режиму „find or create“.
Ескалирајте пријављене коментаре. Ажурирани коментар, филтриран на број заставица изнад нуле, затим Trello „Create Card“ или Linear „Create Issue“ са ID-ом коментара и линком ка страници за модерацију.
Објавите странице када постану живе. WordPress или Ghost „New Post“, затим Create Page са URL-ом поста, тако да је страница листана и ограничена пре првог коментара.
Архивирајте обрисане коментаре. Обрисани коментар, затим Airtable „Create Record“ са целим коментаром за задржавање у складу са регулативом.
Rešavanje problema
Troubleshooting
"Немате дозволу" при повезивању. Пријављени корисник није API администратор на налогу.
Замолите власника налога да одобри API дозволу на страници Корисници, или се повежите као власник.
Веза је означена погрешним сајтом. Страница за сагласност повезује налог у који сте били пријављени у том тренутку. Прекините везу у Zapier-у, промените налог у FastComments контролној табли, и поново се повежите.
Догађаји су престали да стижу. Проверите страницу Webhooks у контролној табли. Претплата чији је крајњи тачка (endpoint) неуспела шест дана аутоматски се онемогућава и приказује разлог. Поново је омогућите тамо, или искључите и поново укључите Zap. Ако претплата уопште недостаје, неко је избрисао; искључивање и поновно укључивање Zap-а ће је поново креирати.
Zapier каже да је потребно поново повезати налог. Веза је повучена са странице Повезане апликације, корисник који је одобрио везу је изгубио API дозволу, или је налог обрисан. Поново повежите из Zapier-а.
Радња не успева са поруком "нема приступ за писање". Веза је одобрена са дозволом само за читање. Поново повежите и одобрите обе дозволе.
Ограничења брзине и кредити. Радње и претраге троше API кредите из вашег плана и подлежу истим ограничењима брзине као REST API. Окидачи не троше кредите. Zap који достигне ограничење се поново покушава у Zapier-у након кашњења које FastComments пријави.
Падајући мени Домен је празан. Домени се појављују након што су подешени на страници Домени у FastComments контролној табли. Оставите поље празно да бисте примали догађаје за сваки домен.