חבר את FastComments ל‑Zapier
האפליקציה FastComments עבור Zapier מחברת את ההערות שלך לאלפי אפליקציות אחרות ללא כתיבת קוד.
השתמש בה כדי לפרסם הודעת Slack כאשר מישהו מגיב, לתעד כל תגובה בגיליון אלקטרוני, ליצור תגובה מהגשת טופס, או להוסיף מגיבים למערכת ה-CRM שלך. הטריגרים מתרחשים ברגע שמשהו קורה, מכיוון שהם מבוססים על webhooks במקום polling, והפעולות קוראות ל-API של FastComments בשמך.
מדריך זה מניח שיש לך חשבון FastComments. אתה יכול ליצור אחד כאן.
מדריך זה מכסה את השימוש באפליקציית Zapier. נקודות הקצה שהיא קוראת, יחד עם פורמטים של בקשות ותשובות וזרימת ה-OAuth שמאחורי החיבור, מתועדות ב-תיעוד ה-API.
חבר את החשבון שלך 
חיבור החשבון שלך
- ב-Zapier, הוסיפו שלב של FastComments ל-Zap, או פתחו את דף האפליקציה של FastComments בספריית האפליקציות של Zapier.
- בחרו Sign in to FastComments. Zapier מבקש תחילה את האזור שלכם: בחרו United States אלא אם
החשבון שלכם נוצר באזור האירופי (
eu.fastcomments.com). - חלון של FastComments נפתח. התחברו אם אינכם מחוברים כבר.
- עיינו בדף ההסכמה. הוא מציג את אפליקציית Zapier, את החשבון שאליו יתחבר, ואת ההרשאות המבוקשות (קריאה וכתיבה). בחרו Approve.
- Zapier שומר את החיבור ומתייג אותו עם שם האתר ושם המשתמש שלכם.
החיבור משתמש ב-OAuth. לא מועתק מפתח API ל-Zapier, והטוקן ש-Zapier מחזיק עובד רק עבור החשבון שאישרתם.
מי יכול לחבר
האדם המאשר את החיבור חייב להיות מנהל API בחשבון FastComments. לבעלי החשבון יש הרשאה זו; חברי צוות אחרים יכולים לקבל אותה בדף המשתמשים. מישהו ללא ההרשאה יראה דף "אין לך הרשאה" במקום טופס ההסכמה.
חיבור האתר הנכון
דף ההסכמה מחבר את החשבון שאליו אתם מחוברים כרגע. אם אתם מנהלים מספר חשבונות, עברו לחשבון הנכון דרך מחליף החשבונות לפני האישור, או השתמשו בקישור switch account בדף ההסכמה. תווית החיבור ב-Zapier מציגה את שם האתר, ולכן קל לזהות בחירה שגויה.
סקירה ושלילת גישה
כל חיבור מופיע תחת Connected Apps בלוח הבקרה של FastComments, עם ההרשאות שהוא מחזיק ומתי נעשה בו שימוש אחרון. שלילת החיבור שם מנתקת את Zapier מיד; כל Zap המשתמש בחיבור זה יפסיק לפעול עד לחיבור מחדש. ניתן גם להסיר את החיבור מצד Zapier תחת My Apps.
טריגרים
טריגרים
טריגרים מתחילים 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 משתמש באחד.
פעולות וחיפושים
פעולות וחיפושים
פעולות יוצרות נתונים ב‑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 Comment | Comment ID | התגובה, או כלום. |
| Find SSO User | משתמש ה‑SSO, או כלום. | |
| Find Page | URL ID | הדף, או כלום. |
חיפוש שמחזיר תוצאה ריקה אינו גורם לכישלון של ה‑Zap. Find SSO User ו‑Find Page מציעים את אפשרות Zapier "create if it doesn't exist" (צור אם אינו קיים), שמריצה את יצירת ההתאמה כאשר לא נמצא דבר.
דוגמאות Zaps
דוגמאות Zaps
מספר תהליכי עבודה שהקמתם לוקחת דקות ספורות.
קבלת התראה על תגובות חדשות. New Comment, ואז Slack "Send Channel Message" או Discord "Send Channel Message". מפו את שם המגיב, טקסט התגובה וכתובת ה-URL של העמוד לתוך ההודעה. הוסיפו את מסנן הדומיין כדי לקבל התראה בערוץ אחר לכל אתר.
שמירת יומן של כל תגובה. New Comment, ואז Google Sheets "Create Spreadsheet Row". הוסיפו Deleted Comment כ-Zap שני שמוסיף שורה עם מזהה התגובה, כך שהגיליון משמש גם כראיה ביקורתית.
שליחת אימייל למחבר כאשר תגובה מאושרת. Updated Comment עם מסנן Zapier על Approved שווה ל-true, ואז Gmail "Send Email". מכיוון ש-Updated Comment מופעל בכל שינוי, המסנן הוא מה שמבטיח שה-Zap יגיב רק לאישורים.
הוספת מגיבים ל-CRM או לרשימת הדיוור שלכם. New Comment, ואז HubSpot "Create or Update Contact" או Mailchimp "Add or Update Subscriber" באמצעות האימייל של המגיב. כבדו את מדיניות הפרטיות שלכם ואת החוק המקומי לפני הוספת כל אדם לרשימת שיווק.
יצירת תגובה מטופס. Typeform או Google Forms "New Response", ואז FastComments Create Comment עם מזהה ה-URL של העמוד בו האתר שלכם משתמש עבור המלצות. השאירו את Approved לא מסומן כדי לסקור כל תגובה לפני שהיא מופיעה.
פרסום הכרזות בפיד. RSS by Zapier "New Item in Feed", ואז Create Feed Post עם הכותרת, התוכן והקישור של הפריט.
הקצאת חברים כמשתמשי SSO. Memberstack, Memberful, או webhook משלכם, ואז Find SSO User ולאחריו Create SSO User במצב "find or create".
העלאת תגובות מדווחות לטיפול. Updated Comment, מסונן על ספירת דגלים גבוהה מאפס, ואז Trello "Create Card" או Linear "Create Issue" עם מזהה התגובה וקישור לעמוד הפיקוח.
פרסום עמודים כשהם עולים לאוויר. WordPress או Ghost "New Post", ואז Create Page עם ה-URL של הפוסט, כך שהעמוד יופיע ברשימה ויוגבל לפני התגובה הראשונה.
ארכוב תגובות שנמחקו. Deleted Comment, ואז Airtable "Create Record" עם התגובה המלאה לצורך שמירה לתאימות רגולטורית.
פתרון בעיות
פתרון בעיות
"אין לך הרשאה" בעת החיבור. המשתמש המחובר אינו מנהל API בחשבון.
בקש מבעל החשבון להעניק הרשאת API בדף המשתמשים, או התחבר כבעל החשבון.
החיבור מתויג עם האתר הלא נכון. דף ההסכמה מחבר את החשבון שבו היית מחובר באותו רגע. נתק ב‑Zapier, החלף חשבונות בלוח הבקרה של FastComments, והתחבר שוב.
האירועים הפסיקו להגיע. בדוק את דף ה‑Webhooks בלוח הבקרה. מנוי שהקצה שלו נכשל במשך שישה ימים מושבת אוטומטית ומציג את הסיבה. הפעל אותו מחדש שם, או כבה והפעל את ה‑Zap שוב. אם המנוי חסר לחלוטין, מישהו מחק אותו; כיבוי והפעלה של ה‑Zap יוצרים אותו מחדש.
Zapier אומר שהחשבון צריך להתחבר מחדש. החיבור בוטל מדף האפליקציות המחוברות, המשתמש שאישר אותו איבד את הרשאת ה‑API, או שהחשבון נמחק. התחבר מחדש מ‑Zapier.
פעולה נכשלה עם "אין גישה לכתיבה". החיבור אושר עם הרשאת קריאה בלבד. התחבר מחדש ואשר את שתי ההרשאות.
מגבלות קצב וקרדיטים. פעולות וחיפושים משתמשים בקרדיטי API מהתוכנית שלך והם כפופים לאותן מגבלות קצב כמו ה‑REST API. טריגרים אינם משתמשים בקרדיטים. Zap שמגיע למגבלה יופעל מחדש על ידי Zapier לאחר העיכוב שמדווח על ידי FastComments.
תפריט הנפתחת של הדומיין ריק. דומיינים מופיעים לאחר שהם מוגדרים בדף הדומיינים בלוח הבקרה של FastComments. השאר את השדה ריק כדי לקבל אירועים מכל דומיין.