Συνδέστε το FastComments με το Zapier

Σύνδεση του λογαριασμού σας

1. Στο Zapier, προσθέστε ένα βήμα FastComments σε ένα Zap ή ανοίξτε τη σελίδα της εφαρμογής FastComments στον Zapier App Directory.
2. Επιλέξτε Sign in to FastComments. Το Zapier ζητά πρώτα την περιοχή σας: επιλέξτε United States, εκτός αν ο λογαριασμός σας δημιουργήθηκε στην περιοχή ΕΕ (eu.fastcomments.com).
3. Ανοίγει ένα παράθυρο FastComments. Συνδεθείτε αν δεν είστε ήδη συνδεδεμένοι.
4. Ελέγξτε τη σελίδα συγκατάθεσης. Εμφανίζει την εφαρμογή Zapier, τον λογαριασμό που θα συνδεθεί και τα δικαιώματα που ζητούνται (ανάγνωση και εγγραφή). Επιλέξτε Approve.
5. Το Zapier αποθηκεύει τη σύνδεση και την επισημαίνει με το όνομα του ιστότοπού σας και το όνομα χρήστη σας.

Η σύνδεση χρησιμοποιεί OAuth. Κανένα κλειδί API δεν αντιγράφεται στο Zapier, και το token που κρατά το Zapier λειτουργεί μόνο για τον λογαριασμό που εγκρίνατε.

Ποιος μπορεί να συνδεθεί

Το άτομο που εγκρίνει τη σύνδεση πρέπει να είναι API admin στον λογαριασμό FastComments. Οι ιδιοκτήτες λογαριασμού έχουν αυτό το δικαίωμα· άλλα μέλη της ομάδας μπορούν να του αποδοθεί στη σελίδα Users. Κάποιος χωρίς αυτό βλέπει μια σελίδα «δεν έχετε δικαίωμα» αντί για τη φόρμα συγκατάθεσης.

Σύνδεση του σωστού ιστότοπου

Η σελίδα συγκατάθεσης συνδέει τον λογαριασμό στον οποίο είστε αυτή τη στιγμή συνδεδεμένοι. Αν διαχειρίζεστε πολλούς λογαριασμούς, αλλάξτε στον σωστό από τον εναλλάκτη λογαριασμών πριν την έγκριση, ή χρησιμοποιήστε τον σύνδεσμο switch account στη σελίδα συγκατάθεσης. Η ετικέτα της σύνδεσης στο Zapier εμφανίζει το όνομα του ιστότοπου, οπότε μια λάθος επιλογή είναι εύκολο να εντοπιστεί.

Έλεγχος και ανάκληση πρόσβασης

Κάθε σύνδεση εμφανίζεται κάτω από Connected Apps στον πίνακα ελέγχου του FastComments, με τα δικαιώματα που κατέχει και πότε χρησιμοποιήθηκε τελευταία φορά. Η ανάκλησή της εκεί αποσυνδέει αμέσως το Zapier· κάθε Zap που χρησιμοποιεί αυτή τη σύνδεση σταματά μέχρι να επανασυνδεθεί. Μπορείτε επίσης να αφαιρέσετε τη σύνδεση από την πλευρά του Zapier κάτω από My Apps.

Ενεργοποιητές

Οι ενεργοποιητές ξεκινούν ένα Zap όταν συμβαίνει κάτι στο FastComments. Και οι τρεις είναι άμεσοι: το FastComments παραδίδει το γεγονός στο Zapier μέσω webhook τη στιγμή που συμβαίνει. Τίποτα δεν ελέγχει (polls) τον λογαριασμό σας και δεν δαπανώνται πιστώσεις API σε αναμονή.

Κάθε ενεργοποιητής επιστρέφει το πλήρες σχόλιο: id, URL σελίδας και URL ID, όνομα και email του σχολιαστή, το κείμενο του σχολίου ως markdown και ως HTML, αριθμούς ψήφων, σημαίες έγκρισης και spam, τη γλώσσα, τον τομέα και τυχόν αναφορές. Τα πεδία ταιριάζουν με το payload του webhook που τεκμηριώνεται στην ενότητα Webhooks, Data Structures.

Επιλογές

Domain. Κάθε ενεργοποιητής έχει ένα προαιρετικό φίλτρο τομέα, που παραθέτει τους τομείς που έχουν ρυθμιστεί στον λογαριασμό σας. Αφήστε το κενό για να λαμβάνετε γεγονότα από κάθε τομέα.

Include Unapproved and Spam Comments. Μόνο στον ενεργοποιητή Νέο Σχόλιο. Τα σχόλια που κρατούνται για έλεγχο ή επισημαίνονται ως spam παραλείπονται από προεπιλογή. Όταν ένα τέτοιο σχόλιο εγκριθεί αργότερα, ο ενεργοποιητής Ενημερωμένο Σχόλιο ενεργοποιείται για αυτό, έτσι ένα Zap που πρέπει να αντιδρά σε κάθε σχόλιο που γίνεται ορατό χρησιμοποιεί το Ενημερωμένο Σχόλιο με ένα φίλτρο στο πεδίο approved.

