Πράκτορας ElevenLabs σε τσεχικό αριθμό μέσω SIP

Έχετε ήδη έναν πράκτορα ElevenLabs Conversational AI και θέλετε να του δώσετε έναν τσεχικό τηλεφωνικό αριθμό; Δεν υπάρχει κανένα ιδιαίτερο κόλπο: συνδέετε έναν αριθμό του volai με το SIP trunk της πλατφόρμας του πράκτορά σας. Οι εισερχόμενες κλήσεις είναι το εύκολο μέρος - ένα αίτημα PATCH στη δρομολόγηση του αριθμού. Οι εξερχόμενες λειτουργούν λίγο διαφορετικά, επειδή το ElevenLabs (όπως οι περισσότερες πλατφόρμες φωνητικού AI) δεν μπορεί να κρατά μια τηλεφωνική γραμμή μόνιμα δηλωμένη ως πελάτη SIP - στέλνει μόνο μία ταυτοποιημένη κλήση, γι' αυτό η κλήση περνά μέσω μιας βραχύβιας σύνδεσης relay. Η μεγάλη διαφορά από τον ενσωματωμένο πράκτορα του volai: στις εξερχόμενες κλήσεις δεν πληρώνετε καθόλου την επιβάρυνση πράκτορα 2,50 kr/λεπ. (≈ 0,10 EUR) - τον πράκτορα τον λειτουργείτε (και τον πληρώνετε) εσείς, στο δικό σας workspace του ElevenLabs.

Πότε έχει περισσότερο νόημα ένας δικός σας πράκτορας από τον ενσωματωμένο;

Και οι δύο διαδρομές χρεώνονται στον ίδιο αριθμό volai και στο ίδιο υπόλοιπο - αλλάζει το ποιος οδηγεί τη συζήτηση και τι κοστίζει επιπλέον:

Με άλλα λόγια: ο δικός σας πράκτορας αξίζει όταν έχετε ήδη έναν πράκτορα ElevenLabs σε λειτουργία, με δικό του prompt, εργαλεία και φωνή, και χρειάζεστε απλώς έναν τσεχικό αριθμό για αυτόν. Ξεκινάτε από το μηδέν με ένα μόνο system prompt και χωρίς ξεχωριστό workspace ElevenLabs να διαχειρίζεστε; Η ταχύτερη διαδρομή είναι ο ενσωματωμένος πράκτορας volai - ρυθμίζεται με μία κλήση API, και η απομαγνητοφώνηση και η περίληψη περιλαμβάνονται στην επιβάρυνση πράκτορα, χωρίς ξεχωριστή ρύθμιση.

Τι θα χρειαστείτε;

• Λογαριασμό volai με τσεχικό αριθμό που υπάρχει ήδη σε αυτόν, και κλειδί API (vk_...) - το βρίσκετε στην πύλη, στην ενότητα API και MCP.
• Έναν πράκτορα ElevenLabs Conversational AI που έχει ήδη δημιουργηθεί στο ΔΙΚΟ ΣΑΣ workspace - ο οδηγός τον συνδέει με έναν αριθμό, δεν τον δημιουργεί για εσάς.
• Υπόλοιπο στον λογαριασμό σας στο volai - οι κλήσεις αφαιρούνται από αυτό ακριβώς όπως με τον ενσωματωμένο πράκτορα.

Βήμα 1: Σύνδεση των εισερχόμενων κλήσεων

Ρυθμίστε τη δρομολόγηση του αριθμού σε mode: "sip" με το sipUri ορισμένο στη διεύθυνση στην οποία το ElevenLabs περιμένει κλήσεις για εισαγωγή SIP trunk:

curl -X PATCH "https://volai.cz/v1/numbers/+420601234567" \
  -H "Authorization: Bearer vk_TO_KLEIDI_SAS" \
  -H "Content-Type: application/json" \
  -d '{"routing": {"mode": "sip", "sipUri": "sip:+420601234567@sip.rtc.elevenlabs.io"}}'

Στη συνέχεια, στην πλευρά του ElevenLabs (Settings → Phone Numbers → Import → SIP trunk), δηλώστε τον αριθμό με ένα inbound_trunk_config:

