Open in
Κατάλογος συμβάντων
Όλοι οι τύποι συμβάντων webhook που εκπέμπει το ThunderPhone.
Κάθε σώμα webhook διαθέτει ένα πεδίο type του οποίου η τιμή είναι ένας από τους τύπους συμβάντων αυτής της σελίδας. Όταν εγγράφεστε σε ένα
τελικό σημείο, ο πίνακας events πρέπει να περιέχει τους
τύπους συμβάντων που θέλετε (ή να είναι κενός για εγγραφή σε όλα —
εκτός από τα συμβάντα ανά γύρο telephony.turn /
web.turn και το συμβάν προόδου σε πραγματικό χρόνο
call.status_changed, τα οποία παραδίδονται μόνο
σε τελικά σημεία που τα ονομάζουν ρητά).
Δύο τρόποι παράδοσης μεταφέρουν αυτά τα συμβάντα:
- Οι παραδόσεις endpoint είναι πάντα ειδοποιήσεις χωρίς αποκλεισμό
με επαναλήψεις: απαντήστε με
οποιοδήποτε 2xx· ο φάκελος περιλαμβάνει ένα
event_idγια αποδιπλοποίηση. - Οι αποκλειστικές ανταλλαγές εκτελούνται μόνο στο
παλαιού τύπου webhook ενός URL: το αίτημα
διαμόρφωσης
telephony.incoming/web.incoming(αριθμοί σε λειτουργία webhook: 13 δευτ. συμπεριλαμβανομένης μίας επανάληψης· κλειδιά widget σε λειτουργία webhook: 10 δευτ.) και η αποστολή εργαλείων σε λειτουργία webhook. Η απάντησή σας διαμορφώνει τη ζωντανή κλήση.
Τα παρακάτω παραδείγματα payload δείχνουν το περιτύλιγμα endpoint με τη σειρά
μεταφοράς του (κλειδιά ταξινομημένα αλφαβητικά: data, event_id, type)·
οι παραδόσεις παλαιού τύπου μεταφέρουν το ίδιο data χωρίς event_id.
Συμβάντα κλήσεων
telephony.incoming
Αποστέλλεται όταν μια εισερχόμενη κλήση φτάνει σε έναν από τους
αριθμούς τηλεφώνου σας. Οι παραδόσεις σε endpoint είναι
ειδοποιήσεις τύπου fire-and-forget που αποστέλλονται για κάθε εισερχόμενη κλήση, ανεξάρτητα από το αν
ο αριθμός έχει ρυθμιστεί με πράκτορα ή με webhook. Οι αριθμοί χωρίς
εκχωρημένο πράκτορα λαμβάνουν επιπλέον το αίτημα ρύθμισης αποκλεισμού
στο παλαιού τύπου webhook — ανατρέξτε στο
telephony.incoming / web.incoming για
το πλήρες σχήμα αιτήματος / απόκρισης.
{
"data": {
"call_id": 987654321,
"from_number": "+14155550199",
"to_number": "+15551234567"
},
"event_id": "3f6b2ad0-1c9e-4a57-9f2b-8f6f0f9d2f11",
"type": "telephony.incoming"
}| Πεδίο | Τύπος | Περιγραφή |
|---|---|---|
agent_id | ακέραιος | null | Πράκτορας που χειρίστηκε την κλήση, όταν είχε ανατεθεί κάποιος |
agent_name | συμβολοσειρά | null | Πράκτορας που χειρίστηκε την κλήση, όταν είχε ανατεθεί κάποιος |
returning_call | αντικείμενο | Υπάρχει μόνο όταν ο αριθμός κάλεσε αυτόν τον καλούντα τις τελευταίες 30 ημέρες: τα call_id, agent_id, started_at και outcome της προηγούμενης κλήσης. Δείτε Επανακλήσεις |
sip_headers | αντικείμενο | Υπάρχει μόνο όταν η κλήση έφτασε με κεφαλίδες SIP X-* ή User-to-User (διευθύνσεις SIP και μη αυτόματες συνδέσεις SIP): όνομα κεφαλίδας με πεζά γράμματα → τιμή. Δείτε Κεφαλίδες SIP |
telephony.complete
Αποστέλλεται όταν τερματίζεται μια εισερχόμενη ή εξερχόμενη τηλεφωνική κλήση. Δεν προκαλεί αποκλεισμό.
Περιλαμβάνει την απομαγνητοφώνηση, το URL εγγραφής όταν είναι διαθέσιμο και τη σύνοψη χρέωσης. Ανατρέξτε στο
telephony.complete / web.complete για
το σχήμα ωφέλιμου φορτίου.
| Πεδίο | Τύπος | Περιγραφή |
|---|---|---|
agent_id | integer | null | Πράκτορας που χειρίστηκε την κλήση, όταν είχε εκχωρηθεί |
agent_name | string | null | Πράκτορας που χειρίστηκε την κλήση, όταν είχε εκχωρηθεί |
telephony.tool
Αποστέλλεται αφού μια τηλεφωνική κλήση καλέσει ένα
εργαλείο συνάρτησης. Ειδοποίηση ελέγχου χωρίς αποκλεισμό —
το εργαλείο έχει ήδη εκτελεστεί όταν παραδίδεται αυτό το συμβάν· καλύπτει
τα δικά σας εργαλεία συναρτήσεων και το ενσωματωμένο εργαλείο send_sms (όχι άλλα ενσωματωμένα
εργαλεία, εργαλεία βάσης γνώσεων, συνδέσεων εφαρμογών ή MCP). Για το send_sms,
τα arguments.to και arguments.body είναι [REDACTED]. Οι απομαγνητοφωνήσεις
ολοκλήρωσης επίσης τα αποκρύπτουν· ανακτήστε το περιεχόμενο και τον παραλήπτη από τον
πόρο SMS στο επίπεδο οργανισμού χρησιμοποιώντας το message_id της απόκρισης.
{
"data": {
"arguments": { "date": "2026-04-21" },
"call_id": 987654321,
"from_number": "+14155550199",
"response": {
"response": { "available_slots": ["9:00 AM", "2:00 PM"] },
"status": 200
},
"to_number": "+15551234567",
"tool_name": "search_appointments"
},
"event_id": "1f0a7c3e-52d4-4a0e-8f4b-b1a6a1c0d9e2",
"type": "telephony.tool"
}Το response είναι το εκτελεσμένο αποτέλεσμα: {"status": <http status>, "response": <your endpoint's JSON>} σε επιτυχία ή
{"status": <status>, "error": "<message>"} σε αποτυχία.
| Πεδίο | Τύπος | Περιγραφή |
|---|---|---|
agent_id | integer | null | Πράκτορας που χειρίστηκε την κλήση, όταν είχε εκχωρηθεί |
agent_name | string | null | Πράκτορας που χειρίστηκε την κλήση, όταν είχε εκχωρηθεί |
telephony.turn
Αποστέλλεται ενώ μια τηλεφωνική κλήση βρίσκεται σε εξέλιξη, μία φορά για κάθε
σειρά ομιλίας που περιέχει φωνή καθώς συμβαίνει — τις προφορικές ολοκληρώσεις του
πράκτορα και τις απομαγνητοφωνημένες σειρές του καλούντος. Σας επιτρέπει να παρακολουθείτε τη ζωντανή συνομιλία
μέσω απλών webhooks αντί να κάνετε polling στο
GET /v1/calls/{call_id}/transcript.
Δεν προκαλεί αποκλεισμό.
{
"data": {
"call_id": 987654321,
"entry_type": "completion",
"from_number": "+14155550199",
"position": 7,
"role": "assistant",
"start_ms": 15200,
"text": "How many employees does your company have?",
"to_number": "+15551234567"
},
"event_id": "8d3f5a2c-7b1e-4c9a-b6d0-2e4f6a8c0d1e",
"type": "telephony.turn"
}| Πεδίο | Τύπος | Περιγραφή |
|---|---|---|
agent_id | integer | null | Πράκτορας που χειρίστηκε την κλήση, όταν είχε εκχωρηθεί |
agent_name | string | null | Πράκτορας που χειρίστηκε την κλήση, όταν είχε εκχωρηθεί |
position | integer | Ο δείκτης της σειράς στο ιστορικό κλήσης — σταθερό αναγνωριστικό για ταξινόμηση |
role | string | assistant (ομιλία πράκτορα) ή user (ομιλία καλούντος) |
text | string | Το κείμενο απομαγνητοφώνησης της σειράς όπως είναι γνωστό κατά τον χρόνο εκπομπής |
entry_type | string | Ο υποκείμενος τύπος καταχώρισης ιστορικού: completion (πράκτορας) ή user_turn / span (καλών) |
start_ms, end_ms | integer | Μετατοπίσεις ήχου σε ms από την έναρξη της κλήσης· υπάρχουν μόνο όταν ο χρονισμός αναπαραγωγής ήταν ήδη γνωστός κατά τον χρόνο εκπομπής |
web.incoming
Το ισοδύναμο του telephony.incoming για το κανάλι web, το οποίο αποστέλλεται όταν ξεκινά μια συνεδρία
widget web ή μια δοκιμαστική κλήση μικροφώνου στον δημιουργό. Οι παραδόσεις σε endpoint είναι
fire-and-forget για κάθε συνεδρία web. Τα δημοσιεύσιμα κλειδιά σε mode="webhook" λαμβάνουν επιπλέον
το αίτημα ρύθμισης αποκλεισμού στο παλαιού τύπου webhook — αυτό το αίτημα
αποκλεισμού έχει διαφορετική μορφή (origin_domain,
publishable_key_prefix· χωρίς αριθμούς τηλεφώνου). Ανατρέξτε στο
telephony.incoming / web.incoming.
{
"data": {
"call_id": 987654322,
"from_number": "web",
"origin_domain": "https://example.com",
"publishable_key_prefix": "pk_live_a1b2",
"to_number": "+15551234567"
},
"event_id": "9a2b4c6d-8e0f-4a1b-9c2d-3e4f5a6b7c8d",
"type": "web.incoming"
}Το from_number είναι πάντα το κυριολεκτικό "web". Για συνεδρίες widget σε λειτουργία webhook,
το to_number είναι κενό (ο αριθμός πράκτορα της συνεδρίας εκχωρείται
μετά τη ρύθμιση)· για δοκιμαστικές κλήσεις μικροφώνου στον δημιουργό, τα origin_domain και
publishable_key_prefix είναι κενά.
| Πεδίο | Τύπος | Περιγραφή |
|---|---|---|
agent_id | integer | null | Πράκτορας που χειρίστηκε την κλήση, όταν είχε εκχωρηθεί |
agent_name | string | null | Πράκτορας που χειρίστηκε την κλήση, όταν είχε εκχωρηθεί |
web.complete
Το ισοδύναμο του telephony.complete για το κανάλι web, που καλύπτει κλήσεις
widget web (direction: "web") και δοκιμαστικές κλήσεις μικροφώνου στον δημιουργό
(direction: "test"). Δεν προκαλεί αποκλεισμό. Ίδια μορφή ωφέλιμου φορτίου με το
telephony.complete, συν το origin_domain,
με το from_number ορισμένο σε "web".
| Πεδίο | Τύπος | Περιγραφή |
|---|---|---|
agent_id | integer | null | Πράκτορας που χειρίστηκε την κλήση, όταν είχε εκχωρηθεί |
agent_name | string | null | Πράκτορας που χειρίστηκε την κλήση, όταν είχε εκχωρηθεί |
web.tool
Το ισοδύναμο του telephony.tool για το κανάλι web. Το data περιέχει
origin_domain αντί για from_number / to_number.
| Πεδίο | Τύπος | Περιγραφή |
|---|---|---|
agent_id | integer | null | Πράκτορας που χειρίστηκε την κλήση, όταν είχε εκχωρηθεί |
agent_name | string | null | Πράκτορας που χειρίστηκε την κλήση, όταν είχε εκχωρηθεί |
web.turn
Το ισοδύναμο του telephony.turn για το κανάλι web,
που καλύπτει κλήσεις widget web και δοκιμαστικές κλήσεις μικροφώνου στον δημιουργό. Ίδια μορφή
ωφέλιμου φορτίου, με origin_domain αντί για from_number / to_number.
Όπως το telephony.turn, απαιτεί ρητή εγγραφή — δεν
παραδίδεται ποτέ μέσω κενού πίνακα events.
| Πεδίο | Τύπος | Περιγραφή |
|---|---|---|
agent_id | integer | null | Πράκτορας που χειρίστηκε την κλήση, όταν είχε εκχωρηθεί |
agent_name | string | null | Πράκτορας που χειρίστηκε την κλήση, όταν είχε εκχωρηθεί |
call.transfer_completed
Αποστέλλεται μία φορά ανά κλήση με το τελικό αποτέλεσμα μιας
μεταφοράς κλήσης: μιας ψυχρής μεταφοράς ή της
γέφυρας μεταξύ των δύο ατόμων που αφήνει πίσω της μια θερμή μεταφορά μετά την αποχώρηση του πράκτορα.
Δεν είναι αποκλειστικό και παραδίδεται μόνο σε τελικά σημεία (ποτέ στο παλαιό
webhook ενός URL). Φτάνει μετά το telephony.complete της κλήσης:
όταν ο πάροχος αναλαμβάνει την κλήση ή η μεταφορά αποτυγχάνει ή, όταν το
ThunderPhone έχει γεφυρώσει την κλήση, όταν η γέφυρα τερματίζεται.
{
"data": {
"agent_id": 12,
"agent_name": "Front desk",
"bridge_kind": "cold_fallback",
"bridge_seconds": 255,
"bridge_total_cents": 5,
"call_id": 987654321,
"destination": "+15555550102",
"sip_status": 403,
"transfer_outcome": "bridged"
},
"event_id": "5b0f6c1e-9d2a-5e7b-8c4d-1a2b3c4d5e6f",
"type": "call.transfer_completed"
}| Πεδίο | Τύπος | Περιγραφή |
|---|---|---|
call_id | ακέραιος | Η κλήση που μεταφέρθηκε |
agent_id | ακέραιος | null | Ο πράκτορας που χειρίστηκε την κλήση, όταν είχε ανατεθεί |
agent_name | συμβολοσειρά | null | Ο πράκτορας που χειρίστηκε την κλήση, όταν είχε ανατεθεί |
transfer_outcome | συμβολοσειρά | refer_accepted: ο πάροχος ανέλαβε την κλήση. bridged: το ThunderPhone διατήρησε συνδεδεμένους τον καλούντα και τον προορισμό, είτε επειδή ο πάροχος απέρριψε μια ψυχρή μεταφορά είτε επειδή ο πράκτορας μιας θερμής μεταφοράς αποχώρησε. bridge_unanswered: ο πάροχος απέρριψε μια ψυχρή μεταφορά και ο προορισμός δεν απάντησε στην κλήση που πραγματοποίησε το ThunderPhone. failed: η μεταφορά δεν ολοκληρώθηκε και η κλήση τερματίστηκε |
destination | συμβολοσειρά | null | Ο αριθμός στον οποίο μεταφέρθηκε η κλήση |
sip_status | ακέραιος | null | Η κατάσταση SIP του παρόχου όταν απέρριψε την ψυχρή μεταφορά: 403 (για παράδειγμα, ένας κορμός Twilio χωρίς μεταφορά κλήσης), 405 ή 501. null όταν ο πάροχος δεν την απέρριψε |
bridge_kind | συμβολοσειρά | null | Μόνο για bridged: cold_fallback (μια ψυχρή μεταφορά που απορρίφθηκε και συνέδεσε το ThunderPhone) ή warm (τα δύο άτομα μιας θερμής μεταφοράς μετά την αποχώρηση του πράκτορα) |
bridge_seconds | ακέραιος | null | Μόνο για bridged: ο χρόνος γέφυρας που χρέωσε το ThunderPhone, σε δευτερόλεπτα |
bridge_total_cents | ακέραιος | null | Μόνο για bridged: το κόστος της γέφυρας σε σεντ USD μετά από τυχόν δωρεάν πίστωση κλήσης, το οποίο χρεώνεται χωριστά από το billing_total_cents της κλήσης |
Οι ίδιες τιμές βρίσκονται στο αντικείμενο κλήσης
ως transfer_outcome, transfer_destination, transfer_sip_status,
transfer_bridge_kind, transfer_bridge_seconds και
transfer_bridge_total_cents. Το event_id είναι το ίδιο σε κάθε παράδοση
για μια κλήση, επομένως μια επαναλαμβανόμενη αναφορά δεν παράγει δεύτερο συμβάν.
call.billed
Αποστέλλεται για μια κλήση που χρεώνεται βάσει μετρημένης χρήσης: όταν οριστικοποιείται η χρέωσή της, λίγα
λεπτά μετά το τέλος της κλήσης μόλις καταχωριστεί η χρήση της, και ξανά κάθε φορά που
χρήση που έφτασε αργότερα αυξάνει τη χρέωση. Το συμβάν
telephony.complete / web.complete της κλήσης
περιέχει billing_pending: true και πεδία χρέωσης null. Δεν μπλοκάρει
και παραδίδεται μόνο σε τερματικά (ποτέ στο παλαιό webhook ενός URL).
Οι κλήσεις που χρεώνονται όταν ολοκληρώνονται περιλαμβάνουν τη χρέωσή τους στο συμβάν ολοκλήρωσης
και δεν λαμβάνουν call.billed.
Η σειρά δεν είναι εγγυημένη: η χρέωση συνήθως περιμένει το συμβάν ολοκλήρωσης,
αλλά το call.billed μπορεί να φτάσει πριν από αυτό (ένα συμβάν ολοκλήρωσης που καθυστέρησε
για μία ώρα ή παραδόσεις που επαναλήφθηκαν σε διαφορετικές χρονικές στιγμές), και δύο
συμβάντα call.billed μπορούν να φτάσουν εκτός σειράς. Διατηρήστε το συμβάν με το
υψηλότερο billing_seq για κάθε call_id.
{
"data": {
"adjustment_cents": null,
"agent_id": 12,
"agent_name": "Front desk",
"billable_minutes": 3.0,
"billing_seq": 1,
"billing_total_cents": 10,
"call_id": 987654321,
"reason": "settled"
},
"event_id": "7c1d2e3f-4a5b-5c6d-8e7f-9a0b1c2d3e4f",
"type": "call.billed"
}| Πεδίο | Τύπος | Περιγραφή |
|---|---|---|
call_id | integer | Η κλήση που χρεώθηκε |
agent_id | integer | null | Ο πράκτορας που διαχειρίστηκε την κλήση, όταν είχε ανατεθεί κάποιος |
agent_name | string | null | Ο πράκτορας που διαχειρίστηκε την κλήση, όταν είχε ανατεθεί κάποιος |
reason | string | settled: η χρέωση της κλήσης. adjusted: χρήση που έφτασε μετά τη χρέωση και την αύξησε (μια χρέωση δεν μειώνεται ποτέ) |
billing_seq | integer | 1 για τη χρέωση και έπειτα 2, 3, ... για κάθε αύξηση. Η υψηλότερη τιμή που λήφθηκε είναι η τρέχουσα χρέωση της κλήσης |
billable_minutes | number | Τα λεπτά που χρεώθηκαν, στρογγυλοποιημένα στο πλησιέστερο τέταρτο του λεπτού |
billing_total_cents | integer | Όλα όσα έχουν χρεωθεί μέχρι τώρα για την κλήση σε σεντ USD, μετά από τυχόν δωρεάν πίστωση κλήσεων, συμπεριλαμβανομένων των αυξήσεων adjusted |
adjustment_cents | integer | null | Μόνο για adjusted: αυτή η αύξηση σε σεντ USD, μετά από τυχόν δωρεάν πίστωση κλήσεων |
Τα ίδια σύνολα βρίσκονται στο αντικείμενο κλήσης
ως billable_minutes και billing_total_cents. Το event_id είναι το ίδιο σε
κάθε παράδοση ενός billing_seq, επομένως μια επαναλαμβανόμενη αναφορά δεν δημιουργεί
δεύτερο συμβάν.
call.status_changed
Στέλνεται ενώ μια κλήση είναι σε εξέλιξη, κάθε φορά που φτάνει σε νέο στάδιο: το ThunderPhone ξεκινά την κλήση, το άτομο ή το τηλέφωνό του απαντά, ο πράκτορας φτάνει στον τηλεφωνητή ή ο πράκτορας τίθεται σε αναμονή και επανέρχεται από αυτήν. Χρησιμοποιήστε το για να εμφανίζετε την πρόοδο μιας ενεργής κλήσης, για παράδειγμα «Κλήση…», «Απαντήθηκε», «Σε αναμονή» και «Εκτός αναμονής μετά από 4 λεπτά» σε ένα νήμα συνομιλίας που παρακολουθεί την κλήση. Δεν αποκλείει άλλες ενέργειες και παραδίδεται μόνο σε τελικά σημεία (ποτέ στο παλαιό webhook με ένα μόνο URL).
{
"data": {
"agent_id": 12,
"agent_name": "Front desk",
"call_id": 987654321,
"direction": "outbound",
"hold_seconds": 240,
"occurred_at": "2026-11-07T17:04:12.418Z",
"status": "off_hold"
},
"event_id": "2f6a1c9e-3b7d-5e8f-9a0b-4c5d6e7f8a9b",
"type": "call.status_changed"
}| Πεδίο | Τύπος | Περιγραφή |
|---|---|---|
call_id | integer | Η κλήση |
agent_id | integer | null | Ο πράκτορας που χειρίστηκε την κλήση, όταν είχε ανατεθεί |
agent_name | string | null | Ο πράκτορας που χειρίστηκε την κλήση, όταν είχε ανατεθεί |
direction | string | Η κατεύθυνση της κλήσης, όπως στο αντικείμενο κλήσης |
status | string | Το στάδιο στο οποίο έφτασε η κλήση· δείτε τον παρακάτω πίνακα |
occurred_at | timestamp | Πότε συνέβη |
hold_seconds | integer | null | Μόνο για off_hold: πόσο διήρκεσε η αναμονή, σε δευτερόλεπτα. null για κάθε άλλη κατάσταση |
status | Πότε στέλνεται |
|---|---|
dialing | Εξερχόμενες κλήσεις: το ThunderPhone πραγματοποιεί την κλήση. Στέλνεται αμέσως πριν η κλήση προωθηθεί στον πάροχο, αφού ολοκληρωθεί κάθε έλεγχος που θα μπορούσε να απορρίψει την κλήση. Οι δοκιμαστικές κλήσεις που ξεκινούν από τον πίνακα ελέγχου δεν το στέλνουν |
answered | Εξερχόμενες κλήσεις: ο πάροχος ανέφερε ότι η κλήση απαντήθηκε. Η απάντηση από γραμματοκιβώτιο τηλεφωνητή ή σύστημα φιλτραρίσματος κλήσεων μετρά επίσης, επομένως μπορεί να ακολουθήσει voicemail. Όταν το ThunderPhone μαθαίνει για την απάντηση μόνο από την αναφορά τέλους κλήσης, το answered στέλνεται καθώς η κλήση ολοκληρώνεται |
voicemail | Εξερχόμενες κλήσεις: ο πράκτορας έφτασε σε γραμματοκιβώτιο τηλεφωνητή και αφήνει μήνυμα ή τερματίζει την κλήση, όπως ορίζει το voicemail_action του πράκτορα. Στέλνεται όταν επιβεβαιωθεί το γραμματοκιβώτιο (από τον χαρακτηριστικό ήχο του ή από απουσία απάντησης), όχι με την πρώτη εκτίμηση |
on_hold | Ο πράκτορας τέθηκε σε αναμονή και περιμένει σιωπηλά (το εργαλείο wait_on_hold) |
off_hold | Ένα άτομο επέστρεψε στη γραμμή και ο πράκτορας μιλά ξανά. Το hold_seconds δηλώνει πόσο διήρκεσε η αναμονή |
Κάθε κλήση στέλνει κάθε κατάσταση το πολύ μία φορά, εκτός από τις on_hold και off_hold,
οι οποίες στέλνονται μία φορά για κάθε αναμονή. Μια τυπική εξερχόμενη κλήση που περιμένει σε αναμονή
στέλνει dialing, answered, on_hold, off_hold και έπειτα
telephony.complete όταν ολοκληρωθεί.
Η κλήση δεν αναφέρεται ως κουδούνισμα: το αν ένας πάροχος σηματοδοτεί κουδούνισμα διαφέρει υπερβολικά ώστε να είναι αξιόπιστο. Στις λίγες κλήσεις με voicemail_action: "prompt" όπου η προτροπή του πράκτορα, αντί του ThunderPhone, αποφασίζει τι θα γίνει σε ένα γραμματοκιβώτιο φωνητικών μηνυμάτων, δεν αποστέλλεται κατάσταση voicemail; το answered_by στο telephony.complete εξακολουθεί να αναφέρει voicemail. Τα φορτία δεν περιέχουν απομαγνητοφώνηση, αριθμούς τηλεφώνου ή μεταβλητές, επομένως το call.status_changed αποστέλλεται ακόμη και για κλήσεις των οποίων η εγγραφή είναι απενεργοποιημένη.
Συμβάντα SMS
Τα συμβάντα SMS περιγράφουν μηνύματα που αποστέλλονται μέσω του συνδεδεμένου
λογαριασμού Twilio ή Telnyx του οργανισμού. Το σώμα του μηνύματος παραλείπεται και το to αποκρύπτεται.
Ανακτήστε το μήνυμα στο εύρος του οργανισμού από το
GET /v1/sms/{message_id} όταν χρειάζεστε το
περιεχόμενο ή τον παραλήπτη του. Το source είναι api, agent_tool, followup
ή pre_call (το κείμενο μιας καμπάνιας πριν από την κλήση), όπως στο
αντικείμενο μηνύματος.
Κάθε συμβάν SMS περιλαμβάνει το scheduled_send_id: το αναγνωριστικό της
προγραμματισμένης αποστολής για την οποία στάλθηκε το μήνυμα ή
null για ένα μήνυμα που δεν ήταν προγραμματισμένο. Τα προγραμματισμένα μηνύματα έχουν source
"scheduled".
sms.sent
Αποστέλλεται όταν ο πάροχος κινητής τηλεφωνίας του πελάτη αποδέχεται ένα αίτημα εξερχόμενου SMS. Αυτό δεν είναι απόδειξη παράδοσης στη συσκευή.
{
"data": {
"accepted_at": "2026-09-19T15:42:10.113Z",
"agent_id": 12,
"call_id": 987654321,
"created_at": "2026-09-19T15:42:09.901Z",
"direction": "outbound",
"error_code": null,
"error_message": null,
"from_number": "+15551234567",
"id": "313a3117-827b-46e9-a01a-ac1493838724",
"provider": "twilio",
"provider_id": "SM0123456789abcdef0123456789abcdef",
"scheduled_send_id": null,
"segment_count": 1,
"source": "agent_tool",
"status": "accepted",
"to": "[REDACTED]"
},
"event_id": "0ae347b4-1716-45bb-9a0e-b52373586e37",
"type": "sms.sent"
}sms.failed
Αποστέλλεται μετά από μόνιμη απόρριψη από τον πάροχο, αφού εξαντληθούν οι
προσωρινές επαναλήψεις, όταν το αποτέλεσμα είναι οριστικά άγνωστο ή όταν το Twilio αναφέρει ένα
αποδεκτό μήνυμα ως μη παραδοθέν ή αποτυχημένο. Στην τελευταία περίπτωση, το
sms.sent του μηνύματος είχε ήδη αποσταλεί και το status παραμένει "accepted". Το error_code είναι ένας σταθερός
κωδικός ThunderPhone και το error_message αναφέρει την ενέργεια που πρέπει να κάνει ο πελάτης, όταν αυτή είναι
διαθέσιμη. Το status: "unknown" σημαίνει ότι ο πάροχος ενδέχεται να έχει αποδεχτεί το SMS·
συμφωνήστε το με το αρχείο καταγραφής του παρόχου, επειδή το ThunderPhone δεν θα το στείλει ξανά
αυτόματα.
sms.received
Δεσμεύεται για υποστήριξη εισερχόμενων SMS. Δεν εκπέμπονται συμβάντα sms.received στην
τρέχουσα έκδοση. Η διαμόρφωση webhook εισερχόμενων μηνυμάτων από τον πάροχο και η επαλήθευση
υπογραφής θα διατεθούν ξεχωριστά.
Προγραμματισμένα συμβάντα
Οι προγραμματισμένες αποστολές που δεν πραγματοποιούνται εκπέμπουν ένα
από αυτά τα συμβάντα. Μια αποστολή που πραγματοποιείται εκπέμπει αντί γι’ αυτά τα συνήθη συμβάντα:
τα συμβάντα sms.* με ορισμένο το scheduled_send_id για ένα μήνυμα κειμένου, τα συμβάντα κλήσης για μια
κλήση, με scheduled_send_id στο telephony.complete της. Και τα δύο δεν αποκλείουν την εκτέλεση. Όταν η αποστολή έχει έναν πράκτορα,
τα τελικά σημεία με εμβέλεια αυτού του πράκτορα τα λαμβάνουν επίσης.
Το ωφέλιμο φορτίο περιλαμβάνει μόνο αναγνωριστικά, κατάσταση και χρόνους: ποτέ το σώμα του μηνύματος κειμένου ή τις
μεταβλητές ή το περιβάλλον της κλήσης, και το to αποκρύπτεται. Ανακτήστε το
GET /v1/scheduled/{id}
για τα υπόλοιπα.
scheduled.skipped
Αποστέλλεται όταν μια αποστολή δεν αποστέλλεται σκόπιμα. Το reason είναι expired (δεν μπορούσε να
πραγματοποιηθεί πριν από το expires_at), opted_out (ο αριθμός βρίσκεται στη
λίστα εξαίρεσης, συμπεριλαμβανομένου ενός αριθμού που προστέθηκε μετά τη δημιουργία
της αποστολής), quiet_hours (έγινε απαιτητή εκτός του διαστήματος 8 π.μ. έως 9 μ.μ. στη
ζώνη ώρας του παραλήπτη), sender_not_ready (ο αριθμός του μηνύματος κειμένου δεν μπορεί πλέον να
στείλει) ή outbound_tcpa_unconfirmed (μια κλήση έγινε απαιτητή πριν καταγραφεί η
επιβεβαίωση TCPA του οργανισμού).
{
"data": {
"agent_id": null,
"created_at": "2026-11-01T18:02:11.204Z",
"detail": "The send could not go out before its expires_at, so it was not sent late.",
"expires_at": "2026-11-03T17:30:00Z",
"external_id": "appointment-4815",
"from_number": "+15551234567",
"id": "6f1c0b8e-3a52-4c1f-9a0b-2f4f7d8a91c3",
"reason": "expired",
"send_at": "2026-11-03T17:00:00Z",
"source": "api",
"status": "skipped",
"to": "[REDACTED]",
"type": "sms"
},
"event_id": "2b0f6c43-74c9-4d43-a1f4-0d6a2f8e51a7",
"type": "scheduled.skipped"
}scheduled.failed
Αποστέλλεται όταν το ThunderPhone προσπάθησε να στείλει και η αποστολή δεν ολοκληρώθηκε. Το reason είναι το σφάλμα της ίδιας της αποστολής: ένας κωδικός σφάλματος SMS, όπως το carrier_rejected για ένα μήνυμα κειμένου, ή ο λόγος απόρριψης ή αποτυχίας της κλήσης, όπως ο κανόνας αποκλεισμένου προορισμού (για παράδειγμα, premium_rate) ή το agent_deleted. Το ωφέλιμο φορτίο έχει τα ίδια
πεδία με το scheduled.skipped.
| Πεδίο | Τύπος | Περιγραφή |
|---|---|---|
id | string | Το αναγνωριστικό της προγραμματισμένης αποστολής |
type | string | sms ή call |
status | string | skipped ή failed |
reason | string | Γιατί, όπως παραπάνω· η ίδια τιμή με το status_reason της αποστολής |
detail | string | Αναγνώσιμη επεξήγηση |
source | string | Τι δημιούργησε την αποστολή: api |
external_id | string | null | Το δικό σας κλειδί για την αποστολή ή null |
from_number | string | Αριθμός αποστολής |
to | string | Πάντα "[REDACTED]" |
agent_id | integer | null | Κλήσεις: ο πράκτορας· μηνύματα κειμένου: null |
send_at, expires_at, created_at | timestamp | ISO 8601 |
Φωνητικά συμβάντα
Η δημιουργία προσαρμοσμένης φωνής είναι ασύγχρονη. Αυτά τα μη αποκλειστικά συμβάντα σάς επιτρέπουν να αντιδράτε σε ένα τελικό αποτέλεσμα αντί να κάνετε περιοδικό έλεγχο στο τελικό σημείο λεπτομερειών κλώνου.
Τα voice.ready και voice.failed παραδίδονται μόνο σε ένα τελικό σημείο για ολόκληρο τον οργανισμό
με events: []. Δεν μπορούν να επιλεγούν ως ρητά φίλτρα συμβάντων.
voice.ready
Αποστέλλεται όταν η επεξεργασία μιας προσαρμοσμένης φωνής ολοκληρώνεται και μπορεί να ανατεθεί σε έναν πράκτορα.
{
"data": {
"voice": {
"created_at": "2026-07-30T14:12:08.317Z",
"display_name": "Support voice",
"failure_reason": "",
"gender": "female",
"id": "cv_2f6f90b0e9a34ee8b39be7d1",
"language": "en",
"name": "custom:cv_2f6f90b0e9a34ee8b39be7d1",
"status": "ready",
"updated_at": "2026-07-30T14:13:31.605Z"
}
},
"event_id": "2d5f0a61-e9b5-4a3c-b684-29d7d9e4b214",
"type": "voice.ready"
}voice.failed
Αποστέλλεται όταν η επεξεργασία προσαρμοσμένης φωνής καταλήγει σε μόνιμη αποτυχία.
{
"data": {
"reason": "audio sample could not be processed",
"voice": {
"created_at": "2026-07-30T14:12:08.317Z",
"display_name": "Support voice",
"failure_reason": "audio sample could not be processed",
"gender": "female",
"id": "cv_2f6f90b0e9a34ee8b39be7d1",
"language": "en",
"name": "custom:cv_2f6f90b0e9a34ee8b39be7d1",
"status": "failed",
"updated_at": "2026-07-30T14:13:31.605Z"
}
},
"event_id": "3493e985-1a75-4f77-a10a-e74af440cd31",
"type": "voice.failed"
}| Πεδίο | Τύπος | Περιγραφή |
|---|---|---|
voice.id | συμβολοσειρά | Δημόσιο αναγνωριστικό προσαρμοσμένης φωνής |
voice.name | συμβολοσειρά | Τιμή φωνής πράκτορα στη μορφή custom:<public_id> |
voice.display_name | συμβολοσειρά | Όνομα φωνής που εμφανίζεται στον οργανισμό |
voice.language | συμβολοσειρά | Ο μοναδικός κωδικός γλώσσας του κλώνου |
voice.gender | συμβολοσειρά | male, female ή κενή συμβολοσειρά |
voice.status | συμβολοσειρά | ready για voice.ready· failed για voice.failed |
voice.failure_reason | συμβολοσειρά | Κενό σε επιτυχία· λεπτομέρεια αποτυχίας επεξεργασίας σε αποτυχία |
voice.created_at, voice.updated_at | χρονική σήμανση | Χρονικές σημάνσεις ISO 8601 |
reason | συμβολοσειρά | Λεπτομέρεια αποτυχίας· υπάρχει μόνο στο voice.failed |
Συμβάντα ποιότητας
call.graded
Αποστέλλεται κάθε φορά που ολοκληρώνεται μια εκτέλεση αξιολόγησης AI για μια κλήση. Δεν αποκλείει τη συνέχεια.
{
"data": {
"call_id": 987654321,
"grade": {
"call_outcome": "success",
"created_at": "2026-04-20T18:25:11.002Z",
"detected_issues": [],
"graded_at": "2026-04-20T18:25:11.002Z",
"grader_model": "heuristic-v1",
"id": 5512,
"score": 92,
"status": "completed",
"summary": "Caller asked about their policy and got a full answer…"
},
"report": null
},
"event_id": "7c1d2e3f-4a5b-4c6d-8e9f-0a1b2c3d4e5f",
"type": "call.graded"
}| Πεδίο | Τύπος | Περιγραφή |
|---|---|---|
agent_id | integer | null | Ο πράκτορας που χειρίστηκε την κλήση, όταν είχε ανατεθεί κάποιος |
agent_name | string | null | Ο πράκτορας που χειρίστηκε την κλήση, όταν είχε ανατεθεί κάποιος |
grade.id | integer | Αναγνωριστικό αξιολόγησης |
grade.score | integer | null | 0–100 |
grade.call_outcome | string | success, failure, unknown ή no_conversation |
grade.summary | string | Σύνοψη μίας παραγράφου |
grade.detected_issues | array | Συμβολοσειρές ζητημάτων που εντοπίστηκαν από τον αξιολογητή |
grade.status | string | Πάντα completed — εκπέμπουν μόνο ολοκληρωμένες εκτελέσεις |
grade.grader_model | string | Ποιος αξιολογητής παρήγαγε το αποτέλεσμα: heuristic-v1 (ή άλλος αξιολογητής του ThunderPhone που βασίζεται σε κανόνες) για μια γρήγορη προσωρινή αξιολόγηση, thunderphone-grader για την πλήρη αξιολόγηση. Ετικέτα του ThunderPhone, όχι το όνομα μοντέλου AI |
grade.graded_at, grade.created_at | timestamp | |
report | object | null | Η αναφορά κλήσης που εμφανίζεται στον πελάτη: ετικέτα αποτελέσματος, ένδειξη και αιτία ανάγκης προσοχής, καλών, μονογραμμική σύνοψη, εμπειρία καλούντος. Σε μια πρώιμη ευρετική αξιολόγηση είναι null ή αναφορά pending της οποίας τα πεδία είναι δεσμευτικά θέσης· το συμβάν της πλήρους αξιολόγησης περιέχει την ολοκληρωμένη αναφορά |
call.data_extracted
Αποστέλλεται κάθε φορά που η εξαγωγή δομημένων δεδομένων ολοκληρώνεται επιτυχώς, συμπεριλαμβανομένης
μιας καθυστερημένης επανάληψης μετά από telephony.complete / web.complete ή μιας χειροκίνητης επανεκτέλεσης μέσω
POST /v1/calls/{call_id}/extract.
Δεν αποκλείει τη συνέχεια.
Σε λειτουργία αποκλειστικής εξαγωγής, το συμβάν ολοκλήρωσης συνήθως δεν αναμένει περισσότερο
από τον προϋπολογισμό εξαγωγής των 75 δευτερολέπτων. Αν χαθεί η διεργασία εργαζομένου εξαγωγής,
η αποστράγγιση οριστικοποίησης παραγωγής, κάθε πέντε λεπτά, απελευθερώνει μια
ολοκλήρωση της οποίας το blocking_deadline_at έχει παρέλθει πριν ξεκινήσει άλλη
προσπάθεια εξαγωγής. Μια μεταγενέστερη επιτυχία παραδίδεται ξεχωριστά ως αυτό το συμβάν.
{
"data": {
"call_id": 987654321,
"agent_id": 12,
"agent_name": "Acme intake",
"extracted_data": {
"status": "completed",
"fields": {
"customer_name": "Alex Morgan",
"appointment_date": "2026-04-23"
},
"evidence": {
"customer_name": {
"quote": "My name is Alex Morgan",
"speaker_role": "caller",
"turn_index": 4
},
"appointment_date": {
"quote": "April 23 works for me",
"speaker_role": "caller",
"turn_index": 7
}
},
"verification": "verified",
"field_reasons": {},
"schema_version": "92850758e231a3c95a..."
},
"extracted_at": "2026-04-20T18:25:11.002Z",
"model": "thunderphone-extractor",
"summary": "Alex Morgan called to book a follow-up visit and confirmed Thursday, April 23."
},
"event_id": "4d79ef1d-c2b1-4ed6-85b8-8326bd2895ef",
"type": "call.data_extracted"
}| Πεδίο | Τύπος | Περιγραφή |
|---|---|---|
agent_id | ακέραιος | null | Πράκτορας που χειρίστηκε την κλήση, όταν είχε ανατεθεί κάποιος |
agent_name | συμβολοσειρά | null | Πράκτορας που χειρίστηκε την κλήση, όταν είχε ανατεθεί κάποιος |
summary | συμβολοσειρά | null | Η ολοκληρωμένη σύνοψη κλήσης όταν ο πράκτορας έχει ενεργοποιημένη τη Δημιουργία σύνοψης κλήσης, ώστε ένα συμβάν εξαγωγής που φτάνει αργότερα να παραδίδει επίσης μια σύνοψη που έχασε το παράθυρο ολοκλήρωσης· διαφορετικά null. Πράκτορες με σύνοψη αλλά χωρίς πεδία εξαγωγής δεν εκπέμπουν ποτέ αυτό το συμβάν: διαβάστε μια καθυστερημένη σύνοψη από GET /v1/calls/{call_id} |
extracted_data.status | συμβολοσειρά | Πάντα completed για αυτό το συμβάν |
extracted_data.fields | αντικείμενο | Τιμές με κλειδιά τα διαμορφωμένα κλειδιά πεδίων εξαγωγής· οι μη διαθέσιμες τιμές είναι null |
extracted_data.evidence | αντικείμενο | Τεκμήρια με κλειδί το πεδίο εξαγωγής. Μια τιμή που δεν είναι null περιέχει το ακριβές απόσπασμα που έχει ελεγχθεί δομικά (έως 1.000 χαρακτήρες), το speaker_role (caller ή agent) και το turn_index· μεγαλύτερα αποσπάσματα που επιστρέφει το μοντέλο απορρίπτονται αντί να περικόπτονται και τα τεκμήρια είναι null κάθε φορά που το πεδίο τους είναι null |
extracted_data.verification | συμβολοσειρά | verified μόνο όταν η ανεξάρτητη διεργασία τεκμηρίωσης επέστρεψε ακριβώς μία έγκυρη ετυμηγορία για κάθε υποψήφιο πεδίο. Το unavailable σημαίνει ότι η διεργασία απέτυχε, έληξε λόγω χρονικού ορίου, δεν είχε επαρκή προϋπολογισμό ή επέστρεψε εσφαλμένη ή μερική έξοδο. Μια πλήρως μη διαθέσιμη διεργασία διατηρεί τις τιμές που τεκμηριώνονται δομικά για έλεγχο από τον πελάτη. Για μερική έξοδο, εφαρμόζονται οι έγκυρες ετυμηγορίες και κάθε υποψήφιο χωρίς ακριβώς μία έγκυρη ετυμηγορία ορίζεται σε null |
extracted_data.field_reasons | αντικείμενο | Αιτίες με κλειδιά τα πεδία που ορίστηκαν σε null από τη δομική τεκμηρίωση ή τον ανεξάρτητο επαληθευτή |
extracted_data.schema_version | συμβολοσειρά | Κατακερματισμός του ακριβούς σχήματος πεδίων που χρησιμοποιήθηκε για αυτή την εξαγωγή |
extracted_at | χρονική σήμανση | Χρόνος ολοκλήρωσης ISO 8601 |
model | συμβολοσειρά | Πάντα thunderphone-extractor: μια ετικέτα ThunderPhone για το μοντέλο εξαγωγής, όχι το όνομα ενός μοντέλου AI |
campaign.completed
Αποστέλλεται μία φορά όταν μια καμπάνια μεταβαίνει από running σε completed, είτε
το πρόγραμμά της ολοκληρώθηκε είτε όλες οι επαφές έφτασαν σε τερματικές καταστάσεις. Οι επαναλήψεις
του εκτελεστή δεν εκπέμπουν άλλο συμβάν. Αυτό το συμβάν κύκλου ζωής σε επίπεδο οργανισμού παραδίδεται μόνο
σε τελικά σημεία με εμβέλεια οργανισμού και όχι σε τελικά σημεία με εμβέλεια πράκτορα. Δεν αποκλείει τη συνέχεια.
{
"data": {
"campaign_id": "3f6b2c9e-2a0d-4c63-b6d6-a708dc98f403",
"name": "May win-back",
"agent_id": 12,
"status": "completed",
"started_at": "2026-04-20T17:00:00Z",
"completed_at": "2026-04-20T18:25:11Z",
"counts": {
"contacts_total": 150,
"completed": 121,
"failed": 11,
"no_answer": 18,
"skipped": 4,
"remaining": 0
}
},
"event_id": "8d8f52ce-6b46-423f-9dde-cea0b91ec135",
"type": "campaign.completed"
}Οι τέσσερις μετρήσεις αποτελεσμάτων είναι αμοιβαία αποκλειόμενες και αθροίζονται στο contacts_total:
το completed περιέχει επιτυχημένες επαφές· το no_answer περιέχει επαφές που απέτυχαν οριστικά ή εξάντλησαν τις προσπάθειες, με τελικό αποτέλεσμα τη μη απάντηση· το failed περιέχει όλες τις άλλες επαφές που απέτυχαν οριστικά ή εξάντλησαν τις προσπάθειες· και το remaining περιέχει επαφές σε εκκρεμότητα, προγραμματισμένες ή που καλούνται αυτήν τη στιγμή. Μια επαφή που αναμένει επανάληψη είναι remaining, ακόμη και όταν η πιο πρόσφατη προσπάθειά της δεν απαντήθηκε. Οι κλήσεις σε εξέλιξη συμφωνούνται πριν από το στιγμιότυπο ολοκλήρωσης που αποστέλλεται μία μόνο φορά. Το started_at είναι η διαμορφωμένη ώρα έναρξης της καμπάνιας ή η ώρα δημιουργίας της καμπάνιας όταν δεν έχει διαμορφωθεί ώρα έναρξης. Το skipped δεν είναι πέμπτη κατηγορία: μετρά τις επαφές εντός του failed για τις οποίες το φίλτρο τύπου αριθμού ολοκληρώθηκε χωρίς κλήση.
issue.reported
Αποστέλλεται όταν δημιουργείται μια αναφορά ζητήματος —
είτε υποβάλλεται από έναν χρήστη από τον πίνακα ελέγχου (source: "user") είτε
αυτόματα από την αξιολόγηση κλήσης (source: "system"). Δεν αποκλείει τη συνέχεια.
{
"data": {
"call_id": 987654321,
"issue_report": {
"created_at": "2026-04-20T18:25:11.002Z",
"description": "Five-second silence before responding to the main question.",
"id": 4321,
"severity": "warning",
"source": "system",
"status": "open",
"title": "Agent paused too long"
}
},
"event_id": "5e6f7a8b-9c0d-4e1f-8a2b-3c4d5e6f7a8b",
"type": "issue.reported"
}| Πεδίο | Τύπος | Περιγραφή |
|---|---|---|
agent_id | integer | null | Πράκτορας που διαχειρίστηκε την κλήση, όταν είχε ανατεθεί κάποιος |
agent_name | string | null | Πράκτορας που διαχειρίστηκε την κλήση, όταν είχε ανατεθεί κάποιος |
issue_report.severity | string | critical, warning ή info |
issue_report.status | string | open ή resolved |
issue_report.source | string | user (υποβλήθηκε από τον πίνακα ελέγχου) ή system (δημιουργήθηκε από αξιολόγηση) |
issue.escalated
Αποστέλλεται όταν ένα μοτίβο ζητημάτων αποστέλλεται στο ThunderPhone για έλεγχο από το προσωπικό: μετά από Αναφορά στο ThunderPhone, ή όταν η Επιδιόρθωση με AI δεν μπορεί να επιβεβαιώσει μια επιδιόρθωση από την πλευρά του πελάτη και δρομολογεί το ζήτημα αυτόματα. Μόνο τελικά σημεία σε ολόκληρο τον οργανισμό λαμβάνουν αυτό το συμβάν.
{
"data": {
"automatic": false,
"cluster_id": "7ac2844c-2df0-4fa8-a560-7378da649e19",
"escalation_id": "ec99f52b-c8c0-41dd-a4f2-dd8a07b10894",
"status": "open"
},
"event_id": "d8f8f420-7a42-45ba-bcf1-b747f9bbecda",
"type": "issue.escalated"
}| Πεδίο | Τύπος | Περιγραφή |
|---|---|---|
automatic | boolean | true για αυτόματη κλιμάκωση· false για χειροκίνητη κλιμάκωση |
cluster_id | UUID | Μοτίβο ζητημάτων που κλιμακώθηκε |
escalation_id | UUID | Εγγραφή κλιμάκωσης |
status | string | open όταν εκπέμπεται το συμβάν |
Αυτή είναι ειδοποίηση, όχι το πακέτο αποδεικτικών στοιχείων. Χρησιμοποιήστε το cluster_id για να το συσχετίσετε
με το μοτίβο ζητημάτων. Δείτε Αναφορά στο ThunderPhone.
Συμβάντα δοκιμαστικών κλήσεων
test-call.completed
Αποστέλλεται όταν μια
εκτέλεση δοκιμαστικής κλήσης
φτάσει σε τελική κατάσταση — completed ή failed, συμπεριλαμβανομένων εκτελέσεων
που απέτυχαν κατά την εκκίνηση και δεν πραγματοποίησαν ποτέ κλήση. Δεν αποκλείει άλλες διεργασίες. Χρήσιμο
για τη σύνδεση μαζικών εκτελέσεων CI με τα συστήματα συνομιλίας/ειδοποιήσεών σας.
{
"data": {
"test_call_run": {
"call_id": 987654321,
"completed_at": "2026-04-20T18:25:04.822Z",
"error_message": "",
"id": 7110,
"status": "completed",
"target_id": 12,
"target_type": "agent"
}
},
"event_id": "2b3c4d5e-6f7a-4b8c-9d0e-1f2a3b4c5d6e",
"type": "test-call.completed"
}| Πεδίο | Τύπος | Περιγραφή |
|---|---|---|
agent_id | integer | null | Πράκτορας που χειρίστηκε την κλήση, όταν είχε ανατεθεί |
agent_name | string | null | Πράκτορας που χειρίστηκε την κλήση, όταν είχε ανατεθεί |
test_call_run.target_type | string | agent ή phone_number |
test_call_run.target_id | integer | Το αναγνωριστικό πράκτορα ή αριθμού τηλεφώνου που στόχευε η εκτέλεση, σύμφωνα με το target_type |
test_call_run.status | string | completed ή failed |
test_call_run.call_id | integer | null | null όταν η εκτέλεση απέτυχε πριν πραγματοποιηθεί κλήση |
test_call_run.error_message | string | Κενό σε περίπτωση επιτυχίας |
Συμβάντα ειδοποιήσεων
alert.triggered
Αποστέλλεται όταν ένας κανόνας ειδοποίησης με ενεργοποιημένο το κανάλι Παράδοση σε webhook προγραμματιστή υπερβαίνει το όριό του. Δεν αποκλείει άλλες διεργασίες. Ένας κανόνας ενεργοποιείται μία φορά και στη συνέχεια τηρεί την περίοδο αναμονής του, επομένως μια διαρκής παραβίαση παράγει ένα συμβάν ανά παράθυρο περιόδου αναμονής.
{
"data": {
"comparator": "lt",
"event_id": "b8e6a1d4-2c3f-4a5b-9c8d-7e6f5a4b3c2d",
"fired_at": "2026-04-20T18:00:00+00:00",
"metric": "success_rate",
"metric_value": 71.4,
"rule_id": "d2c3b4a5-6f7e-4d8c-9b0a-1c2d3e4f5a6b",
"rule_name": "Success rate below 80%",
"threshold": 80.0,
"window_hours": 24
},
"event_id": "4d5e6f7a-8b9c-4d0e-9f1a-2b3c4d5e6f7a",
"type": "alert.triggered"
}| Πεδίο | Τύπος | Περιγραφή |
|---|---|---|
event_id (στο data) | UUID | Το αναγνωριστικό ενεργοποίησης της ειδοποίησης — διαφέρει από το event_id παράδοσης του περιβλήματος |
rule_id, rule_name | UUID, string | Ο κανόνας που ενεργοποιήθηκε |
metric | string | success_rate, failure_rate, avg_score, call_volume ή suite_regression |
comparator | string | lt, lte, gt ή gte |
metric_value | number | Η τιμή της μέτρησης στο παράθυρο όταν ενεργοποιήθηκε ο κανόνας |
threshold | number | Το διαμορφωμένο όριο |
window_hours | integer | Κυλιόμενο παράθυρο αξιολόγησης |
fired_at | timestamp |
Δείτε τον οδηγό Ειδοποιήσεων για τη δημιουργία κανόνων, μετρήσεων, περιόδων αναμονής και καναλιών ηλεκτρονικού ταχυδρομείου / Slack.
Συμβάντα τηλεφωνικού αριθμού
phone_number.spam_risk_changed
Αποστέλλεται όταν η παρακολούθηση επισήμανσης ανεπιθύμητης αλληλογραφίας (πρόσθετη λειτουργία επί πληρωμή, κατόπιν αιτήματος μέσω υποστήριξης)
εντοπίζει ότι ο κίνδυνος ανεπιθύμητης αλληλογραφίας ενός παρακολουθούμενου αριθμού αυξάνεται σε medium ή high (από low, από
καμία μέτρηση ακόμη ή από medium σε high). Δεν αποκλείει καμία ενέργεια. Ένας αριθμός που παραμένει επισημασμένος δεν αποστέλλεται ξανά· ένας αριθμός που επανέρχεται σε low και επισημαίνεται αργότερα αποστέλλεται.
Το συμβάν δεν έχει περιβάλλον πράκτορα, επομένως το λαμβάνουν μόνο τερματικά σε επίπεδο οργανισμού.
Οι ιδιοκτήτες και οι διαχειριστές του οργανισμού λαμβάνουν επίσης email.
{
"data": {
"checked_at": "2026-10-21T14:41:07+00:00",
"phone_number": "+13125550100",
"phone_number_id": 412,
"previous_spam_risk": "low",
"scores": {
"connection": 31,
"engagement": 40,
"maturity": 82,
"sentiment": 22
},
"spam_category": "Telemarketer",
"spam_risk": "high"
},
"event_id": "6f1c2d3e-4b5a-4c6d-8e7f-9a0b1c2d3e4f",
"type": "phone_number.spam_risk_changed"
}| Πεδίο | Τύπος | Περιγραφή |
|---|---|---|
phone_number | string | Ο αριθμός, σε E.164 |
phone_number_id | integer | null | Το αναγνωριστικό του στους Αριθμούς τηλεφώνου |
spam_risk | string | medium ή high |
previous_spam_risk | string | null | Ο κίνδυνος στην προηγούμενη μέτρηση, null πριν από την πρώτη |
spam_category | string | null | Η ετικέτα που ενδέχεται να εμφανίζουν οι πάροχοι, όπως Telemarketer ή Survey. Αντιμετωπίστε την ως ελεύθερο κείμενο |
scores | object | Από 0 έως 100 το καθένα ή null μέχρι να υπάρχει επαρκής όγκος κλήσεων: maturity (πόσο εδραιωμένος είναι ο αριθμός), connection (αν απαντούν οι χρήστες), engagement (αν παραμένουν στη γραμμή), sentiment (αν τον αποκλείουν ή τον αναφέρουν) |
checked_at | timestamp | Πότε το ThunderPhone ανέκτησε το αποτέλεσμα |
Συμβάντα μετεγκατάστασης
migration.call.complete
Αποστέλλεται όταν ολοκληρώνεται μια κλήση που πραγματοποιήθηκε μέσω
POST /v1/migrations/{id}/calls,
ανεξάρτητα από την πλατφόρμα που την ανέλαβε. Δεν αποκλείει την εκτέλεση. Παραδίδεται έως περίπου 5 λεπτά
μετά το τέλος της κλήσης. Το data περιέχει κάθε πεδίο του
telephony.complete μαζί με ένα μπλοκ migration. Μια
κλήση που πραγματοποίησε το ThunderPhone στέλνει επίσης το telephony.complete ως συνήθως, με το
ίδιο call_id. Το answered_by είναι null για μια κλήση που ανέλαβε η άλλη πλατφόρμα. Μια κλήση στην άλλη πλατφόρμα που δεν έχει ολοκληρωθεί μετά από 2
ώρες ή της οποίας η μετεγκατάσταση ολοκληρώθηκε ή έχασε πρώτα το κλειδί της, αποστέλλεται με
status: "unknown" και χωρίς απομαγνητοφώνηση.
{
"data": {
"agent_id": 42,
"agent_name": "Front desk",
"answered_by": null,
"billable_minutes": null,
"billing_total_cents": null,
"call_id": null,
"direction": "outbound",
"duration_seconds": 94,
"end_reason": "user_hangup",
"end_time": "2026-10-06T17:01:34+00:00",
"extracted_data": null,
"from_number": "+15551234567",
"migration": {
"arm": "vendor",
"id": "5f0c2a9e-7b1d-4c3e-8a6f-2d9e1b4c7a30",
"metadata": {
"lead_id": "8812"
},
"routing_id": "9b2f8c1e-4d3a-4f6b-8e2d-1a7c5b9e0f34",
"vendor": "retell",
"vendor_call_id": "call_6a1f0e",
"vendor_cost_usd": "0.1240"
},
"product": "",
"recording_mode": "vendor",
"recording_url": "https://…",
"start_time": "2026-10-06T17:00:00+00:00",
"status": "completed",
"summary": "The callee booked a table for two on Thursday.",
"thunderphone_retained_call_content": true,
"to_number": "+14155552671",
"transcripts": [
{
"content": "Hi Ada, this is Rosa's calling about your booking.",
"role": "agent"
},
{
"content": "Yes, Thursday works.",
"role": "user"
}
],
"transfer_number": null,
"unresolved_variables": [],
"variables": {
"first_name": "Ada"
},
"voice": ""
},
"event_id": "7c1e2f3a-4b5c-4d6e-8f7a-9b0c1d2e3f4a",
"type": "migration.call.complete"
}| Πεδίο | Τύπος | Περιγραφή |
|---|---|---|
migration.id | UUID | Η μετεγκατάσταση |
migration.routing_id | UUID | Η δρομολογημένη κλήση, όπως επιστράφηκε όταν την πραγματοποιήσατε |
migration.arm | string | ours (την πραγματοποίησε το ThunderPhone) ή vendor (την πραγματοποίησε η άλλη πλατφόρμα) |
migration.vendor | string | retell, vapi, elevenlabs ή bland |
migration.vendor_call_id | string | null | Το αναγνωριστικό κλήσης της άλλης πλατφόρμας· null για ours |
migration.metadata | object | Τα metadata που στείλατε κατά την πραγματοποίηση της κλήσης |
migration.vendor_cost_usd | string | null | Το κόστος της κλήσης που ανέφερε η άλλη πλατφόρμα, όταν το ανέφερε |
call_id | integer | null | Το αναγνωριστικό κλήσης του ThunderPhone· null για vendor |
status | string | Για vendor: completed όταν μίλησε ο παραλήπτης, failed όταν δεν μίλησε, unknown όπως παραπάνω. Για ours: όπως στο telephony.complete |
Για μια κλήση vendor, το ThunderPhone δεν διαθέτει δεδομένα χρέωσης ή εξαγωγής:
τα billable_minutes, billing_total_cents και extracted_data είναι null,
τα product και voice είναι κενά, το recording_mode είναι vendor και το
recording_url είναι ο σύνδεσμος της άλλης πλατφόρμας, όταν παρείχε κάποιον.
migration.rollback
Αποστέλλεται όταν η σταδιακή εναλλαγή μιας μετεγκατάστασης μεταφέρει αυτόματα κάθε κλήση πίσω στην άλλη πλατφόρμα: 3 κλήσεις απέτυχαν να συνδεθούν με το ThunderPhone εντός 15 λεπτών, 2 κλήσεις που στάλθηκαν στο ThunderPhone τερματίστηκαν πριν απαντήσει ο πράκτορας ή το ποσοστό επιτυχίας αποτελέσματος εργασίας του ThunderPhone μειώθηκε περισσότερο από το διαμορφωμένο περιθώριο κάτω από το αντίστοιχο της άλλης πλατφόρμας. Δεν εμποδίζει τη ροή, μία φορά ανά επαναφορά. Μετά από αυτό, το μερίδιο του ThunderPhone είναι 0% και η μετεγκατάσταση τίθεται σε παύση μέχρι κάποιος να τη συνεχίσει από την καρτέλα Μετεγκατάστασης του πράκτορα. Το ωφέλιμο φορτίο δεν περιέχει αριθμούς τηλεφώνου, απομαγνητοφωνήσεις ή αναγνωριστικά κλήσεων.
{
"data": {
"agent_id": 42,
"agent_name": "Front desk",
"dropped": 0,
"migration_id": "5f0c2a9e-7b1d-4c3e-8a6f-2d9e1b4c7a30",
"ours": {
"graded": 20,
"success_rate": 0.8
},
"ours_failed": 3,
"ours_percent": 0,
"previous_percent": 25,
"reason": "ours_failed_burst",
"rolled_back_at": "2026-10-10T12:05:00+00:00",
"step": 1,
"theirs": {
"graded": 20,
"success_rate": 0.8
},
"vendor": "retell"
},
"event_id": "3d1f6b2a-8c4e-5a7b-9d0e-2f1a3b4c5d6e",
"type": "migration.rollback"
}| Πεδίο | Τύπος | Περιγραφή |
|---|---|---|
migration_id | UUID | Η μετεγκατάσταση |
vendor | string | retell, vapi, elevenlabs ή bland |
reason | string | ours_failed_burst (3 αποτυχημένες συνδέσεις σε 15 λεπτά), dropped_calls (2 κλήσεις τερματίστηκαν πριν απαντήσει ο πράκτορας, εντός 30 λεπτών) ή rate_gap (διαφορά στο ποσοστό αποτελέσματος εργασίας για τουλάχιστον rollback_min_calls αξιολογημένες κλήσεις ανά πλευρά) |
previous_percent | integer | Το μερίδιο κλήσεων του ThunderPhone πριν από την επαναφορά |
ours_percent | integer | Πάντα 0 |
step | integer | null | Το βήμα του χρονοδιαγράμματος στο οποίο βρισκόταν (με αρίθμηση από το 0) |
ours / theirs | object | null | Αξιολογημένες κλήσεις στο τρέχον βήμα και το ποσοστό επιτυχίας τους· το theirs μπορεί να αφορά τις τελευταίες 30 ημέρες όταν το βήμα έχει πολύ λίγες κλήσεις. null όταν δεν υπήρχαν |
ours_failed | integer | Αποτυχημένες συνδέσεις που καταμετρήθηκαν στα τελευταία 15 λεπτά |
dropped | integer | Κλήσεις που καταμετρήθηκαν ως τερματισμένες στα τελευταία 30 λεπτά |
rolled_back_at | timestamp |
Σχετικά
Το payload εισερχόμενης κλήσης που αποκλείει άλλες διεργασίες και στο οποίο πρέπει να απαντήσετε.
Απομαγνητοφώνηση και μετρήσεις μετά την κλήση.
Εγγράψτε ένα URL σε ένα υποσύνολο αυτών των συμβάντων.
Πώς δημιουργούνται τα συμβάντα telephony.tool / web.tool.