Διαχείριση εισερχόμενων κλήσεων (API)

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

Η καθιερωμένη ροή «απαντήστε σε ένα τηλέφωνο με AI», από το τερματικό σας. Θα:

1. Δημιουργήσετε έναν πράκτορα με προτροπή και φωνή.
2. Παρέχετε (ή προσθέσετε) έναν τηλεφωνικό αριθμό και θα ορίσετε τον πράκτορα ως χειριστή εισερχόμενων κλήσεων.
3. Καλέσετε τον αριθμό. Παρακολουθήσετε το αρχείο καταγραφής κλήσεων, την απομαγνητοφώνηση και την εγγραφή.

Συνολικές κλήσεις API: τέσσερις. Συνολικός χρόνος: λιγότερο από πέντε λεπτά.

1. Δημιουργήστε έναν πράκτορα#

Ένας πράκτορας συνδυάζει την προτροπή, τη φωνή και τη βαθμίδα προϊόντος που θα διαχειρίζονται την κλήση. Δείτε τους Πράκτορες για κάθε πεδίο διαμόρφωσης· τα ελάχιστα απαιτούμενα είναι:

curl -X POST https://api.thunderphone.com/v1/agents \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name":    "Acme Support",
    "prompt":  "You are a friendly support agent for Acme. Help callers with orders and returns. Keep answers short.",
    "voice":   "john",
    "product": "spark"
  }'

Αποθηκεύστε το id που επιστρέφεται — θα το χρειαστείτε στο βήμα 2.

2. Αποκτήστε έναν τηλεφωνικό αριθμό#

Αν χρειάζεστε απλώς έναν αριθμό για να καλέσετε, αποκτήστε έναν αριθμό ThunderPhone από το σύνολο αριθμών του ThunderPhone:

curl -X POST https://api.thunderphone.com/v1/phone-numbers \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"area_code": "415"}'

Η απάντηση περιλαμβάνει ένα id και έναν number σε μορφή E.164. Οι αριθμοί ThunderPhone ξεκινούν με status="provisioning" και γίνονται active μέσα σε λίγα δευτερόλεπτα — κάντε περιοδικό έλεγχο στο GET /v1/phone-numbers/{id} για να παρακολουθήσετε τη μετάβαση, αν σας ενδιαφέρει.

3. Αναθέστε τον πράκτορα#

Συσχετίστε τον πράκτορα από το βήμα 1 με την εισερχόμενη κατεύθυνση του αριθμού:

curl -X PATCH https://api.thunderphone.com/v1/phone-numbers/{phone_id} \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"inbound_agent_id": 12}'

Αυτό ήταν — ο αριθμός είναι ενεργός. Μπορείτε επίσης να ορίσετε το outbound_agent_id στο ίδιο PATCH ώστε ο αριθμός να είναι έτοιμος και για εξερχόμενες κλήσεις.

4. Δεχτείτε μια κλήση#

Καλέστε τον αριθμό από το τηλέφωνό σας. Ο πράκτορας απαντά, συστήνεται σύμφωνα με την προτροπή σας και η συνομιλία ξεκινά.

Ενώ η κλήση βρίσκεται σε εξέλιξη, εμφανίζεται στο GET /v1/calls με status="in_progress". Όταν τελειώσει, η εγγραφή ενημερώνεται με end_reason, duration_seconds, billable_minutes και, τελικά, ένα URL εγγραφής και βαθμολογία AI.

5. Ελέγξτε τα αποτελέσματα#

Ανακτήστε τη λίστα πρόσφατων κλήσεων:

curl 'https://api.thunderphone.com/v1/calls?limit=5' \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"

Ανακτήστε την απομαγνητοφώνηση:

curl https://api.thunderphone.com/v1/calls/{call_id}/transcript \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"

Και το URL εγγραφής (βραχύβιο, υπογεγραμμένο):

curl https://api.thunderphone.com/v1/calls/{call_id}/audio \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY"

Αν έχετε εγγραφεί στο telephony.complete webhook, θα λάβετε τα ίδια δεδομένα ως POST στον διακομιστή σας — δείτε call.complete.

Επόμενα βήματα#