Χρησιμοποιήστε το ThunderPhone με το n8n

Εγκαταστήστε τον κόμβο ThunderPhone για το n8n, συνδέστε ένα κλειδί API διακομιστή και δημιουργήστε μια ροή εργασίας που εκτελείται κάθε φορά που τερματίζεται μια κλήση.

n8n είναι ένα εργαλείο αυτοματοποίησης ροών εργασίας. Το πακέτο ThunderPhone για το n8n προσθέτει δύο κόμβους:

• Το ThunderPhone Trigger ξεκινά μια ροή εργασίας όταν ολοκληρώνεται μια κλήση (Η κλήση ολοκληρώθηκε) ή όταν ολοκληρώνεται μια εκτέλεση αξιολόγησης κλήσης (Η κλήση αξιολογήθηκε).
• Το ThunderPhone πραγματοποιεί εξερχόμενες κλήσεις, προσθέτει επαφές σε καμπάνιες και τις ξεκινά, ανακτά κλήσεις με την απομαγνητοφώνηση και την εγγραφή τους και εμφανίζει τους πράκτορες και τους αριθμούς τηλεφώνου σας.

Είναι ένας επαληθευμένος κόμβος κοινότητας, καταχωρισμένος στο ThunderPhone στο n8n.

Εγκατάσταση του κόμβου#

Στον επεξεργαστή n8n, κάντε κλικ στο + για να ανοίξετε τον πίνακα κόμβων και αναζητήστε το ThunderPhone. Ο κάτοχος του στιγμιότυπου ίσως χρειαστεί να ρυθμίσει τους επαληθευμένους κόμβους προτού μπορέσουν να τους προσθέσουν άλλοι χρήστες.

Σε αυτοφιλοξενούμενο n8n, μπορείτε επίσης να κάνετε εγκατάσταση με το όνομα πακέτου: ανοίξτε Ρυθμίσεις > Κόμβοι κοινότητας και εγκαταστήστε το n8n-nodes-thunderphone. Ελέγξτε τους κινδύνους των κόμβων κοινότητας και την πολιτική του στιγμιότυπού σας πριν κάνετε εγκατάσταση.

Δημιουργία κλειδιού API διακομιστή#

1. Ανοίξτε την καρτέλα Κλειδιά

   Στο ThunderPhone, μεταβείτε στις Οργανισμός → Κλειδιά και κάντε κλικ στο Δημιουργία κλειδιού.

2. Ονομάστε το

   Χρησιμοποιήστε ένα όνομα που υποδεικνύει πού βρίσκεται το κλειδί, όπως «n8n».

3. Αντιγράψτε το τώρα

   Το πλήρες μυστικό sk_live_... εμφανίζεται μία φορά. Αντιγράψτε το προτού κλείσετε το παράθυρο διαλόγου.

Μόνο ένας διαχειριστής ή κάτοχος μπορεί να δημιουργήσει το κλειδί και το ThunderPhone αντιμετωπίζει τα αιτήματα που πραγματοποιούνται με αυτό ως αιτήματα αυτού του ατόμου. Ο ενεργοποιητής και οι λειτουργίες καμπάνιας απαιτούν από αυτό το άτομο να διατηρεί τον ρόλο διαχειριστή ή κατόχου. Το Δημιουργία κλειδιού API διακομιστή καλύπτει την εναλλαγή και την ανάκληση.

Προσθήκη των διαπιστευτηρίων στο n8n#

1. Στο n8n, δημιουργήστε διαπιστευτήρια τύπου ThunderPhone API.
2. Επικολλήστε το κλειδί στο Κλειδί API.
3. Αποθηκεύστε τα και εκτελέστε τη δοκιμή διαπιστευτηρίων. Η δοκιμή ανακτά μία κλήση από τον οργανισμό σας με GET /v1/calls?limit=1.

Δημιουργία ενός πρώτου workflow#

Αυτό το workflow προσθέτει μια γραμμή σε ένα Google Sheet κάθε φορά που ολοκληρώνεται μια κλήση.

1. Προσθήκη του ενεργοποιητή

   Προσθέστε τον Ενεργοποιητή ThunderPhone, επιλέξτε το διαπιστευτήριο API του ThunderPhone και ορίστε το Συμβάν σε Η κλήση ολοκληρώθηκε.

