---
title: "Ενσωματωμένα εργαλεία"
description: "Δώστε οδηγίες στους πράκτορες ThunderPhone να τερματίζουν κλήσεις, να μεταφέρουν καλούντες, να πλοηγούνται σε πληκτρολόγια, να περιμένουν σε αναμονή, να αναζητούν γνώσεις, να αναπαράγουν ήχους και να στέλνουν email."
---

Τα ενσωματωμένα εργαλεία επιτρέπουν σε έναν πράκτορα να εκτελεί συνήθεις ενέργειες κλήσης χωρίς να συνδέσετε το δικό σας API. Τα περισσότερα είναι διαθέσιμα αυτόματα· το email, οι ήχοι και η αναζήτηση γνώσεων εμφανίζονται μόνο αφού διαμορφώσετε τη σχετική ρύθμιση ή πηγή. Πείτε στον πράκτορα πότε να χρησιμοποιεί κάθε ενέργεια στην προτροπή του.

| Εργαλείο | Χρήση για | Τρόπος ενεργοποίησης | Υποστηριζόμενες κλήσεις |
| --- | --- | --- | --- |
| `end_call` | Ολοκλήρωση μιας τελειωμένης συνομιλίας | Πάντα διαθέσιμο | Τηλέφωνο, «Μιλήστε» στο πρόγραμμα περιήγησης, γραφικό στοιχείο, προσομοίωση και Realtime |
| `transfer_call` | Δρομολόγηση ενός τηλεφωνικού καλούντος | Διαμορφώστε τη δρομολόγηση στην προτροπή | Συνήθεις τηλεφωνικές κλήσεις· το ενσωματωμένο Realtime με `call_events` μπορεί να χρησιμοποιεί άμεση μεταφορά. Το Realtime αποθηκευμένου πράκτορα το παραλείπει. |
| `send_keypad_input` | Πάτημα πλήκτρων σε τηλεφωνικό μενού | Πάντα διαθέσιμο σε συνήθεις τηλεφωνικές κλήσεις | Τηλεφωνικές κλήσεις· ενσωματωμένο εξερχόμενο Realtime με `call_events`. Το Realtime αποθηκευμένου πράκτορα το παραλείπει. |
| `no_response` | Συνέχιση ακρόασης ενώ μιλά ένα αυτοματοποιημένο μενού | Πάντα διαθέσιμο | Όλοι οι τύποι κλήσεων |
| `wait_on_hold` | Σιωπηλή αναμονή μέχρι να επιστρέψει ένα άτομο | Περιλαμβάνεται σε εξερχόμενες κλήσεις | Εξερχόμενες τηλεφωνικές κλήσεις και εξερχόμενες ενσωματωμένες συνεδρίες Realtime |
| `search_knowledge_base` | Απάντηση από συνημμένες πηγές | Επισυνάψτε γνώσεις στον πράκτορα | Κλήσεις αποθηκευμένου πράκτορα με συνημμένες γνώσεις |
| `play_sound` | Αναπαραγωγή διαμορφωμένου ήχου ειδοποίησης | **Σύνθετες ρυθμίσεις → Ήχος εργαλείου** | Κλήσεις αποθηκευμένου πράκτορα |
| `send_email` | Αποστολή email σε έναν σταθερό παραλήπτη | **Σύνθετες ρυθμίσεις → Αποστολή email** | Κλήσεις αποθηκευμένου πράκτορα |

## `end_call`

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

Γράψτε στην προτροπή τη συνθήκη και τυχόν απαιτούμενο αποχαιρετισμό:

```text
When the caller confirms they need nothing else, say goodbye and end the call.
```

Μια συνήθης κλήση που τερματίζεται από το μοντέλο έχει `end_reason: "ai_hangup"`. Η διακοπή λόγω διάρκειας ή υπολοίπου μπορεί να χρησιμοποιεί αντί αυτού έναν πιο συγκεκριμένο λόγο τερματισμού.

## `transfer_call`

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

Τοποθετήστε τον αριθμό προορισμού και την ακριβή συνθήκη δρομολόγησης στην προτροπή:

```text
If the caller asks for billing, transfer them to +15551234567.
```

Μια επιτυχημένη άμεση μεταφορά έχει `end_reason: "ai_transfer"`· μια ολοκληρωμένη θερμή παράδοση έχει `end_reason: "ai_warm_transfer"`. Μια αποτυχημένη θερμή προσπάθεια επιστρέφει τον έλεγχο στον πράκτορα, επομένως ο μεταγενέστερος τερματισμός της κλήσης καθορίζει τον λόγο τερματισμού της. Σε συνεδρίες που δεν είναι τηλεφωνικές, ένα αίτημα μεταφοράς τερματίζει τη συνεδρία.