Πώς λειτουργεί η παράδοση

Η ενεργοποίηση ενός Zap δημιουργεί μια συνδρομή webhook στον λογαριασμό σας, ορατή στη σελίδα Webhooks με την πηγή API. Η απενεργοποίηση του Zap την αφαιρεί. Οι δικοί περιορισμοί του Zapier ισχύουν για το πόσα γεγονότα δέχεται ανά λεπτό· το FastComments επαναπροσπαθεί μια αποτυχημένη παράδοση, με αυξανόμενη καθυστέρηση, και απενεργοποιεί μια συνδρομή που αποτυγχάνει συνεχώς για έξι ημέρες. Μια απενεργοποιημένη συνδρομή μπορεί να ενεργοποιηθεί ξανά από τη σελίδα Webhooks, ή απλώς απενεργοποιήστε και ενεργοποιήστε ξανά το Zap για να δημιουργήσετε μια νέα.

Ένας λογαριασμός μπορεί να διατηρεί έως 50 συνδρομές API. Κάθε Zap που χρησιμοποιεί έναν ενεργοποιητή FastComments χρησιμοποιεί μία.

Ενέργειες και Αναζητήσεις

Οι ενέργειες δημιουργούν δεδομένα στο FastComments· οι αναζητήσεις εντοπίζουν δεδομένα ώστε ένα μεταγενέστερο βήμα να μπορεί να τα χρησιμοποιήσει. Κάθε ενέργεια καλεί το FastComments REST API και καταναλώνει τα ίδια API credits που θα κόστιζε η κλήση από τον δικό σας κώδικα: ένα credit ανά κλήση, εκτός εάν αναφέρεται διαφορετικά.

Δημιουργία Σχολίου

Αναρτά ένα σχόλιο σε μια σελίδα.

Δημιουργία ή Ενημέρωση Σελίδας

Δημιουργεί μια εγγραφή σελίδας πριν υπάρξει οποιοδήποτε σχόλιο, ώστε να μπορεί να εμφανιστεί και να περιοριστεί. Δέχεται το URL ID, τον τίτλο, το URL και προαιρετικά τα SSO group ids που επιτρέπεται να δουν τη σελίδα. Εάν υπάρχει ήδη σελίδα με αυτό το URL ID, ενημερώνεται με τα παρεχόμενα πεδία, ώστε ένα Zap να μπορεί να εκτελείται επανειλημμένα για την ίδια σελίδα.

Δημιουργία ή Ενημέρωση Χρήστη SSO

Δημιουργεί έναν χρήστη single sign-on. Δέχεται το δικό σας user id, όνομα χρήστη και email, καθώς και προαιρετικά εμφανιζόμενο όνομα, ετικέτα εμφάνισης, avatar, ιστοσελίδα, group ids, και σημαίες ειδοποιήσεων και απορρήτου. Εάν υπάρχει ήδη χρήστης με αυτό το id, ενημερώνεται αντί για δημιουργία. Οι διοικητικοί ρόλοι δεν μπορούν να χορηγηθούν από το Zapier.

Δημιουργία Δημοσίευσης Ροής

Δημιουργεί μια δημοσίευση σε ροή FastComments από περιεχόμενο HTML. Το author user id είναι υποχρεωτικό (FastComments ή SSO user id); ο τίτλος, οι ετικέτες και μια προεπισκόπηση συνδέσμου είναι προαιρετικά.

Δημιουργία ή Ενημέρωση Hash Tag

Δημιουργεί ένα hashtag που μπορούν να χρησιμοποιήσουν οι σχολιαστές, με προαιρετικό URL στο οποίο οδηγεί. Εάν το hashtag υπάρχει ήδη, ενημερώνεται αντί για δημιουργία.

Σήμανση Σχολίου

Σημαδεύει ένα σχόλιο για έλεγχο από συντονιστή. Το id του χρήστη που κάνει τη σήμανση είναι υποχρεωτικό· το author id που επιστρέφεται από τη Δημιουργία Σχολίου λειτουργεί.

Αναζητήσεις

Μια αναζήτηση που δεν βρίσκει τίποτα δεν αποτυγχάνει το Zap. Τα Find SSO User και Find Page προσφέρουν την επιλογή του Zapier «create if it doesn't exist», η οποία εκτελεί τη δημιουργία όταν δεν βρεθεί αποτέλεσμα.

Παραδείγματα Zaps

Μερικές ροές εργασίας που ρυθμίζονται μέσα σε λίγα λεπτά.

Ενημέρωση για νέα σχόλια. New Comment, και μετά Slack "Send Channel Message" ή Discord "Send Channel Message". Αντιστοιχίστε το όνομα του σχολιαστή, το κείμενο του σχολίου και το URL της σελίδας στο μήνυμα. Προσθέστε το φίλτρο domain για να ειδοποιείτε διαφορετικό κανάλι ανά ιστότοπο.

