Το ThunderPhone v3 είναι πλέον διαθέσιμο.Ξεκινήστε μόνοι σας, από 2¢/λεπτό.Διαβάστε την ανακοίνωση

Webhooks

Κατάλογος συμβάντων

Όλοι οι τύποι συμβάντων 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_idinteger | nullΠράκτορας που χειρίστηκε την κλήση, όταν είχε εκχωρηθεί
agent_namestring | 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_idinteger | nullΠράκτορας που χειρίστηκε την κλήση, όταν είχε εκχωρηθεί
agent_namestring | 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_idinteger | nullΠράκτορας που χειρίστηκε την κλήση, όταν είχε εκχωρηθεί
agent_namestring | nullΠράκτορας που χειρίστηκε την κλήση, όταν είχε εκχωρηθεί
positionintegerΟ δείκτης της σειράς στο ιστορικό κλήσης — σταθερό αναγνωριστικό για ταξινόμηση
rolestringassistant (ομιλία πράκτορα) ή user (ομιλία καλούντος)
textstringΤο κείμενο απομαγνητοφώνησης της σειράς όπως είναι γνωστό κατά τον χρόνο εκπομπής
entry_typestringΟ υποκείμενος τύπος καταχώρισης ιστορικού: completion (πράκτορας) ή user_turn / span (καλών)
start_ms, end_msintegerΜετατοπίσεις ήχου σε 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_idinteger | nullΠράκτορας που χειρίστηκε την κλήση, όταν είχε εκχωρηθεί
agent_namestring | nullΠράκτορας που χειρίστηκε την κλήση, όταν είχε εκχωρηθεί

web.complete

Το ισοδύναμο του telephony.complete για το κανάλι web, που καλύπτει κλήσεις widget web (direction: "web") και δοκιμαστικές κλήσεις μικροφώνου στον δημιουργό (direction: "test"). Δεν προκαλεί αποκλεισμό. Ίδια μορφή ωφέλιμου φορτίου με το telephony.complete, συν το origin_domain, με το from_number ορισμένο σε "web".

ΠεδίοΤύποςΠεριγραφή
agent_idinteger | nullΠράκτορας που χειρίστηκε την κλήση, όταν είχε εκχωρηθεί
agent_namestring | nullΠράκτορας που χειρίστηκε την κλήση, όταν είχε εκχωρηθεί

web.tool

Το ισοδύναμο του telephony.tool για το κανάλι web. Το data περιέχει origin_domain αντί για from_number / to_number.

ΠεδίοΤύποςΠεριγραφή
agent_idinteger | nullΠράκτορας που χειρίστηκε την κλήση, όταν είχε εκχωρηθεί
agent_namestring | nullΠράκτορας που χειρίστηκε την κλήση, όταν είχε εκχωρηθεί

web.turn

Το ισοδύναμο του telephony.turn για το κανάλι web, που καλύπτει κλήσεις widget web και δοκιμαστικές κλήσεις μικροφώνου στον δημιουργό. Ίδια μορφή ωφέλιμου φορτίου, με origin_domain αντί για from_number / to_number. Όπως το telephony.turn, απαιτεί ρητή εγγραφή — δεν παραδίδεται ποτέ μέσω κενού πίνακα events.

ΠεδίοΤύποςΠεριγραφή
agent_idinteger | nullΠράκτορας που χειρίστηκε την κλήση, όταν είχε εκχωρηθεί
agent_namestring | 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_idintegerΗ κλήση που χρεώθηκε
agent_idinteger | nullΟ πράκτορας που διαχειρίστηκε την κλήση, όταν είχε ανατεθεί κάποιος
agent_namestring | nullΟ πράκτορας που διαχειρίστηκε την κλήση, όταν είχε ανατεθεί κάποιος
reasonstringsettled: η χρέωση της κλήσης. adjusted: χρήση που έφτασε μετά τη χρέωση και την αύξησε (μια χρέωση δεν μειώνεται ποτέ)
billing_seqinteger1 για τη χρέωση και έπειτα 2, 3, ... για κάθε αύξηση. Η υψηλότερη τιμή που λήφθηκε είναι η τρέχουσα χρέωση της κλήσης
billable_minutesnumberΤα λεπτά που χρεώθηκαν, στρογγυλοποιημένα στο πλησιέστερο τέταρτο του λεπτού
billing_total_centsintegerΌλα όσα έχουν χρεωθεί μέχρι τώρα για την κλήση σε σεντ USD, μετά από τυχόν δωρεάν πίστωση κλήσεων, συμπεριλαμβανομένων των αυξήσεων adjusted
adjustment_centsinteger | 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_idintegerΗ κλήση
agent_idinteger | nullΟ πράκτορας που χειρίστηκε την κλήση, όταν είχε ανατεθεί
agent_namestring | nullΟ πράκτορας που χειρίστηκε την κλήση, όταν είχε ανατεθεί
directionstringΗ κατεύθυνση της κλήσης, όπως στο αντικείμενο κλήσης
statusstringΤο στάδιο στο οποίο έφτασε η κλήση· δείτε τον παρακάτω πίνακα
occurred_attimestampΠότε συνέβη
hold_secondsinteger | 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.

