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

<Note>
  Δημιουργείτε τον πρώτο σας πράκτορα χειροκίνητα; Ο πίνακας ελέγχου σας καθοδηγεί σε αυτήν ακριβώς
  τη ροή — δημιουργία του πράκτορα, προσθήκη αριθμού, προσομοίωση, έλεγχος — με έναν
  καθοδηγούμενο οδηγό. Ξεκινήστε από τον
  [γρήγορο οδηγό του πίνακα ελέγχου](/el/quickstart-dashboard).
</Note>

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

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

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

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

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

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

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

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

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

```bash
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}`](/api-reference/phone-numbers#retrieve-a-phone-number)
για να παρακολουθήσετε τη μετάβαση, αν σας ενδιαφέρει.

<Note>
  Οι αριθμοί ThunderPhone είναι μόνο για εισερχόμενες κλήσεις. Για εξερχόμενες κλήσεις,
  [προσθέστε τους δικούς σας αριθμούς μέσω VoIP](/el/guides/bring-your-own-numbers).
</Note>

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

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

```bash
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`](/api-reference/calls#list-calls) με
`status="in_progress"`. Όταν τελειώσει, η εγγραφή ενημερώνεται με
`end_reason`, `duration_seconds`, `billable_minutes` και, τελικά,
ένα URL εγγραφής και βαθμολογία AI.

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

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

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

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

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

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

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

Αν έχετε εγγραφεί στο
[`telephony.complete` webhook](/el/webhooks/events),
θα λάβετε τα ίδια δεδομένα ως POST στον διακομιστή σας — δείτε
[call.complete](/el/webhooks/call-complete).

---

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

<CardGroup cols={2}>
  <Card title="Δυναμική διαμόρφωση ανά κλήση" icon="bolt" href="/el/guides/dynamic-call-config">
    Επιλέξτε διαφορετικό πράκτορα για κάθε καλούντα με βάση τον αριθμό τηλεφώνου ή
    προσαρμοσμένη λογική σε ένα webhook.
  </Card>
  <Card title="Προσθέστε ενσωματώσεις εργαλείων" icon="screwdriver-wrench" href="/el/guides/build-tool-integration">
    Επιτρέψτε στον πράκτορα να καλεί τα API σας κατά τη διάρκεια της συνομιλίας.
  </Card>
  <Card title="Μεταφέρετε κλήσεις" icon="phone-arrow-right" href="/el/guides/call-transfers">
    Δρομολογήστε τους καλούντες απευθείας ή ελέγξτε τον προορισμό πριν τους συνδέσετε.
  </Card>
  <Card title="Λάβετε webhooks call.complete" icon="bolt" href="/el/webhooks/call-complete">
    Μεταδώστε κάθε ολοκληρωμένη κλήση στο CRM / pipeline αναλύσεών σας.
  </Card>
  <Card title="Βαθμολόγηση AI και αναφορές προβλημάτων" icon="chart-line" href="/api-reference/calls#ai-call-grading">
    Βαθμολογήστε κάθε κλήση αυτόματα και δρομολογήστε όσες επισημαίνονται για έλεγχο.
  </Card>
</CardGroup>