FastComments.com

חבר את FastComments ל‑Zapier


האפליקציה FastComments עבור Zapier מחברת את ההערות שלך לאלפי אפליקציות אחרות ללא כתיבת קוד.

השתמש בה כדי לפרסם הודעת Slack כאשר מישהו מגיב, לתעד כל תגובה בגיליון אלקטרוני, ליצור תגובה מהגשת טופס, או להוסיף מגיבים למערכת ה-CRM שלך. הטריגרים מתרחשים ברגע שמשהו קורה, מכיוון שהם מבוססים על webhooks במקום polling, והפעולות קוראות ל-API של FastComments בשמך.

מדריך זה מניח שיש לך חשבון FastComments. אתה יכול ליצור אחד כאן.

מדריך זה מכסה את השימוש באפליקציית Zapier. נקודות הקצה שהיא קוראת, יחד עם פורמטים של בקשות ותשובות וזרימת ה-OAuth שמאחורי החיבור, מתועדות ב-תיעוד ה-API.


חבר את החשבון שלך Internal Link

Connect Your Account

  1. In Zapier, add a FastComments step to a Zap, or open the FastComments app page in the Zapier App Directory.
    ב‑Zapier, הוסף שלב FastComments ל‑Zap, או פתח את דף האפליקציה של FastComments במאגר האפליקציות של Zapier.
  2. Choose Sign in to FastComments. Zapier asks for your region first: pick United States unless your
    account was created on the EU region (eu.fastcomments.com).
    בחר Sign in to FastComments. Zapier שואל תחילה על האזור שלך: בחר United States אלא אם החשבון שלך נוצר באיזור האיחוד האירופי (eu.fastcomments.com).
  3. A FastComments window opens. Sign in if you are not already signed in.
    חלון FastComments נפתח. היכנס אם עדיין לא נכנסת.
  4. Review the consent page. It shows the Zapier application, the account it will be connected to, and the
    permissions requested (read and write). Choose Approve.
    סקור את דף ההסכמה. הוא מציג את אפליקציית Zapier, החשבון שאליו הוא יתחבר, ואת ההרשאות המבוקשות (קריאה וכתיבה). בחר Approve.
  5. Zapier stores the connection and labels it with your site name and username.
    Zapier שומרת את החיבור ומסמנת אותו בשם האתר ובשם המשתמש שלך.

The connection uses OAuth. No API key is copied into Zapier, and the token Zapier holds only works for the
account you approved.
החיבור משתמש ב‑OAuth. אין מפתח API שמועתק ל‑Zapier, והטוקן ש‑Zapier מחזיקה פועל רק עבור החשבון שאישרת.

Who can connect

The person approving the connection must be an API admin on the FastComments account. Account owners
have this permission; other team members can be granted it on the Users page. Someone without it sees a
"you do not have permission" page instead of the consent form.
האדם המאשר את החיבור חייב להיות API admin בחשבון FastComments. לבעלי החשבון יש הרשאה זו; ניתן להעניק אותה לחברי צוות אחרים בעמוד המשתמשים. מי שאין לו את ההרשאה רואה דף "אין לך הרשאה" במקום טופס ההסכמה.

Connecting the right site

The consent page connects the account you are currently signed in to. If you manage several accounts,
switch to the right one from the account switcher before approving, or use the switch account link on
the consent page. The connection label in Zapier shows the site name, so a wrong choice is easy to spot.
דף ההסכמה מחבר את החשבון שבו אתה מחובר כרגע. אם אתה מנהל כמה חשבונות, עבור לחשבון הנכון באמצעות מתג החשבונות לפני האישור, או השתמש בקישור switch account בדף ההסכמה. תווית החיבור ב‑Zapier מציגה את שם האתר, ולכן בחירה שגויה קלה לזיהוי.

Reviewing and revoking access

Every connection appears under Connected Apps in the FastComments dashboard, with the permissions it
holds and when it was last used. Revoking it there disconnects Zapier immediately; any Zap using that
connection stops until it is reconnected. You can also remove the connection from the Zapier side under
My Apps.
כל חיבור מופיע תחת Connected Apps בלוח הבקרה של FastComments, עם ההרשאות שהוא מחזיק ומתי הוא שומש לאחרונה. ביטול החיבור שם מנתק את Zapier מיידית; כל Zap שמשתמש בחיבור זה נעצר עד לחיבור מחדש. ניתן גם להסיר את החיבור מצדו של Zapier תחת My Apps.


טריגרים Internal Link

טריגרים

טריגרים מתחילים Zap כאשר משהו קורה ב‑FastComments. כל השלושה מיידיים: FastComments מעביר את האירוע ל‑Zapier דרך webhook ברגע שהוא מתרחש. שום דבר אינו סורק את החשבון שלך ולא מתבזבזים קרדיטים של API בהמתנה.