Καταγραφή κάθε σχολίου σε log. New Comment, και μετά Google Sheets "Create Spreadsheet Row". Προσθέστε το Deleted Comment ως δεύτερο Zap που προσθέτει μια γραμμή με το id του σχολίου, ώστε το φύλλο να λειτουργεί και ως audit trail.

Email στον συγγραφέα όταν εγκρίνεται ένα σχόλιο. Updated Comment με φίλτρο Zapier στο Approved is true, και μετά Gmail "Send Email". Επειδή το Updated Comment ενεργοποιείται σε κάθε αλλαγή, το φίλτρο είναι αυτό που κάνει το Zap να αντιδρά μόνο στις εγκρίσεις.

Προσθήκη σχολιαστών στο CRM ή στη λίστα αλληλογραφίας σας. New Comment, και μετά HubSpot "Create or Update Contact" ή Mailchimp "Add or Update Subscriber" χρησιμοποιώντας το email του σχολιαστή. Σεβαστείτε την πολιτική απορρήτου σας και την τοπική νομοθεσία πριν προσθέσετε οποιονδήποτε σε λίστα μάρκετινγκ.

Δημιουργία σχολίου από φόρμα. Typeform ή Google Forms "New Response", και μετά FastComments Create Comment με το page URL ID που χρησιμοποιεί ο ιστότοπός σας για μαρτυρίες (testimonials). Αφήστε το Approved ανενεργό για να ελέγχετε το καθένα πριν εμφανιστεί.

Δημοσίευση ανακοινώσεων σε feed. 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, φιλτραρισμένο σε αριθμό σημάνσεων (flags) πάνω από μηδέν, και μετά Trello "Create Card" ή Linear "Create Issue" με το id του σχολίου και έναν σύνδεσμο προς τη σελίδα διαχείρισης.

Δημοσίευση σελίδων καθώς βγαίνουν live. WordPress ή Ghost "New Post", και μετά Create Page με το URL της ανάρτησης, ώστε η σελίδα να είναι καταχωρημένη και περιορισμένη πριν το πρώτο σχόλιο.

Αρχειοθέτηση διαγραμμένων σχολίων. Deleted Comment, και μετά Airtable "Create Record" με το πλήρες σχόλιο για συμμόρφωση με απαιτήσεις διατήρησης δεδομένων.

Αντιμετώπιση προβλημάτων

"Δεν έχετε άδεια" κατά τη σύνδεση. Ο συνδεδεμένος χρήστης δεν είναι διαχειριστής API στον λογαριασμό.
Ζητήστε από τον κάτοχο του λογαριασμού να χορηγήσει την άδεια API στη σελίδα Χρήστες, ή συνδεθείτε ως ο κάτοχος.

Η σύνδεση έχει ετικέτα με το λάθος ιστότοπο. Η σελίδα συγκατάθεσης συνδέει τον λογαριασμό στον οποίο ήσασταν συνδεδεμένοι εκείνη τη στιγμή. Αποσυνδέστε στο Zapier, αλλάξτε λογαριασμούς στον πίνακα ελέγχου FastComments, και συνδέστε ξανά.

Τα συμβάντα σταμάτησαν να φθάνουν. Ελέγξτε τη σελίδα Webhooks στον πίνακα ελέγχου. Μια συνδρομή της οποίας το endpoint απέτυχε για έξι ημέρες απενεργοποιείται αυτόματα και εμφανίζει το λόγο. Ενεργοποιήστε την ξανά εκεί, ή απενεργοποιήστε και ενεργοποιήστε ξανά το Zap. Εάν η συνδρομή λείπει εντελώς, κάποιος τη διέγραψε· η απενεργοποίηση και ενεργοποίηση του Zap την δημιουργεί ξανά.

Το Zapier λέει ότι ο λογαριασμός χρειάζεται επανασύνδεση. Η σύνδεση ανακλήθηκε από τη σελίδα Συνδεδεμένες Εφαρμογές, ο χρήστης που την ενέκρινε έχασε την άδεια API, ή ο λογαριασμός διαγράφηκε. Επανασυνδεθείτε από το Zapier.

Μια ενέργεια αποτυγχάνει με το μήνυμα "δεν έχει πρόσβαση εγγραφής". Η σύνδεση εγκρίθηκε με άδεια μόνο ανάγνωσης. Επανασυνδεθείτε και εγκρίνετε και τις δύο άδειες.

Όρια ρυθμού και μονάδες. Οι ενέργειες και οι αναζητήσεις καταναλώνουν μονάδες API από το πλάνο σας και υπόκεινται στα ίδια όρια ρυθμού με το REST API. Οι ενεργοποιητές δεν καταναλώνουν καμία. Ένα Zap που φτάσει σε όριο επαναπροσπαθείται από το Zapier μετά την καθυστέρηση που αναφέρει το FastComments.

Το αναπτυσσόμενο μενού Domain είναι κενό. Τα domains εμφανίζονται μόλις ρυθμιστούν στη σελίδα Domains στον πίνακα ελέγχου FastComments. Αφήστε το πεδίο κενό για να λαμβάνετε συμβάντα για κάθε domain.