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

Getting Started

View as Markdown
Open in
ClaudeChatGPTCursor

Γρήγορη εκκίνηση (API)

Απαντήστε στην πρώτη σας τηλεφωνική κλήση με έναν AI πράκτορα: αποκτήστε ένα κλειδί API, δημιουργήστε έναν πράκτορα, εκχωρήστε έναν αριθμό τηλεφώνου και πραγματοποιήστε μια ζωντανή δοκιμαστική κλήση — όλα μέσω του REST API.

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

Βήμα 1: Λάβετε ένα κλειδί API

  1. Συνδεθείτε

    Ανοίξτε το app.thunderphone.com.

  2. Μεταβείτε στα Κλειδιά

    Μεταβείτε στα Οργανισμός → Κλειδιά στον πίνακα ελέγχου.

  3. Δημιουργήστε ένα κλειδί

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

Σε όλον αυτόν τον οδηγό, αντικαταστήστε το sk_live_YOUR_API_KEY με την τιμή που μόλις αντιγράψατε. Το κλειδί αναγνωρίζει αυτόματα τον οργανισμό σας, επομένως δεν χρειάζεται ποτέ να τοποθετήσετε αναγνωριστικό οργανισμού σε URL.

Βήμα 2: Δημιουργήστε έναν πράκτορα

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

cURL
curl -X POST https://api.thunderphone.com/v1/agents \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name":   "Customer Support",
    "prompt": "You are a friendly support agent for Acme Corp. Help with orders, returns, and product info. Be concise and helpful.",
    "voice":  "john",
    "product": "spark"
  }'
Python
import os, requests
 
agent = requests.post(
    "https://api.thunderphone.com/v1/agents",
    headers={"Authorization": f"Bearer {os.environ['THUNDERPHONE_API_KEY']}"},
    json={
        "name":   "Customer Support",
        "prompt": "You are a friendly support agent for Acme Corp. Help with orders, returns, and product info. Be concise and helpful.",
        "voice":  "john",
        "product": "spark",
    },
).json()
print("Agent id:", agent["id"])
Node.js
const agent = await fetch("https://api.thunderphone.com/v1/agents", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.THUNDERPHONE_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    name:    "Customer Support",
    prompt:  "You are a friendly support agent for Acme Corp. Help with orders, returns, and product info. Be concise and helpful.",
    voice:   "john",
    product: "spark",
  }),
}).then((r) => r.json());
console.log("Agent id:", agent.id);

Βήμα 3: Εκχωρήστε έναν αριθμό τηλεφώνου

Αυτή η κλήση ζητά από το ThunderPhone έναν αριθμό και ορίζει τον νέο σας πράκτορα ως χειριστή εισερχόμενων κλήσεων. (Για να φέρετε τον δικό σας αριθμό από πάροχο VoIP, δείτε αντί για αυτό τις συνδέσεις VoIP.)

cURL
# First provision
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"}'
 
# Then assign the agent you created in Step 2
curl -X PATCH https://api.thunderphone.com/v1/phone-numbers/<id-from-previous> \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"inbound_agent_id": 12}'
Python
number = requests.post(
    "https://api.thunderphone.com/v1/phone-numbers",
    headers={"Authorization": f"Bearer {os.environ['THUNDERPHONE_API_KEY']}"},
    json={"area_code": "415"},
).json()
requests.patch(
    f"https://api.thunderphone.com/v1/phone-numbers/{number['id']}",
    headers={"Authorization": f"Bearer {os.environ['THUNDERPHONE_API_KEY']}"},
    json={"inbound_agent_id": agent["id"]},
)
print("Your ThunderPhone number:", number["number"])

Ο νέος σας αριθμός ξεκινά με status="provisioning" και μεταβαίνει σε active μέσα σε λίγα δευτερόλεπτα· μέχρι να κλείσετε το πρόγραμμα περιήγησής σας, ο αριθμός είναι έτοιμος να δέχεται κλήσεις.

Βήμα 4 (προαιρετικό): Ρυθμίστε ένα webhook

Για συμβάντα σε πραγματικό χρόνο (δυναμική δρομολόγηση κλήσεων, επεξεργασία μετά την κλήση), προσθέστε ένα endpoint webhook. Εγγραφείτε μόνο στα συμβάντα που χρειάζεστε.

curl -X POST https://api.thunderphone.com/v1/developer/webhook-endpoints \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "label":  "Prod webhook",
    "url":    "https://your-server.com/thunderphone-webhook",
    "events": ["telephony.incoming", "telephony.complete"]
  }'

Η απόκριση περιέχει ένα secret μίας χρήσης — αντιγράψτε το στον διαχειριστή μυστικών σας. Χρησιμοποιήστε αυτό το μυστικό για να επαληθεύσετε την κεφαλίδα X-ThunderPhone-Signature στα εισερχόμενα αιτήματα (δείτε την επισκόπηση Webhooks).

Βήμα 5: Δοκιμάστε τον πράκτορά σας

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

Ελέγξτε την κλήση αφού ολοκληρωθεί:

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

Εξετάστε μια συγκεκριμένη κλήση για να ανακτήσετε τη διεύθυνση URL της απομαγνητοφώνησης και της εγγραφής:

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

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

Προσθήκη εργαλείων συναρτήσεων

Επιτρέψτε στον πράκτορά σας να καλεί τα API σας κατά τη διάρκεια μιας συνομιλίας.

Πραγματοποίηση εξερχόμενων κλήσεων

Ενεργοποιήστε κλήσεις από τον δικό σας κώδικα.

Διαχείριση webhooks

Αντιδράστε σε συμβάντα κλήσεων σε πραγματικό χρόνο.

Πλήρης αναφορά API

Κάθε δημόσιο endpoint, τεκμηριωμένο.