2. Λήψη της κλήσης

   Προσθέστε έναν κόμβο ThunderPhone. Ορίστε τον Πόρο σε Κλήση, τη Λειτουργία σε Λήψη και το Αναγνωριστικό κλήσης στην έκφραση {{ $json.data.call_id }}. Η έξοδος είναι η εγγραφή κλήσης, μαζί με τα transcripts και recording_url, έναν σύνδεσμο περιορισμένης διάρκειας που είναι null όταν η κλήση δεν έχει εγγραφή.

3. Προσθήκη γραμμής

   Προσθέστε έναν κόμβο Google Sheets που προσθέτει μια γραμμή και αντιστοιχίστε τις στήλες που θέλετε από την έξοδο Λήψη κλήσης (δείτε τον παρακάτω πίνακα).

4. Ενεργοποίηση του workflow

   Αποθηκεύστε και ενεργοποιήστε το. Ο ενεργοποιητής καταχωρίζει το URL παραγωγής του ως τελικό σημείο webhook στον οργανισμό σας στο ThunderPhone. Η απενεργοποίηση του workflow διαγράφει αυτό το τελικό σημείο.

5. Δοκιμή

   Ανοίξτε έναν πράκτορα στο εργαλείο δημιουργίας, κάντε κλικ στο Μιλήστε και τερματίστε την κλήση. Οι δοκιμαστικές κλήσεις του εργαλείου δημιουργίας παραδίδονται ως web.complete, ένα από τα δύο συμβάντα που αντιστοιχούν στο Η κλήση ολοκληρώθηκε, ώστε να εκτελείται το workflow και να εμφανίζεται μια γραμμή.

Χρήσιμες στήλες:

Ο σύνδεσμος κλήσης ανοίγει την κλήση στον πίνακα ελέγχου του ThunderPhone για τα μέλη του οργανισμού σας, μαζί με την απομαγνητοφώνηση και την εγγραφή της, ώστε το φύλλο να μη χρειάζεται να αποθηκεύει κανένα από τα δύο.

Για να προσθέσετε ούτως ή άλλως την απομαγνητοφώνηση, αντιστοιχίστε την έκφραση {{ $json.transcripts.filter(t => typeof t.content === 'string').map(t => t.role + ': ' + t.content).join('\n') }}. Το URL της εγγραφής λήγει, επομένως αποθηκεύστε το αναγνωριστικό κλήσης και εκτελέστε ξανά τη Λήψη κλήσης όταν χρειάζεστε έναν νέο σύνδεσμο. Οι απομαγνητοφωνήσεις, οι περιλήψεις και οι εγγραφές κλήσεων μπορεί να περιέχουν προσωπικές πληροφορίες ή πληροφορίες υγείας. Στείλτε τες μόνο σε εφαρμογές που ο οργανισμός σας επιτρέπεται να χρησιμοποιεί για αυτά τα δεδομένα, με BAA όπου εμπλέκονται πληροφορίες υγείας, και διατηρείτε μόνο τα πεδία που χρειάζεστε.

Ο ενεργοποιητής παράγει το πλήρες συμβάν: type, event_id και data. Δείτε telephony.complete / web.complete και call.graded για κάθε πεδίο. Η παράδοση γίνεται τουλάχιστον μία φορά και το event_id παραμένει το ίδιο στις επαναλήψεις ενός συμβάντος, επομένως ελέγξτε το πριν από ένα βήμα που δεν πρέπει να επαναληφθεί.

Πραγματοποιήστε εξερχόμενες κλήσεις με ασφάλεια#

Η Πραγματοποίηση εξερχόμενης κλήσης (Πόρος Εξερχόμενη κλήση, Ενέργεια Πραγματοποίηση) δέχεται:

Αντιστοιχίστε το Κλειδί ιδιοδυναμίας σε ένα αναγνωριστικό από οτιδήποτε προκάλεσε την εκτέλεση, όπως ένα αναγνωριστικό εγγραφής CRM ή το event_id του εναύσματος. Ο κόμβος στέλνει n8n:<node ID>:<your value>, επομένως:

• Μια αυτόματη επανάληψη ή η Επανάληψη εκτέλεσης στέλνει το ίδιο κλειδί και το ThunderPhone επιστρέφει την αρχική κλήση με idempotent_replay: true αντί να καλέσει ξανά.
• Δύο κόμβοι ThunderPhone που τροφοδοτούνται με την ίδια εγγραφή στέλνουν διαφορετικά κλειδιά.
• Μια κενή τιμή αποτυγχάνει πριν σταλεί οποιοδήποτε αίτημα.

