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

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

<Info>
  Θα χρειαστείτε έναν [λογαριασμό ThunderPhone](https://app.thunderphone.com).
  Η εγγραφή είναι δωρεάν και διαρκεί λιγότερο από ένα λεπτό. Προτιμάτε να κάνετε κλικ αντί να χρησιμοποιείτε curl;
  Ο [γρήγορος οδηγός του πίνακα ελέγχου](/el/quickstart-dashboard) σας οδηγεί στην ίδια
  πρώτη κλήση χωρίς να γράψετε κώδικα.
</Info>

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

<Steps>
  <Step title="Συνδεθείτε">
    Ανοίξτε το [app.thunderphone.com](https://app.thunderphone.com).
  </Step>
  <Step title="Μεταβείτε στα Κλειδιά">
    Μεταβείτε στα **Οργανισμός → Κλειδιά** στον πίνακα ελέγχου.
  </Step>
  <Step title="Δημιουργήστε ένα κλειδί">
    Κάντε κλικ στην επιλογή **Δημιουργία κλειδιού**, δώστε του ένα όνομα και αντιγράψτε την
    τιμή `sk_live_...`. Το ακατέργαστο κλειδί εμφανίζεται **μόνο μία φορά** — αποθηκεύστε το
    αμέσως στον διαχειριστή μυστικών σας.
  </Step>
</Steps>

<Tip>
  Έχετε κολλήσει; Η [δημιουργία κλειδιού API διακομιστή](/el/guides/api-keys) εξηγεί
  αυτήν τη ροή βήμα προς βήμα, ενώ ο ενσωματωμένος βοηθός μπορεί να
  επισημάνει κάθε στοιχείο ελέγχου για εσάς σε πραγματικό χρόνο.
</Tip>

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

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

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

<CodeGroup>
```bash 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 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"])
```

```javascript 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);
```
</CodeGroup>

<Tip>
  Βαθμίδες προϊόντος: το `spark` είναι βελτιστοποιημένο για κόστος, το `bolt` για ταχύτητα και
  τα `storm-base` / `storm-extra` για νοημοσύνη σε σύνθετες προτροπές. Δείτε τους
  [Πράκτορες](/api-reference/agents#product-tiers-at-a-glance) για την πλήρη
  σύγκριση.
</Tip>

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

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

<CodeGroup>
```bash 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 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"])
```
</CodeGroup>

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

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

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

```bash
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](/el/webhooks/overview)).

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

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

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

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

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

```bash
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"
```

---

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

<CardGroup cols={2}>
  <Card title="Προσθήκη εργαλείων συναρτήσεων" icon="screwdriver-wrench" href="/el/tools/overview">
    Επιτρέψτε στον πράκτορά σας να καλεί τα API σας κατά τη διάρκεια μιας συνομιλίας.
  </Card>
  <Card title="Πραγματοποίηση εξερχόμενων κλήσεων" icon="arrow-up-right" href="/api-reference/outbound-calls">
    Ενεργοποιήστε κλήσεις από τον δικό σας κώδικα.
  </Card>
  <Card title="Διαχείριση webhooks" icon="bolt" href="/el/webhooks/overview">
    Αντιδράστε σε συμβάντα κλήσεων σε πραγματικό χρόνο.
  </Card>
  <Card title="Πλήρης αναφορά API" icon="book" href="/api-reference/introduction">
    Κάθε δημόσιο endpoint, τεκμηριωμένο.
  </Card>
</CardGroup>