טריגרמתרחש כאשר
New Commentתגובה מתפרסמת. כברירת מחדל רק תגובות מאושרות, שאינן ספאם מופעלות.
Updated Commentתגובה נערכת, מאושרת, מקבלת הצבעה, מוצמדת, ננעלת, או שונה בדרך אחרת.
Deleted Commentתגובה נמחקת.

כל טריגר מחזיר את כל התגובה: מזהה, כתובת URL של העמוד ומזהה URL, שם המגיב והדוא"ל, טקסט התגובה כ‑markdown וכ‑HTML, ספירות הצבעות, דגלי אישור וספאם, השפה, הדומיין, וכל אזכורים. השדות תואמים את מטען ה‑webhook המתועד תחת Webhooks, Data Structures.

אפשרויות

Domain. לכל טריגר יש מסנן דומיין אופציונלי, המפרט את הדומיינים שהוגדרו בחשבון שלך. השאר ריק כדי לקבל אירועים מכל דומיין.

Include Unapproved and Spam Comments. רק בטריגר New Comment. תגובות שמוחזקות למודרציה או מסומנות כספאם מדולגות כברירת מחדל. כאשר תגובה כזו מאושרת מאוחר יותר, טריגר Updated Comment מתרחש עבורה, ולכן Zap שצריך להגיב לכל תגובה שמופיעה משתמש ב‑Updated Comment עם מסנן על השדה approved.

איך המסירה עובדת

הפעלת Zap יוצרת מנוי webhook בחשבון שלך, הנראה בדף Webhooks עם המקור API. כיבוי ה‑Zap מסיר אותו. המגבלות של Zapier חלות על מספר האירועים שהיא מקבלת לדקה; FastComments מנסה שוב מסירה שנכשלה, עם עיכוב מתגבר, ומנטרל מנוי שממשיך להיכשל במשך שישה ימים. ניתן להפעיל מחדש מנוי מנוטרל מדף Webhooks, או פשוט לכבות ולהדליק את ה‑Zap שוב כדי ליצור מנוי חדש.

חשבון יכול להכיל עד 50 מנויים של API. כל Zap שמשתמש בטריגר של FastComments משתמש באחד.


פעולות וחיפושים Internal Link

פעולות וחיפושים

פעולות יוצרות נתונים ב‑FastComments; חיפושים מחפשים נתונים כך ששלב מאוחר יותר יכול להשתמש בהם. כל פעולה קוראת ל‑FastComments REST API ומבזבזת את אותם קרדיטי API שהקריאה הייתה עולה מהקוד שלך: קרדיט אחד לכל קריאה אלא אם צוין אחרת.

יצירת תגובה

מפרסמת תגובה בעמוד.

שדהנדרשהערות
Page URL IDכןמזהה ה‑URL שהווידג'ט של התגובה משתמש בו בעמוד. תגובות מקובצות לפי מזהה זה.
Page URLכןכתובת ה‑URL המלאה של העמוד, משמשת במיילי ההודעות.
Commentכןגוף התגובה בפורמט Markdown של FastComments.
Commenter Nameכןהשם הוא ייחודי לכל אימייל, ולכן שימוש חוזר בשם עם אימייל שונה נכשל.
Commenter Emailלאמשתמש נוצר עבור האימייל אם הוא עדיין לא קיים.
User IDלאמזהה משתמש SSO קיים. מקבל עדיפות על פני שם ואימייל.
Parent Comment IDלאהגדרה לפרסום תגובה.
Approved, Verifiedלאשניהם מוגדרים כברירת מחדל ל‑true. תגובות שלא אושרו נשארות מוסתרות עד למודרציה.
Posted Atלאברירת מחדל היא עכשיו.
Avatar URL, Page Title, LocaleלאLocale ברירת מחדל היא en_us.
Show Live In Widgetלאדוחף את התגובה לצופים בזמן אמת. עולה 2 קרדיטים במקום 1.
Run Spam Check, Send Emailsלאכבוי כברירת מחדל.

יצירת או עדכון דף

יוצר רשומת דף לפני שיש תגובה כלשהי עליו, כך שניתן לרשום אותו ולהגביל אותו. מקבל את מזהה ה‑URL, הכותרת, ה‑URL, ובאופן אופציונלי את מזהי קבוצות ה‑SSO המורשים לצפות בו. אם דף עם מזהה URL זה כבר קיים, הוא מתעדכן עם השדות שניתנו, כך ש‑Zap יכול לרוץ על אותו דף באופן חוזר.

יצירת או עדכון משתמש SSO

יוצר משתמש Single Sign-On. מקבל את מזהה המשתמש שלך, שם משתמש ואימייל, בנוסף לשם תצוגה, תווית תצוגה, אווטר, אתר אינטרנט, מזהי קבוצות, ודגלי התראות ופרטיות. אם משתמש עם מזהה זה כבר קיים, הוא מתעדכן במקום זאת. תפקידים מנהליים אינם ניתנים למתן דרך Zapier.