{
  "provider": "sip_trunk",
  "phone_number": "+420601234567",
  "label": "Ο δικός μου πράκτορας",
  "inbound_trunk_config": {
    "allowed_addresses": ["81.31.45.0/24"],
    "media_encryption": "allowed"
  }
}

Χρεώνεται μόνο το εισερχόμενο λεπτό (0,50 kr/λεπ. (≈ 0,02 EUR)), χωρίς επιπλέον επιβάρυνση - ο ίδιος κανόνας που ακολουθούν ο ενσωματωμένος πράκτορας και ένα απλό softphone.

Βήμα 2: Σύνδεση των εξερχόμενων κλήσεων μέσω relay

Αυτή η κατεύθυνση λειτουργεί αντίστροφα - ο πράκτοράς σας καλεί μόνος του προς τα έξω. Το τηλεφωνικό δίκτυο δεν προωθεί μια κλήση από ξένη διεύθυνση SIP απευθείας στον προορισμό της, γι' αυτό περνά μέσω ενός βραχύβιου relay - μιας εφάπαξ θέσης SIP που το volai ανοίγει λίγο πριν από την κλήση και κλείνει ξανά μόλις τελειώσει. Για την πλήρη εξήγηση του γιατί λειτουργεί έτσι και πώς μοιάζει για πλατφόρμες άλλες από το ElevenLabs, δείτε τη σελίδα Δικός σας πράκτορας - εδώ είναι μόνο τα τρία βήματα που χρειάζεστε:

2.1 Στρέψτε το ElevenLabs στη γραμμή σας

Πάρτε τα στοιχεία SIP του αριθμού:

curl "https://volai.cz/v1/numbers/+420601234567/sip" \
  -H "Authorization: Bearer vk_TO_KLEIDI_SAS"

{
  "server": "sip.volai.cz",
  "username": "123456",
  "password": "a1b2c3d4e5f6",
  "outboundTrunkAddress": "sip.volai.cz",
  "port": 5060,
  "transport": "tcp",
  "inboundSignallingCidrs": ["81.31.45.0/24"]
}

Το πεδίο server προορίζεται για απλό softphone (δείτε τη σελίδα SIP), ενώ το ElevenLabs χρειάζεται το πεδίο outboundTrunkAddress (sip.volai.cz), όχι το server - αν το αντικαταστήσετε, αποτυγχάνει με 1011 sip request timed out - η διεύθυνση του εξερχόμενου trunk πρέπει να είναι ακριβώς αυτή η τιμή, αλλιώς η κλήση δεν δρομολογείται στο δίκτυο.

Έπειτα ορίστε την ως outbound_trunk_config του αριθμού στο ElevenLabs (Settings → Phone Numbers → ο αριθμός σας → Outbound calling), ακριβώς σε αυτή τη μορφή:

{
  "outbound_trunk_config": {
    "address": "sip.volai.cz",
    "transport": "tcp",
    "media_encryption": "allowed",
    "credentials": {
      "username": "123456",
      "password": "a1b2c3d4e5f6"
    }
  }
}

2.2 Ανοίξτε μια σύνδεση relay

Λίγο πριν κάνετε την κλήση - η σύνδεση είναι βραχύβια, δείτε τα όρια παρακάτω - καλέστε:

curl -X POST https://volai.cz/v1/relay \
  -H "Authorization: Bearer vk_TO_KLEIDI_SAS" \
  -H "Content-Type: application/json" \
  -d '{"to": "+420777123456", "from": "+420601234567"}'

{
  "id": "rl_4f2a91cd",
  "sipName": "volai_relay_2",
  "sipUri": "sip:volai_relay_2@sip.volai.cz",
  "expiresAt": 1756111760000,
  "callId": "c_9d4e2b7f"
}

2.3 Πείτε στον πράκτορα να καλέσει το sipName και όχι ολόκληρο το SIP URI

Για το ElevenLabs αυτό σημαίνει κλήση του /v1/convai/sip-trunk/outbound-call με το to_number ορισμένο απευθείας στο sipName:

{
  "agent_id": "agent_...",
  "agent_phone_number_id": "phnum_...",
  "to_number": "volai_relay_2"
}

Τι συμβαίνει όταν η κλήση φύγει

