Πρώτα βήματα

Quickstart

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

1Δημιουργήστε λογαριασμό

Η εγγραφή διαρκεί ένα λεπτό και είναι δωρεάν, δεν χρειάζεστε κάρτα. Μετά την επαλήθευση του email στον λογαριασμό σας πιστώνονται 50,00 kr (≈ 2,08 EUR) υπόλοιπο - αρκεί για την αγορά αριθμού και λίγες δοκιμαστικές κλήσεις (τα SMS λειτουργούν μόνο μετά την πρώτη φόρτιση). Τον ξεχασμένο κωδικό μπορείτε να τον επαναφέρετε οποτεδήποτε από τον σύνδεσμο στη σελίδα σύνδεσης, με ένα κλασικό email που περιέχει σύνδεσμο για ορισμό νέου.

2Ανοίξτε τη σύνδεση του βοηθού

Στην πύλη ανοίξτε την ενότητα Βοηθός AI και επιλέξτε σύνδεση μέσω OAuth. Το Claude Code, το Codex CLI και το Codex desktop μπορούν να ανοίξουν τη σύνδεση· για άλλον πελάτη παραμένει διαθέσιμη η παραλλαγή με υπάρχον κλειδί API.

3Συνδεθείτε - MCP ή REST API

Το MCP συνδέει τα εργαλεία του volai απευθείας στον βοηθό σας. Το REST API ταιριάζει για τη δική σας εφαρμογή. Και οι δύο δρόμοι χρησιμοποιούν τον ίδιο λογαριασμό και το ίδιο κλειδί· τις υποστηριζόμενες ενέργειες και τους περιορισμούς τους θα βρείτε παρακάτω στον χάρτη δυνατοτήτων.

Βοηθός AI μέσω MCP

Μία εντολή για το Claude Code (η εγκατάσταση για Cursor, Windsurf, VS Code και Claude Desktop βρίσκεται στη σελίδα Διακομιστής MCP):

claude mcp add --transport http --scope user volai 'https://volai.cz/mcp'
claude mcp login volai

Επαληθεύστε τη σύνδεση χωρίς κλήσεις

Επικολλήστε σε νέα συνομιλία στον συνδεδεμένο βοηθό την ακόλουθη εντολή. Η σύνδεση θεωρείται ολοκληρωμένη μόνο μετά από πραγματική ανάγνωση (read-only) μέσω `get_balance` και `list_agents`· για την επαλήθευση δεν χρειάζεται να καλέσετε, να στείλετε SMS ή να αγοράσετε αριθμό.

Connect volai as an MCP server at https://volai.cz/mcp using the guide at https://volai.cz/SKILL.md. If it is already connected, use the existing connection. If you can manage MCP in this environment, prepare the configuration; otherwise guide me through the specific steps. Use sign-in through volai, and leave sign-in and consent to me. Do not ask for an API key in chat. Then verify the connection using get_balance and list_agents. Change nothing else, make no calls, send no messages and buy nothing.

Δική σας εφαρμογή μέσω REST API

Επαληθεύστε το κλειδί με ένα ερώτημα για το υπόλοιπο:

curl https://volai.cz/v1/balance \
  -H "Authorization: Bearer vk_YOUR_KEY"

{
  "balanceHal": 5000,
  "balanceCzk": 50.00,
  "currency": "CZK"
}

4Προαιρετικά: επιλέξτε την επόμενη δουλειά

Μετά την επαλήθευση συνεχίστε ανάλογα με τον στόχο σας. Μπορείτε να χρησιμοποιήσετε τον οδηγό, την πύλη ιστού, το REST API ή δική σας εντολή MCP· τα παραδείγματα παρακάτω είναι έμπνευση, όχι υποχρεωτική πρώτη εργασία.

Αντικαταστήστε τους αριθμούς και τα ID των παραδειγμάτων με τα δικά σας. Οι απαντήσεις παρακάτω δείχνουν τα βασικά πεδία· τις πλήρεις μορφές θα βρείτε στην αναφορά REST. Για επαναλαμβανόμενη επί πληρωμή ενέργεια χρησιμοποιήστε το ίδιο Idempotency-Key, για νέα ενέργεια νέο.

Προαιρετικά: δοκιμάστε τη φωνή με πραγματική κλήση

Αυτός είναι ο γρηγορότερος τρόπος να ακούσετε το volai με τα αυτιά σας: ένα αίτημα και σε λίγα δευτερόλεπτα χτυπά το τηλέφωνό σας. Χωρίς αγορά αριθμού, χωρίς δημιουργία πράκτορα - αρκεί να γράψετε τι πρέπει να κάνει ο πράκτορας, στο systemPrompt αντί για το agentId. Η κλήση γίνεται από τον κοινό αριθμό επίδειξης του volai.

