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

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

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

Είναι ένας επαληθευμένος κόμβος κοινότητας, καταχωρισμένος στο
[ThunderPhone στο n8n](https://n8n.io/integrations/thunderphone/).

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

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

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

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

<Steps>
  <Step title="Ανοίξτε την καρτέλα Κλειδιά">
    Στο ThunderPhone, μεταβείτε στις **Οργανισμός → Κλειδιά** και κάντε κλικ στο **Δημιουργία κλειδιού**.
  </Step>
  <Step title="Ονομάστε το">
    Χρησιμοποιήστε ένα όνομα που υποδεικνύει πού βρίσκεται το κλειδί, όπως «n8n».
  </Step>
  <Step title="Αντιγράψτε το τώρα">
    Το πλήρες μυστικό `sk_live_...` εμφανίζεται μία φορά. Αντιγράψτε το προτού κλείσετε το
    παράθυρο διαλόγου.
  </Step>
</Steps>

Μόνο ένας διαχειριστής ή κάτοχος μπορεί να δημιουργήσει το κλειδί και το ThunderPhone αντιμετωπίζει τα αιτήματα
που πραγματοποιούνται με αυτό ως αιτήματα αυτού του ατόμου. Ο ενεργοποιητής και οι λειτουργίες καμπάνιας
απαιτούν από αυτό το άτομο να διατηρεί τον ρόλο διαχειριστή ή κατόχου.
Το [Δημιουργία κλειδιού API διακομιστή](/el/guides/api-keys) καλύπτει την εναλλαγή και την ανάκληση.

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

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

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

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

<Steps>
  <Step title="Προσθήκη του ενεργοποιητή">
    Προσθέστε τον **Ενεργοποιητή ThunderPhone**, επιλέξτε το διαπιστευτήριο API του ThunderPhone και
    ορίστε το **Συμβάν** σε **Η κλήση ολοκληρώθηκε**.
  </Step>
  <Step title="Λήψη της κλήσης">
    Προσθέστε έναν κόμβο **ThunderPhone**. Ορίστε τον **Πόρο** σε **Κλήση**, τη **Λειτουργία**
    σε **Λήψη** και το **Αναγνωριστικό κλήσης** στην έκφραση `{{ $json.data.call_id }}`.
    Η έξοδος είναι η [εγγραφή κλήσης](/api-reference/calls), μαζί με τα `transcripts`
    και `recording_url`, έναν σύνδεσμο περιορισμένης διάρκειας που είναι `null` όταν η κλήση δεν έχει
    εγγραφή.
  </Step>
  <Step title="Προσθήκη γραμμής">
    Προσθέστε έναν κόμβο Google Sheets που προσθέτει μια γραμμή και αντιστοιχίστε τις στήλες που θέλετε
    από την έξοδο Λήψη κλήσης (δείτε τον παρακάτω πίνακα).
  </Step>
  <Step title="Ενεργοποίηση του workflow">
    Αποθηκεύστε και ενεργοποιήστε το. Ο ενεργοποιητής καταχωρίζει το URL παραγωγής του ως τελικό σημείο webhook
    στον οργανισμό σας στο ThunderPhone. Η απενεργοποίηση του workflow
    διαγράφει αυτό το τελικό σημείο.
  </Step>
  <Step title="Δοκιμή">
    Ανοίξτε έναν πράκτορα στο εργαλείο δημιουργίας, κάντε κλικ στο **Μιλήστε** και τερματίστε την κλήση. Οι δοκιμαστικές
    κλήσεις του εργαλείου δημιουργίας παραδίδονται ως `web.complete`, ένα από τα δύο συμβάντα που αντιστοιχούν στο
    Η κλήση ολοκληρώθηκε, ώστε να εκτελείται το workflow και να εμφανίζεται μια γραμμή.
  </Step>
</Steps>

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

| Στήλη | Έκφραση |
|---|---|
| Αναγνωριστικό κλήσης | `{{ $json.call_id }}` |
| Κατεύθυνση | `{{ $json.direction }}` |
| Από | `{{ $json.from_number }}` |
| Προς | `{{ $json.to_number }}` |
| Έναρξη | `{{ $json.start_time }}` |
| Διάρκεια (δευτ.) | `{{ $json.duration_seconds }}` |
| Κατάσταση | `{{ $json.status }}` |
| Αιτία τερματισμού | `{{ $json.end_reason }}` |
| Σύνδεσμος κλήσης | `https://app.thunderphone.com/dashboard/call-history/{{ $json.call_id }}` |

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

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

<Note>
  Το ThunderPhone παραδίδει συμβάντα με `POST` στο **URL
  παραγωγής** του ενεργοποιητή, επομένως η παρουσία n8n σας πρέπει να είναι προσβάσιμη μέσω HTTPS από το διαδίκτυο
  και το workflow πρέπει να είναι ενεργό. Ο ενεργοποιητής επαληθεύει το
  HMAC `X-ThunderPhone-Signature` σε κάθε αίτημα και απαντά με `401` σε
  οτιδήποτε χωρίς υπογραφή ή μη έγκυρο.
</Note>

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

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

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

| Πεδίο | Σημασία |
|---|---|
| Όνομα ή αναγνωριστικό πράκτορα | Ένας αποθηκευμένος πράκτορας. Η αναπτυσσόμενη λίστα εμφανίζει τους πράκτορές σας. |
| Όνομα ή αναγνωριστικό αριθμού τηλεφώνου | Ο αριθμός προέλευσης. Η αναπτυσσόμενη λίστα εμφανίζει μόνο αριθμούς που είναι ενεργοποιημένοι για εξερχόμενες κλήσεις. |
| Αριθμός προορισμού | Ο προορισμός σε μορφή E.164, π.χ. `+14155552671`. |
| Μεταβλητές | Αντικείμενο JSON με τιμές για τα placeholders στην προτροπή του πράκτορα. |
| Κλειδί ιδιοδυναμίας | Ένα σταθερό αναγνωριστικό από την εγγραφή ή το συμβάν ανάντη. Απαιτείται. |

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

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

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

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

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

- Αν το ThunderPhone ζητήσει από τον οργανισμό σας να επιβεβαιώσει ότι οι εξερχόμενες κλήσεις του
  συμμορφώνονται με το TCPA και άλλους νόμους περί κλήσεων, ένας διαχειριστής πρέπει πρώτα να καταγράψει αυτήν την
  επιβεβαίωση στον πίνακα ελέγχου.
- Ο αριθμός προέλευσης πρέπει να είναι ενεργοποιημένος για εξερχόμενες κλήσεις. Οι αριθμοί που φέρνετε από
  τον δικό σας πάροχο πληρούν τις προϋποθέσεις μόλις επαληθευτούν. Οι αριθμοί ThunderPhone αρχικά είναι
  μόνο για εισερχόμενες κλήσεις και μπορούν να εγκριθούν για εξερχόμενη χρήση: ένας διαχειριστής το ζητά
  από τη σελίδα Αριθμοί τηλεφώνου. Δείτε το
  [Αποκτήστε έναν αριθμό τηλεφώνου](/el/guides/get-a-phone-number).
- Ο οργανισμός σας είναι υπεύθυνος να έχει συγκατάθεση για να καλέσει κάθε αριθμό
  και να τηρεί τους ισχύοντες νόμους περί κλήσεων. Δείτε τους
  [Νόμους για εξερχόμενες κλήσεις](/el/guides/outbound-calling-laws).

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

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

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

<Note>
  Στέλνετε τα ίδια συμβάντα κλήσης στον δικό σας διακομιστή; Δείτε τα
  [Τελικά σημεία webhook](/el/webhooks/endpoints).
  Η [Πραγματοποίηση εξερχόμενων κλήσεων](/el/guides/place-outbound-calls) καλύπτει το API πίσω από την
  Πραγματοποίηση εξερχόμενης κλήσης.
</Note>