# Κλειδιά API

Τα κλειδιά API είναι προαιρετικά. Ολοκληρώστε την [εγγραφή](https://docs.voicelogica.ai/el/getting-started/sign-up/), τη [συνδρομή](https://docs.voicelogica.ai/el/getting-started/activate-subscription/) και [τον πρώτο σας agent](https://docs.voicelogica.ai/el/getting-started/your-first-agent/) πριν τα χρειαστείτε.

Είναι προγραμματιστικά διαπιστευτήρια για το Voice Logica API. Κάθε κλειδί περιορίζεται στις λειτουργίες που επιτρέπετε και μπορεί να περιοριστεί σε μία διεύθυνση IP. Το ίδιο κλειδί υπογράφει επίσης MCP clients (ChatGPT, Claude) στον χώρο εργασίας σας.

Ανοίξτε το **Team and access** από την ομάδα Account στην πλαϊνή στήλη, στη συνέχεια επιλέξτε την καρτέλα **API Keys**. Αυτή η σελίδα έχει επίσης **Members**, **Pending invitations** και **Access Requests**.

> **Note:** Τα κλειδιά για παρόχους AI (OpenAI, ElevenLabs, ...) βρίσκονται στη σελίδα **AI Provider Keys**, όχι εδώ.
## Δημιουργία κλειδιού API

1. **Ανοίξτε τα API Keys και ξεκινήστε ένα νέο κλειδί**

   Στην καρτέλα **API Keys**, πατήστε **+ Api Key**.

     ![Καρτέλα API Keys με κουμπί + Api Key](https://docs.voicelogica.ai/assets/getting-started/api-keys-0.png)

2. **Επιλέξτε ένα preset, ονομάστε το κλειδί και ορίστε μια IP αν χρειάζεται**

   Το drawer **Create API key** ανοίγει στα δεξιά.

   - **Preset** - ξεκινήστε από πλήρη πρόσβαση (κάθε λειτουργία) ή άλλο preset, στη συνέχεια βελτιώστε παρακάτω.
   - **API Key Name** - χρησιμοποιήστε ένα σαφές όνομα σκοπού όπως `CRM Integration`, `Webhook Handler` ή `Initiate Call`.
   - **IP Address** - προαιρετικό. Αφήστε το κενό για να επιτρέπεται οποιαδήποτε IP. Εισαγάγετε μόνο μια πραγματική διεύθυνση όταν ο καλών έχει σταθερή IP. Μην εισάγετε `0.0.0.0` ως υποκατάστατο για "οποιαδήποτε IP"· το κενό σημαίνει ήδη οποιαδήποτε IP.

     ![Drawer Create API key με όνομα CRM Integration](https://docs.voicelogica.ai/assets/getting-started/api-keys-1.png)

3. **Επιλέξτε τις επιτρεπόμενες λειτουργίες**

   Στο **API operation restrictions**, αναπτύξτε κάθε ομάδα και εναλλάξτε τι μπορεί να καλέσει αυτό το κλειδί. Οι ομάδες περιλαμβάνουν **Calls**, **Agents**, **Workflows**, **VoIP & SIP**, **SMS**, **MCP**, **Billing**, **Shopify** και **Campaigns**. Αφήστε τα όλα ενεργά για πλήρη πρόσβαση, ή απενεργοποιήστε αυτά που δεν χρειάζεται το κλειδί.

     ![Ομάδες περιορισμών λειτουργιών API](https://docs.voicelogica.ai/assets/getting-started/api-keys-2.png)

4. **Δημιουργήστε το κλειδί και αντιγράψτε το μία φορά**

   Πατήστε **Create API Key**. Ο διάλογος **Copy your API key** εμφανίζει την πλήρη τιμή μόνο αυτή τη μία φορά. Πατήστε **Copy**, αποθηκεύστε το κλειδί κάπου με ασφάλεια, στη συνέχεια πατήστε **Done**.

     ![Διάλογος Copy your API key](https://docs.voicelogica.ai/assets/getting-started/api-keys-3.png)

> **Το κλειδί εμφανίζεται μόνο μία φορά:** Αφού κλείσετε αυτόν τον διάλογο, ο πίνακας εμφανίζει μόνο ένα καλυμμένο κλειδί. Δεν μπορείτε να δείτε ξανά την πλήρη τιμή. Αν το χάσετε, ανακαλέστε το κλειδί και δημιουργήστε νέο.
> **Ελάχιστα προνόμια:** Παραχωρήστε μόνο τις λειτουργίες που χρειάζεται ένα κλειδί, χρησιμοποιήστε ξεχωριστό κλειδί ανά ενσωμάτωση και ορίστε περιορισμό IP όταν ο καλών έχει σταθερή διεύθυνση. Αν ένα κλειδί εκτεθεί, ανακαλέστε το αμέσως.
## Διαχείριση των κλειδιών σας

Ο πίνακας απαριθμεί το **Name** (όνομα), το καλυμμένο **Key** (κλειδί), το **Last Used** (τελευταία χρήση) και την ημερομηνία **Created** (δημιουργίας) κάθε κλειδιού. Χρησιμοποιήστε την αναζήτηση για να βρείτε ένα κλειδί με το όνομα.

  ![Πίνακας κλειδιών API με CRM Integration](https://docs.voicelogica.ai/assets/getting-started/api-keys-4.png)

- **Edit** (μολύβι) - αλλάξτε το όνομα, τον περιορισμό IP και τις επιτρεπόμενες λειτουργίες. Η ίδια η μυστική τιμή δεν εμφανίζεται ποτέ ξανά και δεν μπορεί να εναλλαγεί επιτόπου.
- **Revoke** (κάδος) - ανοίγει το **Revoke API key?** Επιβεβαιώστε με **Revoke** για να αφαιρέσετε οριστικά το κλειδί. Οι εφαρμογές που το χρησιμοποιούν χάνουν αμέσως την πρόσβαση. Δεν υπάρχει ξεχωριστή ενέργεια Delete.

## Χρήση του κλειδιού API σας

Πιστοποιήστε τα αιτήματα στέλνοντας το κλειδί στην κεφαλίδα `x-api-key`:

```
x-api-key: YOUR_API_KEY
```

Για παράδειγμα, έναρξη εξερχόμενης κλήσης AI:

```bash
curl -X POST https://api.voicelogica.ai/api/v1/phones/calls/initiate-call \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "destinationNumber": "+302101234567",
    "agentId": "your-agent-id",
    "voipPhoneId": "your-voip-phone-id"
  }'
```

Το `destinationNumber` είναι υποχρεωτικό· περάστε `agentId` για εξερχόμενες κλήσεις AI, και είτε `voipPhoneId` είτε `sipTrunkId` για να επιλέξετε τη γραμμή από την οποία εξέρχεται η κλήση. Η πλήρης διαδραστική αναφορά για κάθε endpoint βρίσκεται στο [api.voicelogica.ai/api-docs](https://api.voicelogica.ai/api-docs).

> **Note:** Οι εξερχόμενες κλήσεις σέβονται από προεπιλογή τους κανόνες κλήσεων της χώρας προορισμού - για παράδειγμα καμία κλήση μεταξύ 21:00-09:00 τοπική ώρα. Το API εκθέτει ρητές σημαίες παράκαμψης αν η περίπτωση χρήσης σας το απαιτεί· οι εισερχόμενες κλήσεις δεν περιορίζονται ποτέ.
## Αντιμετώπιση προβλημάτων

**Τα αιτήματά μου επιστρέφουν 401 Unauthorized**

- Επιβεβαιώστε ότι το κλειδί αποστέλλεται στην κεφαλίδα `x-api-key` - όχι ως token `Bearer`.
- Ελέγξτε ότι το κλειδί δεν έχει ανακληθεί από τον πίνακα API Keys.
- Αν το κλειδί έχει περιορισμό IP, επαληθεύστε ότι το αίτημα προέρχεται από αυτήν ακριβώς τη διεύθυνση.

**Τα αιτήματά μου επιστρέφουν 403 Forbidden**

- Οι περιορισμοί λειτουργιών του κλειδιού δεν περιλαμβάνουν το endpoint που καλείτε - επεξεργαστείτε το κλειδί και ενεργοποιήστε τη σχετική ομάδα λειτουργιών.

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

> **Χτίστε πάνω στο API:** Εξερευνήστε τη [διαδραστική αναφορά API](https://api.voicelogica.ai/api-docs), στη συνέχεια αυτοματοποιήστε με [Workflow Triggers](https://docs.voicelogica.ai/el/workflows/) - ή συνδέστε έναν MCP client όπως το ChatGPT ή το Claude στον χώρο εργασίας σας χρησιμοποιώντας το ίδιο κλειδί.
## Χρειάζεστε βοήθεια;

Αν αντιμετωπίσετε οποιοδήποτε πρόβλημα, η ομάδα υποστήριξης του Voice Logica είναι διαθέσιμη:

- EMAIL [support@voicelogica.ai](mailto:support@voicelogica.ai)
- ΠΡΟΓΡΑΜΜΑΤΙΣΤΕΣ [developers@voicelogica.ai](mailto:developers@voicelogica.ai)
- ΑΝΑΦΟΡΑ API [api.voicelogica.ai/api-docs](https://api.voicelogica.ai/api-docs)