curl -X POST https://volai.cz/v1/calls \
  -H "Authorization: Bearer vk_YOUR_KEY" \
  -H "Idempotency-Key: REPLACE_WITH_UNIQUE_CALL_REQUEST_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+420777123456",
    "systemPrompt": "Είστε ο ρεσεψιονίστ του καφέ Nula. Χαιρετήστε, ρωτήστε τι θα ήθελε ο πελάτης και επαναλάβετε την παραγγελία."
  }'

{
  "id": "c_8f2ac1d4x7qz",
  "status": "initiated",
  "trial": true,
  "from": "+420266266641"
}

Προαιρετικά: στείλτε SMS

Στείλτε ένα μήνυμα σε οποιονδήποτε τσεχικό ή σλοβακικό αριθμό κινητού (σε άλλες χώρες δεν στέλνουμε SMS). Τα SMS λειτουργούν μόνο μετά την πρώτη φόρτιση του υπολοίπου, το υπόλοιπο καλωσορίσματος δεν μπορεί να χρησιμοποιηθεί γι' αυτά. Μην περιμένετε όμως απάντηση - στο κοινό όνομα αποστολέα SMSinfo ο παραλήπτης δεν μπορεί να απαντήσει και οι φωνητικοί αριθμοί του volai δεν λαμβάνουν SMS (λήψη SMS και αποστολή από δικό σας αριθμό υποστηρίζουν το πρόσθετο αριθμός κινητού και ο αριθμός για κλήσεις και SMS, δείτε την ενότητα Αριθμός κινητού και την ενότητα Αριθμός για κλήσεις και SMS στην τεκμηρίωση του API):

curl -X POST https://volai.cz/v1/messages \
  -H "Authorization: Bearer vk_YOUR_KEY" \
  -H "Idempotency-Key: REPLACE_WITH_UNIQUE_SMS_REQUEST_ID" \
  -H "Content-Type: application/json" \
  -d '{"to": "+420777123456", "body": "Γεια σας από το volai! - Η εφαρμογή μου"}'

{
  "id": "msg_7c1f9a2e",
  "status": "sent",
  "priceHal": 136,
  "segments": 1
}

Προαιρετικά: αποκτήστε αριθμό για εισερχόμενες κλήσεις

Πρώτα ένας αριθμός από το ελεύθερο απόθεμα - το κενό σώμα {} σάς αντιστοιχίζει αριθμό από την προεπιλεγμένη προσφορά Πράγας. Για συγκεκριμένη προσφορά χρησιμοποιήστε region ή επιλέξτε e164 μέσω GET /v1/numbers/available. Η αγορά αφαιρεί αμέσως το τέλος της πρώτης περιόδου:

curl -X POST https://volai.cz/v1/numbers \
  -H "Authorization: Bearer vk_YOUR_KEY" \
  -H "Idempotency-Key: REPLACE_WITH_UNIQUE_NUMBER_REQUEST_ID" \
  -H "Content-Type: application/json" \
  -d '{}'

{
  "number": {
    "e164": "+420210123456",
    "routing": { "mode": "none", "hasSipPassword": false },
    "monthlyFeeHal": 2500,
    "boughtAt": 1756111640000,
    "region": "praha",
    "regionLabel": "Prague",
    "billingMonths": 1
  }
}

Τώρα αντιστοιχίστε στον αριθμό έναν πράκτορα - αρκούν ένα όνομα, ένα system prompt και ο αριθμός από το προηγούμενο βήμα:

curl -X POST https://volai.cz/v1/agents \
  -H "Authorization: Bearer vk_YOUR_KEY" \
  -H "Idempotency-Key: REPLACE_WITH_UNIQUE_AGENT_REQUEST_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Ρεσεψιονίστ",
    "systemPrompt": "Είστε ο ρεσεψιονίστ του καφέ Nula. Παίρνετε παραγγελίες για παραλαβή και απαντάτε σε ερωτήσεις για το ωράριο (8-18, Δευτέρα έως Παρασκευή). Ποτέ μην επινοείτε τιμές που δεν γνωρίζετε. Ολοκληρώστε την κλήση με σύνοψη της παραγγελίας.",
    "numberE164": "+420210123456"
  }'

{
  "id": "ag_kx91fa2b"
}

Και έτοιμο - καλέστε τον νέο σας αριθμό. Ο πράκτορας πρέπει να απαντήσει σε λίγα δευτερόλεπτα και να μιλά ακριβώς όπως του γράψατε στο systemPrompt.

Χάρτης δυνατοτήτων

Επισκόπηση των τομέων και των διαθέσιμων λειτουργιών. Στα REST και MCP ο αριθμός δείχνει πόσες από τις λειτουργίες υποστηρίζει η αντίστοιχη διεπαφή. Τις σκόπιμες εξαιρέσεις, για παράδειγμα τη δημιουργία πρόσβασης μόνο στην πύλη, εξηγεί η αναφορά.

Την πλήρη λίστα θα βρείτε στην αναφορά REST API και στη λίστα εργαλείων στο MCP .