Von Twilio zu volai wechseln an einem Nachmittag.

Was wohin gehört

Das Twilio-SDK lässt sich nicht einfach durch Ändern einer Adresse auf volai umlenken - es ist eine kleinere, andere API. Die Konzepte entsprechen einander jedoch eins zu eins.

Code im Vergleich

Eine SMS senden - dieselbe Idee, eine andere 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 legt den Absender mit dem Feld from fest. volai ignoriert from und wählt den Absender über fromNumber (eine Nummer aus GET /v1/sms-numbers, der Mobilnummer, oder aus GET /v1/voice-sms-numbers, der Nummer für Anrufe und SMS). Ohne fromNumber werden SMS unter dem gemeinsamen Absendernamen SMSinfo versendet, auf den Empfänger nicht antworten können.

Geben Sie es Ihrem KI-Agenten

Kopieren Sie den Prompt in Claude Code, Cursor oder einen anderen KI-Editor und lassen Sie ihn die Migration für Sie erledigen - SKILL.md liefert ihm die vollständige Referenz.

Lies die Datei SKILL.md von der volai-Website (die Basis-URL der API steht darin). Finde in meinem Projekt die Aufrufe des Twilio-SDK für SMS und Anrufe (client.messages.create, client.calls.create) und schreibe sie auf die REST-API von volai um: POST /v1/messages für SMS, POST /v1/calls für Anrufe, Header Authorization: Bearer vk_YOUR_KEY. Passe außerdem die Webhook-Verarbeitung an das Format aus SKILL.md an, einschließlich der Prüfung des Headers Volai-Signature.

Checkliste für die Umstellung

1. 1

   Nummer

   Kaufen Sie eine tschechische Nummer (POST /v1/numbers oder im Portal) und legen Sie ihre Weiterleitung fest - Agent, Rufumleitung oder SIP. Für den SMS-Empfang und den Versand von der eigenen Nummer kaufen Sie zusätzlich eine Mobilnummer (POST /v1/sms-numbers oder im Portal unter Nummern): eine tschechische Nummer nur für SMS, ohne Anrufe. Wenn Sie Anrufe und SMS auf derselben Nummer möchten, bestellen Sie statt der beiden Nummern eine Nummer für Anrufe und SMS (POST /v1/voice-sms-numbers oder im Portal): einen Prager Festnetzanschluss, der nach der Bestellung beim Betreiber registriert wird, in der Regel innerhalb von 1 Werktag. Anrufe darauf beantwortet nur ein Agent auf der eigenen Sprach-Engine von volai (sie lassen sich weder an SIP weiterleiten noch umleiten), sie eignet sich also nicht für einen Agenten, der anderswo läuft.

2. 2

   Schlüssel

   Erzeugen Sie im Portal unter KI-Assistent einen API-Schlüssel.

3. 3

   Webhook

   Setzen Sie den Webhook (PUT /v1/webhook) auf dieselbe Adresse, die Ihr Twilio-StatusCallback heute verwendet, und passen Sie den Handler an das neue Ereignisformat an. Enthält die Adresse Benutzername und Passwort, verlagern Sie die Zugangsdaten in einen eigenen Header (headers, zum Beispiel Authorization: Basic ...); volai lehnt eine Adresse mit Zugangsdaten ab.

4. 4

   Test

   Senden Sie sich vor der Umstellung des Live-Verkehrs eine SMS und führen Sie einen Testanruf auf Ihr eigenes Telefon aus.

5. 5

   DNS und alte Kontakte

   An DNS müssen Sie in der Regel nichts ändern - volai verwendet Ihre Domain nicht. Prüfen Sie jedoch Websites, E-Mail-Signaturen und Dokumentation auf die alte, von Hand eingetragene Telefonnummer.

Wann Sie bei Twilio bleiben sollten

Eine Migration ist nicht für jeden das Richtige - wägen Sie über die obige Übersicht hinaus auch Folgendes ab:

• Ausgehende Anrufe von volai erreichen nur tschechische und slowakische Nummern (+420, +421) - Anrufe ins Ausland sind nicht möglich, auch nicht von einer tschechischen Nummer, die Ihnen gehört.
• Sie benötigen mehr als 60 Anfragen pro Minute - das ist das gemeinsame Ratenlimit für die REST-API und den MCP-Server.