ΠεδίοΤύποςΠεριγραφή
idstringΤο αναγνωριστικό της προγραμματισμένης αποστολής
typestringsms ή call
statusstringskipped ή failed
reasonstringΓιατί, όπως παραπάνω· η ίδια τιμή με το status_reason της αποστολής
detailstringΑναγνώσιμη επεξήγηση
sourcestringΤι δημιούργησε την αποστολή: api
external_idstring | nullΤο δικό σας κλειδί για την αποστολή ή null
from_numberstringΑριθμός αποστολής
tostringΠάντα "[REDACTED]"
agent_idinteger | nullΚλήσεις: ο πράκτορας· μηνύματα κειμένου: null
send_at, expires_at, created_attimestampISO 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_idinteger | nullΟ πράκτορας που χειρίστηκε την κλήση, όταν είχε ανατεθεί κάποιος
agent_namestring | nullΟ πράκτορας που χειρίστηκε την κλήση, όταν είχε ανατεθεί κάποιος
grade.idintegerΑναγνωριστικό αξιολόγησης
grade.scoreinteger | null0–100
grade.call_outcomestringsuccess, failure, unknown ή no_conversation
grade.summarystringΣύνοψη μίας παραγράφου
grade.detected_issuesarrayΣυμβολοσειρές ζητημάτων που εντοπίστηκαν από τον αξιολογητή
grade.statusstringΠάντα completed — εκπέμπουν μόνο ολοκληρωμένες εκτελέσεις
grade.grader_modelstringΠοιος αξιολογητής παρήγαγε το αποτέλεσμα: heuristic-v1 (ή άλλος αξιολογητής του ThunderPhone που βασίζεται σε κανόνες) για μια γρήγορη προσωρινή αξιολόγηση, thunderphone-grader για την πλήρη αξιολόγηση. Ετικέτα του ThunderPhone, όχι το όνομα μοντέλου AI
grade.graded_at, grade.created_attimestamp
reportobject | 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_idinteger | nullΠράκτορας που διαχειρίστηκε την κλήση, όταν είχε ανατεθεί κάποιος
agent_namestring | nullΠράκτορας που διαχειρίστηκε την κλήση, όταν είχε ανατεθεί κάποιος
issue_report.severitystringcritical, warning ή info
issue_report.statusstringopen ή resolved
issue_report.sourcestringuser (υποβλήθηκε από τον πίνακα ελέγχου) ή 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"
}
ΠεδίοΤύποςΠεριγραφή
automaticbooleantrue για αυτόματη κλιμάκωση· false για χειροκίνητη κλιμάκωση
cluster_idUUIDΜοτίβο ζητημάτων που κλιμακώθηκε
escalation_idUUIDΕγγραφή κλιμάκωσης
statusstringopen όταν εκπέμπεται το συμβάν

Αυτή είναι ειδοποίηση, όχι το πακέτο αποδεικτικών στοιχείων. Χρησιμοποιήστε το 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_idinteger | nullΠράκτορας που χειρίστηκε την κλήση, όταν είχε ανατεθεί
agent_namestring | nullΠράκτορας που χειρίστηκε την κλήση, όταν είχε ανατεθεί
test_call_run.target_typestringagent ή phone_number
test_call_run.target_idintegerΤο αναγνωριστικό πράκτορα ή αριθμού τηλεφώνου που στόχευε η εκτέλεση, σύμφωνα με το target_type
test_call_run.statusstringcompleted ή failed
test_call_run.call_idinteger | nullnull όταν η εκτέλεση απέτυχε πριν πραγματοποιηθεί κλήση
test_call_run.error_messagestringΚενό σε περίπτωση επιτυχίας

