# Συσκευή edge

Η συσκευή edge είναι ένας μικρός σύνδεσμος (connector) που εγκαθιστάτε μέσα στο δίκτυο του πελάτη. Επιτρέπει στη Voice Logica να φτάσει σε τηλεφωνικό κέντρο (PBX) χωρίς δημόσια διεύθυνση - ένα τοπικό PBX σε `192.168.x.x`, `10.x.x.x` ή `172.16-31.x.x`.

Κάνει μόνο **εξερχόμενες** συνδέσεις. Δεν χρειάζεται να ανοίξετε θύρες, να κάνετε port forwarding ή να δώσετε δημόσια IP στο PBX.

## Τη χρειάζεστε;

| Το PBX ή ο πάροχος είναι... | Τι χρησιμοποιείτε |
|---|---|
| Στο LAN του γραφείου, μόνο με ιδιωτική IP | **Συσκευή edge** (αυτή η σελίδα) και μετά trunk **PBX με τοπική IP** |
| Προσβάσιμο από το διαδίκτυο (δημόσια IP ή hostname) | [Ο δικός σας πάροχος](https://docs.voicelogica.ai/el/telephony/your-own-carrier/) - **PBX με δημόσια IP** |
| Πάροχος SIP (Yuboto, Telnyx, Twilio...) | [Ο δικός σας πάροχος](https://docs.voicelogica.ai/el/telephony/your-own-carrier/) - **Πάροχος VoIP** |
| Κάνει εγγραφή σε εμάς (το PBX καλεί προς τα έξω) | [Ο δικός σας πάροχος](https://docs.voicelogica.ai/el/telephony/your-own-carrier/) - **Εισερχόμενο PBX** |

Αν γράψετε ιδιωτική διεύθυνση σε trunk **PBX με δημόσια IP**, το συρτάρι τη μπλοκάρει και προτείνει **μετάβαση σε PBX με τοπική IP**. Αυτό σημαίνει ότι χρειάζεστε συσκευή edge.

## Πώς λειτουργεί

1. Η συσκευή κρατά μια σύνδεση ελέγχου προς το `calls.voicelogica.ai` μέσω **TCP 443** (ασφαλές WebSocket).
2. Ανοίγει ένα tunnel **WireGuard** προς τη Voice Logica μέσω **UDP 51820**. Το SIP και ο ήχος των κλήσεων περνούν μέσα από αυτό.
3. Στην πλευρά του LAN μιλά με το PBX όπως κάθε άλλο τηλέφωνο ή trunk SIP.

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

## Απαιτήσεις δικτύου

Στείλτε αυτή τη λίστα σε όποιον διαχειρίζεται το firewall **πριν** από την ημέρα εγκατάστασης.

1. Ένα **μηχάνημα που μένει πάντα ανοιχτό** στο ίδιο δίκτυο με το PBX: υπολογιστής Windows, Linux ή Raspberry Pi, ή εικονική μηχανή. Όχι laptop που κοιμάται ή φεύγει από το γραφείο.
2. **Εξερχόμενο TCP 443** προς `calls.voicelogica.ai`. Το όνομα πρέπει να επιλύεται - φιλτράρισμα DNS που μπλοκάρει το domain μας σταματά την εγγραφή της συσκευής.
3. **Εξερχόμενο UDP 51820** προς `calls.voicelogica.ai`. Χωρίς αυτό η συσκευή φαίνεται σε σύνδεση, αλλά οι κλήσεις δεν έχουν ήχο.
4. **Όλο το UDP και προς τις δύο κατευθύνσεις** μεταξύ συσκευής και PBX. Ένας κανόνας μόνο για τη θύρα 5060 δεν αρκεί - ο ήχος χρησιμοποιεί μεταβαλλόμενες θύρες.
5. **Καμία εισερχόμενη θύρα**, κανένα port forwarding, καμία δημόσια IP.

Πλήρες φύλλο δικτύου για το IT: [απαιτήσεις δικτύου](https://voicelogica.s3.eu-north-1.amazonaws.com/edge/network-requirements.html) (στα Αγγλικά).

## Εγκατάσταση της συσκευής

Μπορείτε να ξεκινήσετε από δύο σημεία. Και τα δύο δίνουν την ίδια συσκευή:

- **Τηλεφωνία - Trunks - Προσθήκη trunk - PBX με τοπική IP.** Το συρτάρι δείχνει **Κατεβάστε τον σύνδεσμο** με **Windows**, **Linux** και **Εικόνα VM**, και μετά περιμένει τη συσκευή. Χρησιμοποιήστε το όταν συνδέετε PBX τώρα.
- **Συσκευές PBX Edge** (`app.voicelogica.ai/phones/edge-devices`) - **Προσθήκη συσκευής edge**. Χρησιμοποιήστε το για να ετοιμάσετε συσκευή από πριν ή για **Αποστολή οδηγιών στον πελάτη με email** όταν την εγκατάσταση την κάνει κάποιος άλλος επί τόπου.

  <ShotPlaceholder
    src="/assets/telephony/edge-devices.png"
    name="edge-devices"
    alt="Λίστα Συσκευές PBX Edge με στήλες κατάστασης, σύνδεσης και PBX"
    capture="PBX Edge Devices list."
  />

Στο **Προσθήκη συσκευής edge** δώστε **Ετικέτα τοποθεσίας** (το όνομα του γραφείου, π.χ. «Κεντρικά γραφεία»), επιλέξτε **Πλατφόρμα** και μετά **Θα το εγκαταστήσω τώρα** ή **Αποστολή οδηγιών στον πελάτη με email**. Το κύριο κουμπί αλλάζει ανάλογα.

<Tabs>
<TabItem label="Windows">

1. Επιλέξτε **Windows** και πατήστε **Λήψη εγκαταστάτη**. Το `.exe` φτιάχνεται για την εταιρεία σας - το διακριτικό είναι ήδη μέσα, δεν πληκτρολογείτε τίποτα.
2. Μεταφέρετέ το στον υπολογιστή Windows δίπλα στο PBX. Εκτελέστε το και αποδεχτείτε τις ερωτήσεις.
3. Εγκαθιστά το WireGuard και τον σύνδεσμο ως υπηρεσία και συνδέεται μόνος του. Ξεκινά ξανά μετά από επανεκκίνηση.

Ο σύνδεσμος λήψης ισχύει για **4 ώρες**. Μετά κατεβάστε νέο (**Κατέβασμα Windows ξανά** στο συρτάρι του trunk).

Αν το antivirus ή πολιτική του browser μπλοκάρει το `.exe`, τρέξτε αντί γι' αυτό την εντολή σε PowerShell ως **Administrator**:

```powershell
$env:EDGE_TOKEN='<token>'; irm https://calls.voicelogica.ai/install.ps1 | iex
```

Το Claude ή το ChatGPT σάς δίνει αυτή τη γραμμή με το διακριτικό ήδη συμπληρωμένο - δείτε [Ή αφήστε το Claude να το κάνει](#ή-αφήστε-το-claude-να-το-κάνει).

</TabItem>
<TabItem label="Linux / Raspberry Pi">

1. Επιλέξτε **Linux / Raspberry Pi** και πατήστε **Λήψη εντολής**.
2. Αντιγράψτε τη γραμμή και τρέξτε τη στο μηχάνημα Linux:

   ```bash
   curl -fsSL https://calls.voicelogica.ai/install.sh | sudo bash -s -- --token <token>
   ```

3. Χρειάζεται `curl` και `sudo`. Χρησιμοποιεί **Docker** και το εγκαθιστά αν λείπει.

Στο τέλος το script κάνει σύντομο προέλεγχο - DNS, TCP 443 και τοπικό firewall - και τυπώνει ένα μπλοκ για το IT αν κάτι αποτύχει. Διαβάστε το πριν αφήσετε το μηχάνημα.

Το διακριτικό στην εντολή ισχύει για **72 ώρες**.

</TabItem>
<TabItem label="Εικονική μηχανή">

1. Επιλέξτε **Εικονική μηχανή** και πατήστε **Λήψη συσκευής**.
2. Η σελίδα που ανοίγει έχει την εικόνα για **VirtualBox**, **VMware** ή **Proxmox** και τα βήματα εισαγωγής.
3. Δώστε στην εικονική μηχανή κάρτα δικτύου σε **bridged** λειτουργία στο δίκτυο του PBX, όχι NAT, ώστε να πάρει διεύθυνση στο ίδιο LAN.
4. Ξεκινήστε την εικονική μηχανή. Μέσα σε ένα λεπτό η οθόνη της κονσόλας δείχνει **Claim code** και έναν κωδικό όπως `7K2M-9QXR`.
5. Στις **Συσκευές PBX Edge**, πατήστε **Προσθήκη συσκευής edge**, επιλέξτε **Εικονική μηχανή**, γράψτε τον κωδικό στο **Κωδικός διεκδίκησης** και πατήστε **Προσθήκη συσκευής**. Ή δώστε τον κωδικό στο Claude ή στο ChatGPT: *«Πρόσθεσε τη συσκευή edge μου, ο κωδικός είναι 7K2M-9QXR.»*

Η εικονική μηχανή κατεβαίνει χωρίς εταιρεία, οπότε ο κωδικός είναι ο τρόπος να μπει στη δική σας. Ισχύει για **24 ώρες** από την πρώτη εκκίνηση. Μόλις προστεθεί η συσκευή, ο κωδικός εξαφανίζεται από την οθόνη.

</TabItem>
</Tabs>

## Περιμένετε να συνδεθεί

Το διακριτικό συνδέει τη συσκευή με την εταιρεία σας, οπότε εγκρίνεται αυτόματα. Η εικονική μηχανή εγκρίνεται όταν την προσθέσετε με τον κωδικό της. Παρακολουθήστε τη στις **Συσκευές PBX Edge** (η λίστα ανανεώνεται μόνη της) ή στο συρτάρι του trunk:

- **Κατάσταση** — **Σε αναμονή** - μόλις καταχωρήθηκε. **Εγκεκριμένο** / **Ενεργό** - έτοιμη για χρήση. **Ανακλημένο** - δεν χρησιμοποιείται· εγκαταστήστε νέα.
- **Σε σύνδεση** — **Σε σύνδεση** όταν η συσκευή κρατά τη σύνδεση ελέγχου.
- **PBX** — Η διεύθυνση PBX που χρησιμοποιεί η συσκευή, ή **Δεν έχει οριστεί**.

Στο συρτάρι του trunk η ένδειξη αλλάζει από **Δεν συνδέθηκε** σε **Live** και εμφανίζονται τα **Επόμενα βήματα**. Το **Ανανέωση συσκευών** ελέγχει αμέσως.

> **Σε σύνδεση δεν σημαίνει ότι λειτουργεί:** Το **Σε σύνδεση** αποδεικνύει μόνο το TCP 443. Ο ήχος χρειάζεται το tunnel WireGuard στο UDP 51820. Όταν η θύρα είναι κλειστή, το συρτάρι δείχνει **Συνδέθηκε, αλλά το tunnel είναι κάτω (UDP 51820)**. Διορθώστε το firewall πριν δημιουργήσετε το trunk.
## Σύνδεση του PBX

1. **Τηλεφωνία - Trunks - Προσθήκη trunk - PBX με τοπική IP**

   Ονομάστε το trunk από την τοποθεσία. Αν η συσκευή είναι ήδη **Live**, η φόρμα ξεκλειδώνει αμέσως.

2. **Επιλέξτε το PBX**

   Στα **Προτεινόμενα PBX στο LAN** πατήστε **Εύρεση PBX**. Η συσκευή σαρώνει τα υποδίκτυά της για SIP hosts. Πατήστε μια πρόταση ή γράψτε μόνοι σας την τοπική IP του PBX.

3. **Ορίστε τη θύρα SIP αν δεν είναι 5060**

   **Σύνθετες ρυθμίσεις - Θύρα**. Μερικά PBX ακούνε αλλού - το Alcatel OXO συχνά χρησιμοποιεί **5059**. Ρωτήστε τον διαχειριστή του PBX αν δεν είστε σίγουροι.

4. **Δοκιμή τώρα**

   Στέλνει SIP OPTIONS στο PBX μέσω της συσκευής. Οποιαδήποτε απάντηση - ακόμη και **401/407** (ζητά διαπιστευτήρια) - σημαίνει ότι το SIP περνάει. **Καμία απάντηση SIP** σημαίνει λάθος IP ή θύρα, ή κάτι ανάμεσα σε συσκευή και PBX κόβει το SIP.

5. **Διαπιστευτήρια**

   Το εσωτερικό (ή ο λογαριασμός SIP trunk) που δημιούργησε το PBX για τη Voice Logica: **Όνομα χρήστη**, **Σύνθημα** και **Είσοδος (Αναγνωριστικό εξουσιοδότησης)** αν το PBX χρησιμοποιεί ξεχωριστό.

6. **Προορισμός και Δημιουργία trunk**

   Στείλτε τις κλήσεις χωρίς δρομολόγηση στον AI agent σας. **Δημιουργία trunk**. Η εγγραφή πρέπει να δείξει online μέσα σε ένα λεπτό.

7. **Στείλτε κλήσεις στον agent και καλέστε**

   Στο PBX δρομολογήστε έναν αριθμό ή μια ουρά / εσωτερικό προς το νέο trunk, συνδέστε τον στον agent στο **Κανάλια - Τηλεφωνία** και καλέστε από πραγματικό τηλέφωνο. Ελέγξτε τις **Κλήσεις**. Για αριθμούς και προεπιλεγμένο προορισμό δείτε [Ο δικός σας πάροχος](https://docs.voicelogica.ai/el/telephony/your-own-carrier/).

  <ShotPlaceholder
    src="/assets/telephony/edge-trunk.png"
    name="edge-trunk"
    alt="Συρτάρι νέου SIP trunk, PBX με τοπική IP, με τον σύνδεσμο Live και προτεινόμενα PBX"
    capture="Trunk drawer Local IP PBX, connector Live."
  />

Για να αλλάξετε αργότερα τη διεύθυνση PBX μιας συσκευής, πατήστε το εικονίδιο ρυθμίσεων (**Ρύθμιση παραμέτρων PBX**) στη γραμμή της στις **Συσκευές PBX Edge** - **Διεύθυνση IP PBX** και **Θύρα SIP**, μετά **Αποθήκευση**. Η αποστολή νέων ρυθμίσεων επανεκκινεί το SIP relay της συσκευής, οπότε κάντε το εκτός ενεργής κλήσης.

## Ή αφήστε το Claude να το κάνει

Αν έχετε [συνδέσει το Claude ή το ChatGPT με τη Voice Logica](https://docs.voicelogica.ai/el/integrations/claude-chatgpt/), πείτε **«σύνδεσε το τηλεφωνικό μου κέντρο»**. Ο βοηθός σάς δίνει τον σύνδεσμο λήψης για Windows (ή την εντολή Linux) με το διακριτικό μέσα, βλέπει πότε η συσκευή συνδέεται, ζητά IP, θύρα SIP και στοιχεία του εσωτερικού, και δημιουργεί το trunk μέσω της συσκευής. Αναλυτικά: [Συνδέστε το PBX σας από το Claude](https://docs.voicelogica.ai/el/integrations/claude-chatgpt/#συνδέστε-το-pbx-σας-από-το-claude).

## Αντιμετώπιση προβλημάτων

**Η συσκευή είναι σε σύνδεση αλλά οι κλήσεις δεν έχουν ήχο**

Το tunnel είναι κάτω. Το firewall της τοποθεσίας πρέπει να επιτρέπει **εξερχόμενο UDP 51820** προς `calls.voicelogica.ai`. Το συρτάρι του trunk γράφει **Συνδέθηκε, αλλά το tunnel είναι κάτω (UDP 51820)**· το Claude αναφέρει `tunnelUp: false`.

Αν το tunnel είναι πάνω και ο ήχος λείπει και από τις δύο πλευρές:

1. Το firewall ανάμεσα σε συσκευή και PBX αφήνει **όλο το UDP**, όχι μόνο το 5060.
2. Σε Linux, ένα host firewall με default-deny κόβει τον ήχο. Τρέξτε `ufw allow in on wg0` στη συσκευή.

**Η συσκευή δεν συνδέεται ποτέ**

1. Ο εγκαταστάτης ολοκληρώθηκε και το μηχάνημα είναι ανοιχτό (όχι σε αναστολή).
2. Επιτρέπεται **εξερχόμενο TCP 443** προς `calls.voicelogica.ai`.
3. Το όνομα επιλύεται - το φιλτράρισμα DNS / web συχνά μπλοκάρει νέα domains. Βάλτε σε allowlist τα `calls.voicelogica.ai` και `voicelogica.ai`.
4. Ο σύνδεσμος Windows (4 ώρες) ή το διακριτικό εγκατάστασης (72 ώρες) δεν είχε λήξει. Αν έχετε αμφιβολία, δημιουργήστε νέο.

**Το Δοκιμή τώρα δείχνει Καμία απάντηση SIP**

Λάθος IP ή θύρα, ή το PBX αγνοεί τη συσκευή. Επιβεβαιώστε τη θύρα SIP του PBX - δεν είναι πάντα 5060 (Alcatel OXO: 5059) - και ορίστε τη στο **Σύνθετες ρυθμίσεις - Θύρα**. Το **403 Forbidden** σημαίνει ότι το SIP φτάνει αλλά το PBX απορρίπτει την πηγή: επιτρέψτε την τοπική διεύθυνση της συσκευής στις ρυθμίσεις SIP / trunk του PBX.

**Το Claude λέει ότι το PBX δεν είναι προσβάσιμο, αλλά η δοκιμή δουλεύει**

Το **PBX reachable** είναι ένα ping από τη συσκευή. Πολλά δίκτυα και PBX μπλοκάρουν το ping ενώ το SIP δουλεύει κανονικά. Εμπιστευτείτε το **Δοκιμή τώρα** και την εγγραφή του trunk, όχι το ping.

**Έχουμε δύο PBX σε διαφορετικά δίκτυα**

Μία συσκευή εξυπηρετεί **ένα PBX** κάθε φορά. Εγκαταστήστε δεύτερη συσκευή δίπλα στο δεύτερο PBX και δημιουργήστε δεύτερο trunk **PBX με τοπική IP** μέσω αυτής.

**Το trunk έχει εγγραφεί αλλά οι καλούντες δεν φτάνουν πουθενά**

Το PBX δεν στέλνει αυτές τις κλήσεις στο trunk ή ο αριθμός δεν είναι σε αυτόν τον agent. Ελέγξτε τη δρομολόγηση στο PBX και μετά [Ο δικός σας πάροχος](https://docs.voicelogica.ai/el/telephony/your-own-carrier/) - προεπιλεγμένος προορισμός και **Κανάλια - Τηλεφωνία**.

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

[Ο δικός σας πάροχος](https://docs.voicelogica.ai/el/telephony/your-own-carrier/) - τύποι trunk, αριθμοί, προεπιλεγμένος προορισμός.  
[Claude και ChatGPT](https://docs.voicelogica.ai/el/integrations/claude-chatgpt/) - συνδέστε το PBX σας από μια συνομιλία.  
[Routing](https://docs.voicelogica.ai/el/telephony/routing/) - όταν ένας αριθμός πρέπει να καταλήγει αλλού.  
[Transfer](https://docs.voicelogica.ai/el/telephony/transfer/) - μεταφορά κλήσεων πίσω σε ανθρώπους στο PBX.