Δείτε [Μεταφορά κλήσεων](/el/guides/call-transfers) για ρύθμιση πίνακα ελέγχου και API, δρομολόγηση, έλεγχο, χειρισμό αποτυχιών, όρια και δοκιμές.

## `send_keypad_input`

Στέλνει ψηφία DTMF (τηλεφωνικού πληκτρολογίου) `0`–`9`, `*` και `#` σε μια τηλεφωνική γραμμή. Το μοντέλο το χρησιμοποιεί για πλοήγηση σε ένα IVR, το αυτοματοποιημένο μενού που ζητά από τους καλούντες να πατήσουν πλήκτρα. Είναι διαθέσιμο από προεπιλογή και δεν έχει ρύθμιση πράκτορα.

Πείτε στο μοντέλο σε ποια μενού μπορεί να πλοηγείται και από πού προέρχονται οι ζητούμενες τιμές. Μην του ζητάτε να μαντεύει επιλογές μενού:

```text
Follow the phone menu for account status. Press a key only after the menu
states what that key does. Enter the account number supplied by the caller.
```

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

## `no_response`

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

Συνήθως αρκεί η ενσωματωμένη περιγραφή. Για κλήσεις με εκτεταμένη χρήση IVR, ενισχύστε το όριο στην προτροπή:

```text
Stay silent while a phone menu is still speaking. Answer a live person as soon
as they address you.
```

Αυτή η ενέργεια δεν τερματίζει την κλήση.

## `wait_on_hold`

Θέτει έναν εξερχόμενο πράκτορα σε κατάσταση σιωπηρής αναμονής μέχρι να επιστρέψει ένα πραγματικό άτομο.
Το μοντέλο το χρησιμοποιεί μόνο αφού το άλλο μέρος δηλώσει ρητά ότι θέτει τον πράκτορα
σε αναμονή. Είναι αυτόματα διαθέσιμο σε εξερχόμενες κλήσεις και δεν διαθέτει
ρύθμιση στον πίνακα ελέγχου.

```text
If a person explicitly puts you on hold, wait silently. When they return,
continue from the question you were discussing.
```

Μην προτρέπετε τον πράκτορα να το χρησιμοποιεί για το μήνυμα «παρακαλώ περιμένετε» ενός IVR. Η αναμονή διαρκεί
έως 15 λεπτά από προεπιλογή. Για συνήθεις εξερχόμενες κλήσεις, το `POST /v1/call`
δέχεται ένα θετικό ακέραιο `max_hold_seconds`; το ενσωματωμένο Realtime περιορίζει το
`max_hold_seconds` σε 10–900 δευτερόλεπτα. Αν το άτομο
επιστρέψει, ο πράκτορας συνεχίζει χωρίς να αλλάξει η αιτία τερματισμού της κλήσης. Αν το όριο
λήξει, η πλατφόρμα τερματίζει την κλήση με `end_reason: "ai_hangup"`.

## `search_knowledge_base`

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

```text
Search the knowledge base before answering policy questions. If the first
search is inconclusive, try once more with different key terms.
```

Αν μια αναζήτηση αποτύχει, το αποτέλεσμα επιστρέφεται στον πράκτορα. Ανατρέξτε στη [Βάση
γνώσεων](/el/guides/knowledge-base) για ρύθμιση στον πίνακα ελέγχου και μέσω API.

## `play_sound`

Αναπαράγει τον διαμορφωμένο ήχο ειδοποίησης του πράκτορα μετά από οποιαδήποτε ομιλία στον ίδιο
γύρο. Στον πίνακα ελέγχου, ορίστε **Για προχωρημένους → Ήχος εργαλείου** σε **Κουδουνάκι**, **Ντινγκ**,
ή **Μπιπ** και, στη συνέχεια, αναπτύξτε τον πράκτορα. Η επιλογή **Κανένα** καταργεί το εργαλείο.

Με το [Agents API](/api-reference/agents), ορίστε προσωρινά το `play_sound_asset` ως
`"chime"`, `"ding"` ή `"beep"` και, στη συνέχεια, αναπτύξτε. Ορίστε το σε `""` για να απενεργοποιήσετε
το εργαλείο.

```text
After confirming that an appointment was saved, say "You're all set" and play
the notification sound.
```

Μια αποτυχία αναπαραγωγής επιστρέφεται στον πράκτορα και δεν τερματίζει την κλήση.

## `send_email`

Στέλνει ένα email απλού κειμένου στον έναν παραλήπτη που έχει διαμορφώσει ο κάτοχος του πράκτορα.
Το μοντέλο παρέχει το θέμα και το σώμα. Δεν βλέπει ποτέ παράμετρο παραλήπτη
και δεν μπορεί να επιλέξει ή να αλλάξει τη διεύθυνση.