Από την πλευρά του δικτύου, η κλήση βγαίνει με το όνομα volai_relay_2, παραδίδεται στο to σας και εμφανίζει τον αριθμό from ως αριθμό καλούντος - όποιος σηκώσει βλέπει στην οθόνη του τη γραμμή σας στο volai, ποτέ το προσωρινό όνομα της θέσης relay (μόνο αν ο αριθμός έχει δικά του ονόματα relay - διαφορετικά ο παραλήπτης βλέπει τον δοκιμαστικό αριθμό του volai· επικοινωνήστε με την υποστήριξη). Όταν η κλήση τελειώσει, η μίσθωση ελευθερώνεται αυτόματα και χρεώνεστε με την κανονική τιμή εξερχόμενης κλήσης - 0,92 kr/λεπ. (≈ 0,04 EUR), χωρίς προσθήκη επιβάρυνσης πράκτορα.

Όρια και ασφάλεια

• Το from πρέπει να είναι δικός σας αριθμός volai - αλλιώς from_number_not_owned. Χωρίς αυτόν τον έλεγχο, οποιοσδήποτε θα μπορούσε να παραποιήσει ξένη γραμμή ως αριθμό καλούντος.
• Οι ίδιοι έλεγχοι όπως σε μια κανονική κλήση - η λίστα «μην καλείτε» (μόνο για κλήσεις, τα SMS εξαιρούνται), ο αυτόματος αποκλεισμός 30 ημερών μετά από τρεις αποτυχημένες προσπάθειες προς έναν αριθμό μέσα σε 24 ώρες και το συνηθισμένο όριο ρυθμού κλήσεων. Τίποτα από αυτά δεν παρακάμπτεται μέσω του relay.
• Η μίσθωση είναι εφάπαξ - μια δεύτερη προσπάθεια κλήσης στην ίδια μίσθωση απορρίπτεται, γι' αυτό ανοίξτε νέα για την επόμενη κλήση.
• Μια γεμάτη δεξαμενή relay απαντά με 503 capacity_busy - πρόκειται για όριο ταυτόχρονων κλήσεων που ισχύει για ΟΛΗ την πλατφόρμα volai, όχι μόνο για τον λογαριασμό σας. Σε αυτή την περίπτωση δεν χρεώνεται τίποτα· απλώς δοκιμάστε ξανά σε λίγο.

Η πλήρης αναφορά REST (κωδικοί σφαλμάτων, GET/DELETE πάνω στις μισθώσεις) βρίσκεται στην τεκμηρίωση του REST API· ο πλήρης οδηγός - που καλύπτει εισερχόμενες και εξερχόμενες κλήσεις για οποιαδήποτε πλατφόρμα, όχι μόνο το ElevenLabs - βρίσκεται στη σελίδα Δικός σας πράκτορας.

Πότε να μείνετε στον ενσωματωμένο πράκτορα;

Για να είμαστε ειλικρινείς: ο δικός σας πράκτορας σημαίνει περισσότερα κινούμενα μέρη - ξεχωριστός λογαριασμός και λογαριασμός χρέωσης ElevenLabs, καμία αυτόματη απομαγνητοφώνηση ή περίληψη στην πύλη του volai και ένα επιπλέον βήμα πριν από κάθε εξερχόμενη κλήση (το άνοιγμα μίσθωσης relay). Αν ένα καλό system prompt καλύπτει όσα χρειάζεστε και προτιμάτε να τελειώσετε σε λίγα λεπτά παρά να διαχειρίζεστε δεύτερο λογαριασμό πλατφόρμας, ο ενσωματωμένος πράκτορας volai σας φέρνει εκεί με μία μόνο κλήση API - και η επιβάρυνση 2,50 kr/λεπ. (≈ 0,10 EUR) αγοράζει αυτόματη απομαγνητοφώνηση, περίληψη και ανίχνευση τηλεφωνητή σε κάθε κλήση, χωρίς επιπλέον ρύθμιση.

Για την πλήρη σύγκριση τιμών με το Twilio και άλλους παρόχους, δείτε τη σελίδα Τιμοκατάλογος· ο οδηγός ενσωμάτωσης ElevenLabs, με συνδέσμους προς την τεκμηρίωσή τους, βρίσκεται στη σελίδα Ενσωματώσεις.

Τι ακολουθεί