Συμβάντα ειδοποιήσεων

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_nameUUID, stringΟ κανόνας που ενεργοποιήθηκε
metricstringsuccess_rate, failure_rate, avg_score, call_volume ή suite_regression
comparatorstringlt, lte, gt ή gte
metric_valuenumberΗ τιμή της μέτρησης στο παράθυρο όταν ενεργοποιήθηκε ο κανόνας
thresholdnumberΤο διαμορφωμένο όριο
window_hoursintegerΚυλιόμενο παράθυρο αξιολόγησης
fired_attimestamp

Δείτε τον οδηγό Ειδοποιήσεων για τη δημιουργία κανόνων, μετρήσεων, περιόδων αναμονής και καναλιών ηλεκτρονικού ταχυδρομείου / 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_numberstringΟ αριθμός, σε E.164
phone_number_idinteger | nullΤο αναγνωριστικό του στους Αριθμούς τηλεφώνου
spam_riskstringmedium ή high
previous_spam_riskstring | nullΟ κίνδυνος στην προηγούμενη μέτρηση, null πριν από την πρώτη
spam_categorystring | nullΗ ετικέτα που ενδέχεται να εμφανίζουν οι πάροχοι, όπως Telemarketer ή Survey. Αντιμετωπίστε την ως ελεύθερο κείμενο
scoresobjectΑπό 0 έως 100 το καθένα ή null μέχρι να υπάρχει επαρκής όγκος κλήσεων: maturity (πόσο εδραιωμένος είναι ο αριθμός), connection (αν απαντούν οι χρήστες), engagement (αν παραμένουν στη γραμμή), sentiment (αν τον αποκλείουν ή τον αναφέρουν)
checked_attimestampΠότε το 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.idUUIDΗ μετεγκατάσταση
migration.routing_idUUIDΗ δρομολογημένη κλήση, όπως επιστράφηκε όταν την πραγματοποιήσατε
migration.armstringours (την πραγματοποίησε το ThunderPhone) ή vendor (την πραγματοποίησε η άλλη πλατφόρμα)
migration.vendorstringretell, vapi, elevenlabs ή bland
migration.vendor_call_idstring | nullΤο αναγνωριστικό κλήσης της άλλης πλατφόρμας· null για ours
migration.metadataobjectΤα metadata που στείλατε κατά την πραγματοποίηση της κλήσης
migration.vendor_cost_usdstring | nullΤο κόστος της κλήσης που ανέφερε η άλλη πλατφόρμα, όταν το ανέφερε
call_idinteger | nullΤο αναγνωριστικό κλήσης του ThunderPhone· null για vendor
statusstringΓια 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_idUUIDΗ μετεγκατάσταση
vendorstringretell, vapi, elevenlabs ή bland
reasonstringours_failed_burst (3 αποτυχημένες συνδέσεις σε 15 λεπτά), dropped_calls (2 κλήσεις τερματίστηκαν πριν απαντήσει ο πράκτορας, εντός 30 λεπτών) ή rate_gap (διαφορά στο ποσοστό αποτελέσματος εργασίας για τουλάχιστον rollback_min_calls αξιολογημένες κλήσεις ανά πλευρά)
previous_percentintegerΤο μερίδιο κλήσεων του ThunderPhone πριν από την επαναφορά
ours_percentintegerΠάντα 0
stepinteger | nullΤο βήμα του χρονοδιαγράμματος στο οποίο βρισκόταν (με αρίθμηση από το 0)
ours / theirsobject | nullΑξιολογημένες κλήσεις στο τρέχον βήμα και το ποσοστό επιτυχίας τους· το theirs μπορεί να αφορά τις τελευταίες 30 ημέρες όταν το βήμα έχει πολύ λίγες κλήσεις. null όταν δεν υπήρχαν
ours_failedintegerΑποτυχημένες συνδέσεις που καταμετρήθηκαν στα τελευταία 15 λεπτά
droppedintegerΚλήσεις που καταμετρήθηκαν ως τερματισμένες στα τελευταία 30 λεπτά
rolled_back_attimestamp

Σχετικά