Αποφύγετε τις χρονικές σημάνσεις, τις τυχαίες τιμές και τα αναγνωριστικά εκτέλεσης ή ροής εργασίας του n8n. Μια νέα τιμή κατά την επανάληψη πραγματοποιεί δεύτερη πραγματική κλήση. Ολόκληρο το κλειδί μπορεί να έχει έως 128 χαρακτήρες. Η επαναχρησιμοποίηση ενός κλειδιού με διαφορετικό πράκτορα, αριθμό ή μεταβλητές αποτυγχάνει με σύγκρουση.

Καμπάνιες. Η Προσθήκη επαφών (Πόρος Καμπάνια) προσθέτει επαφές σε μια πρόχειρη καμπάνια. Δέχεται ένα αναγνωριστικό καμπάνιας και έναν πίνακα JSON με επαφές. Κάθε επαφή χρειάζεται phone_number; τα άλλα κλειδιά γίνονται μεταβλητές κλήσης. Ο κόμβος αποτυγχάνει όταν απορρίπτεται κάθε επαφή και ορίζει partial_success: true όταν απορρίπτονται μόνο ορισμένες. Η Έναρξη απαιτεί το πλαίσιο επιλογής που επιβεβαιώνει ότι η καμπάνια πραγματοποιεί πραγματικές κλήσεις και καταναλώνει πιστώσεις ThunderPhone. Δείτε τις Εξερχόμενες καμπάνιες.

Πριν μια ροή εργασίας αρχίσει να πραγματοποιεί κλήσεις:

• Αν το ThunderPhone ζητήσει από τον οργανισμό σας να επιβεβαιώσει ότι οι εξερχόμενες κλήσεις του συμμορφώνονται με το TCPA και άλλους νόμους περί κλήσεων, ένας διαχειριστής πρέπει πρώτα να καταγράψει αυτήν την επιβεβαίωση στον πίνακα ελέγχου.
• Ο αριθμός προέλευσης πρέπει να είναι ενεργοποιημένος για εξερχόμενες κλήσεις. Οι αριθμοί που φέρνετε από τον δικό σας πάροχο πληρούν τις προϋποθέσεις μόλις επαληθευτούν. Οι αριθμοί ThunderPhone αρχικά είναι μόνο για εισερχόμενες κλήσεις και μπορούν να εγκριθούν για εξερχόμενη χρήση: ένας διαχειριστής το ζητά από τη σελίδα Αριθμοί τηλεφώνου. Δείτε το Αποκτήστε έναν αριθμό τηλεφώνου.
• Ο οργανισμός σας είναι υπεύθυνος να έχει συγκατάθεση για να καλέσει κάθε αριθμό και να τηρεί τους ισχύοντες νόμους περί κλήσεων. Δείτε τους Νόμους για εξερχόμενες κλήσεις.

Παραδείγματα ροών εργασίας#

• Επαφές CRM σε καμπάνια. Προσθέστε επαφές CRM σε μια πρόχειρη καμπάνια ThunderPhone και, στη συνέχεια, ξεκινήστε την καμπάνια μόλις κάποιος εγκρίνει τη λίστα.
• Ολοκληρωμένη κλήση στην εγγραφή πελάτη. Στην ενέργεια Κλήση ολοκληρώθηκε, εκτελέστε Λήψη κλήσης και αποθηκεύστε το απομαγνητοφωνημένο κείμενο και τον σύνδεσμο εγγραφής στην αντίστοιχη εγγραφή πελάτη.
• Χαμηλές βαθμολογίες για έλεγχο. Στην ενέργεια Κλήση βαθμολογήθηκε, φιλτράρετε με βάση το {{ $json.data.grade.score }} και δρομολογήστε κλήσεις με χαμηλή βαθμολογία σε μια ουρά ελέγχου με το αναγνωριστικό κλήσης και τις λεπτομέρειες βαθμολογίας. Μια κλήση μπορεί να βαθμολογηθεί περισσότερες από μία φορές και κάθε ολοκληρωμένη διαδικασία βαθμολόγησης ενεργοποιεί το έναυσμα, επομένως διατηρείτε μόνο το πιο πρόσφατο graded_at για κάθε αναγνωριστικό κλήσης.

Τα απομαγνητοφωνημένα κείμενα, οι περιλήψεις και οι εγγραφές κλήσεων μπορεί να περιέχουν προσωπικές ή πληροφορίες υγείας. Στείλτε τα μόνο σε εφαρμογές που ο οργανισμός σας επιτρέπεται να χρησιμοποιεί για αυτά τα δεδομένα, βάσει BAA όταν εμπλέκονται πληροφορίες υγείας, και διατηρήστε μόνο τα πεδία που χρειάζεστε.