Στον πίνακα ελέγχου, ενεργοποιήστε **Για προχωρημένους → Αποστολή email**, αποθηκεύστε μια διεύθυνση παραλήπτη
και, στη συνέχεια, αναπτύξτε τον πράκτορα. Με το [Agents API](/api-reference/agents), ορίστε προσωρινά και τα δύο
`send_email_enabled: true` και ένα μη κενό `send_email_recipient` και, στη συνέχεια, αναπτύξτε.
Ορίστε το έναυσμα και το απαιτούμενο περιεχόμενο στην προτροπή:

```text
When the caller asks to leave a message, collect their name, callback number,
and message. Read the details back for confirmation, then email them.
```

Μια κλήση μπορεί να επιχειρήσει έως τρία email. Κάθε θέμα περιορίζεται σε 300
χαρακτήρες και κάθε σώμα σε 20.000 χαρακτήρες. Ελλιπής διαμόρφωση, μη έγκυρο
περιεχόμενο, το όριο ανά κλήση και αποτυχίες παράδοσης επιστρέφονται στον πράκτορα.
Μια αποτυχημένη παράδοση εξακολουθεί να χρησιμοποιεί μία από τις τρεις προσπάθειες.

Δοκιμάστε με ελεγχόμενο παραλήπτη πριν από ευρεία ανάπτυξη. Η λειτουργία «Μιλήστε» στο πρόγραμμα περιήγησης και
οι προσομοιώσεις στέλνουν πραγματικά email· δεν υπάρχει λειτουργία δοκιμαστικής εκτέλεσης.

## Σημείωση συμβατότητας

Η ρύθμιση **Για προχωρημένους → Μη διακόψιμες γνωστοποιήσεις** και το παλαιό
πεδίο `speak_uninterruptible_enabled` παραμένουν για συμβατότητα, αλλά η ενεργοποίησή
τους δεν έχει αποτέλεσμα. Αφήστε τη ρύθμιση απενεργοποιημένη· καμία προτροπή δεν μπορεί να ενεργοποιήσει αυτό το εργαλείο.

Για υποχρεωτική γνωστοποίηση στην αρχή της κλήσης, χρησιμοποιήστε την **Ανακοίνωση συναίνεσης**. Αναπαράγεται
αυτολεξεί πριν από τη συνήθη συνομιλία και δεν μπορεί να διακοπεί. Ανατρέξτε στους [Νόμους συναίνεσης για
την καταγραφή κλήσεων](/el/guides/recording-consent-laws).

## Δοκιμή και παρακολούθηση ενσωματωμένων εργαλείων

Χρησιμοποιήστε τη λειτουργία «Μιλήστε» στο πρόγραμμα περιήγησης ή μια προσομοίωση για να ελέγξετε προτροπές, αναζήτηση γνώσεων, ήχους
και email. Αυτά τα περιβάλλοντα δεν μπορούν να αναπαραγάγουν τη συμπεριφορά του τηλεφωνικού δικτύου. Δοκιμάστε
την πλοήγηση με πληκτρολόγιο και την αναμονή σε μια εξερχόμενη τηλεφωνική κλήση και δοκιμάστε μια πλήρη θερμή
μεταβίβαση σε πραγματική κλήση χρησιμοποιώντας έναν επιλέξιμο εισαγόμενο αριθμό VoIP. Η υποστήριξη Realtime
είναι περιορισμένη, όπως εμφανίζεται στον παραπάνω πίνακα.

## Κλήσεις, τιμολόγηση και webhook

Οι ενσωματωμένες ενέργειες δεν έχουν χρέωση εργαλείου ανά χρήση. Εξακολουθούν
να ισχύουν οι κανονικές χρεώσεις κλήσεων και παρόχου· δείτε την [Τιμολόγηση](/el/guides/pricing). Οι κλήσεις και τα αποτελέσματά τους μπορεί
να εμφανίζονται στην ολοκληρωμένη απομαγνητοφώνηση, αλλά δεν εκπέμπουν `telephony.tool` ή `web.tool`.
Αυτά τα συμβάντα προορίζονται για [συναρτήσεις που ορίζονται από τον χρήστη](/el/tools/overview). Μόνο ένας ολοκληρωμένος
τερματισμός ή μια ολοκληρωμένη προώθηση αλλάζει το `end_reason` της κλήσης· οι υπόλοιπες αποτυχίες επιστρέφονται
στον πράκτορα. Δείτε τα [Webhook ολοκλήρωσης κλήσης](/el/webhooks/call-complete) για την εγγραφή
της κλήσης.