יצירת פוסט בפיד

יוצר פוסט בפיד של FastComments מתוכן HTML. מזהה משתמש המחבר נדרש (מזהה משתמש FastComments או SSO); כותרת, תגיות וקישור תצוגה מקדימה אחד הם אופציונליים.

יצירת או עדכון תגית Hash

יוצר תגית hash שהמשתמשים יכולים להשתמש בה, עם URL אופציונלי שאליו היא מקשרת. אם התגית כבר קיימת, היא מתעדכנת במקום זאת.

סימון תגובה

מסמן תגובה לבחינת מודרטור. מזהה המשתמש המבצע את הסימון נדרש; מזהה המחבר שמוחזר על ידי יצירת תגובה עובד.

חיפושים

חיפושקלטמחזיר
Find CommentComment IDהתגובה, או כלום.
Find SSO UserEmailמשתמש ה‑SSO, או כלום.
Find PageURL IDהדף, או כלום.

חיפוש שמחזיר תוצאה ריקה אינו גורם לכישלון של ה‑Zap. Find SSO User ו‑Find Page מציעים את אפשרות Zapier "create if it doesn't exist" (צור אם אינו קיים), שמריצה את יצירת ההתאמה כאשר לא נמצא דבר.

דוגמאות Zaps Internal Link

דוגמאות ל‑Zaps

כמה זרימות עבודה שלוקחות דקות להקמה.

קבלו התראה על תגובות חדשות. New Comment, then Slack "Send Channel Message" or Discord "Send Channel Message". Map the commenter name, the comment text, and the page URL into the message. Add the domain filter to notify a different channel per site.

שמרו יומן של כל תגובה. New Comment, then Google Sheets "Create Spreadsheet Row". Add Deleted Comment as a second Zap that appends a row with the comment id, so the sheet doubles as an audit trail.

שלחו אימייל למחבר כאשר תגובה מאושרת. Updated Comment with a Zapier filter on Approved is true, then Gmail "Send Email". Because Updated Comment fires on every change, the filter is what makes this Zap react only to approvals.

הוסיפו מגיבים למערכת ה‑CRM או לרשימת התפוצה שלכם. New Comment, then HubSpot "Create or Update Contact" or Mailchimp "Add or Update Subscriber" using the commenter email. Respect your privacy policy and local law before adding anyone to a marketing list.

צרו תגובה מטופס. Typeform or Google Forms "New Response", then FastComments Create Comment with the page URL ID your site uses for testimonials. Leave Approved unchecked to review each one before it appears.

פרסמו הודעות לפיד. 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.

פתרון בעיות Internal Link

פתרון בעיות

"אין לך הרשאה" בעת החיבור. המשתמש המחובר אינו מנהל API בחשבון.
בקש מבעל החשבון להעניק הרשאת API בדף המשתמשים, או התחבר כבעל החשבון.

החיבור מתויג עם האתר הלא נכון. דף ההסכמה מחבר את החשבון שבו היית מחובר באותו רגע. נתק ב‑Zapier, החלף חשבונות בלוח הבקרה של FastComments, והתחבר שוב.

האירועים הפסיקו להגיע. בדוק את דף ה‑Webhooks בלוח הבקרה. מנוי שהקצה שלו נכשל במשך שישה ימים מושבת אוטומטית ומציג את הסיבה. הפעל אותו מחדש שם, או כבה והפעל את ה‑Zap שוב. אם המנוי חסר לחלוטין, מישהו מחק אותו; כיבוי והפעלה של ה‑Zap יוצרים אותו מחדש.

Zapier אומר שהחשבון צריך להתחבר מחדש. החיבור בוטל מדף האפליקציות המחוברות, המשתמש שאישר אותו איבד את הרשאת ה‑API, או שהחשבון נמחק. התחבר מחדש מ‑Zapier.

פעולה נכשלה עם "אין גישה לכתיבה". החיבור אושר עם הרשאת קריאה בלבד. התחבר מחדש ואשר את שתי ההרשאות.

מגבלות קצב וקרדיטים. פעולות וחיפושים משתמשים בקרדיטי API מהתוכנית שלך והם כפופים לאותן מגבלות קצב כמו ה‑REST API. טריגרים אינם משתמשים בקרדיטים. Zap שמגיע למגבלה יופעל מחדש על ידי Zapier לאחר העיכוב שמדווח על ידי FastComments.

תפריט הנפתחת של הדומיין ריק. דומיינים מופיעים לאחר שהם מוגדרים בדף הדומיינים בלוח הבקרה של FastComments. השאר את השדה ריק כדי לקבל אירועים מכל דומיין.