Μετάβαση από το Twilio στο volai σε ένα απόγευμα.

Τι αντιστοιχεί σε τι

Το Twilio SDK δεν συνδέεται με το volai απλώς αλλάζοντας διεύθυνση - είναι ένα μικρότερο, διαφορετικό API. Οι έννοιες όμως αντιστοιχούν μία προς μία.

Κώδικας δίπλα-δίπλα

Αποστολή SMS - ίδια ιδέα, διαφορετικό API.

const twilio = require("twilio");
const client = twilio(accountSid, authToken);

await client.messages.create({
  body: "Hi from Twilio!",
  from: "+15017122661",
  to: "+420777123456",
});

await fetch("https://volai.cz/v1/messages", {
  method: "POST",
  headers: {
    Authorization: "Bearer vk_YOUR_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    to: "+420777123456",
    body: "Hi from volai!",
  }),
});

Το Twilio ορίζει τον αποστολέα με το πεδίο from. Το volai αγνοεί το from και επιλέγει τον αποστολέα με το πεδίο fromNumber (αριθμός από το GET /v1/sms-numbers, πρόσθετο αριθμός κινητού, ή από το GET /v1/voice-sms-numbers, αριθμός για κλήσεις και SMS). Χωρίς fromNumber τα SMS φεύγουν με το κοινό όνομα SMSinfo, στο οποίο ο παραλήπτης δεν μπορεί να απαντήσει.

Δώστε το στον πράκτορα AI σας

Αντιγράψτε την εντολή στο Claude Code, στο Cursor ή σε άλλον επεξεργαστή AI και αφήστε τον να κάνει τη μετάβαση για εσάς - το SKILL.md του δίνει ολόκληρη την αναφορά.

Διάβασε το SKILL.md από τον ιστότοπο του volai (η βασική διεύθυνση URL του API αναφέρεται εκεί). Βρες στο έργο μου τις κλήσεις του Twilio SDK για SMS και κλήσεις (client.messages.create, client.calls.create) και ξαναγράψε τις στο REST API του volai: POST /v1/messages για SMS, POST /v1/calls για κλήσεις, κεφαλίδα Authorization: Bearer vk_YOUR_KEY. Προσάρμοσε και τη λήψη webhooks στη μορφή του SKILL.md, μαζί με την επαλήθευση της κεφαλίδας Volai-Signature.

Λίστα ελέγχου για την αλλαγή

1. 1

   Αριθμός

   Αγοράστε έναν τσεχικό αριθμό (POST /v1/numbers ή από την πύλη) και ορίστε τη δρομολόγησή του - πράκτορας, προώθηση ή SIP. Για λήψη SMS και αποστολή από δικό σας αριθμό αγοράστε επιπλέον έναν αριθμός κινητού (POST /v1/sms-numbers ή από την πύλη στους Αριθμούς): τσεχικός αριθμός μόνο για SMS, χωρίς κλήσεις. Αν θέλετε κλήσεις και SMS στον ίδιο αριθμό, παραγγείλετε αντί για δύο αριθμούς έναν αριθμός για κλήσεις και SMS (POST /v1/voice-sms-numbers ή από την πύλη): σταθερή γραμμή Πράγας που μετά την παραγγελία καταχωρίζεται στον πάροχο, συνήθως εντός 1 εργάσιμης ημέρας. Τις κλήσεις σε αυτόν απαντά μόνο πράκτορας στη δική του φωνητική μηχανή του volai (δεν μπορεί να δρομολογηθεί σε SIP ούτε να προωθηθεί), οπότε δεν ταιριάζει σε πράκτορα που τρέχει αλλού.

2. 2

   Κλειδί

   Δημιουργήστε ένα κλειδί API στην πύλη, στην ενότητα Βοηθός AI.

3. 3

   Webhook

   Ορίστε το webhook (PUT /v1/webhook) στην ίδια διεύθυνση όπου φτάνει σήμερα το StatusCallback του Twilio και προσαρμόστε την επεξεργασία στη νέα μορφή συμβάντος. Αν η διεύθυνση περιέχει όνομα χρήστη και κωδικό, μεταφέρετε τη σύνδεση σε δική σας κεφαλίδα (headers, για παράδειγμα Authorization: Basic ...), καθώς το volai απορρίπτει διεύθυνση με διαπιστευτήρια.

4. 4

   Δοκιμή

   Πριν αλλάξετε την πραγματική κίνηση, στείλτε στον εαυτό σας ένα SMS και κάντε μια δοκιμαστική κλήση στο δικό σας κινητό.

5. 5

   DNS και παλιές επαφές

   Συνήθως δεν χρειάζεται να αλλάξετε το DNS - το volai δεν χρησιμοποιεί τον τομέα σας. Ελέγξτε όμως ιστότοπους, υπογραφές email και τεκμηρίωση όπου ο παλιός αριθμός τηλεφώνου είναι γραμμένος σταθερά.

Πότε να μείνετε στο Twilio

Η μετάβαση δεν είναι για όλους - εκτός από την επισκόπηση παραπάνω, σκεφτείτε και τα εξής:

• Οι εξερχόμενες κλήσεις από το volai φτάνουν μόνο σε τσεχικούς και σλοβακικούς αριθμούς (+420, +421) - δεν μπορείτε να καλέσετε το εξωτερικό, ούτε από αγορασμένο τσεχικό αριθμό.
• Χρειάζεστε μεγαλύτερο όγκο από 60 αιτήματα ανά λεπτό - αυτό είναι το κοινό όριο του REST API και του διακομιστή MCP.