Χειρισμός εισερχόμενων κλήσεων (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:

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. Οι αριθμοί επίδειξης ξεκινούν με 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.

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