Migrate from Twilio to volai in an afternoon.

What maps to what

The Twilio SDK won't just point at volai by changing an address - it's a smaller, different API. The concepts map one to one, though.

Code side by side

Sending an SMS - same idea, different 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!",
  }),
});

Give it to your AI agent

Copy the prompt into Claude Code, Cursor or another AI editor and let it do the migration for you - SKILL.md gives it the full reference.

Read https://volai.cz/SKILL.md. Find the Twilio SDK calls for SMS and calls in my project (client.messages.create, client.calls.create) and rewrite them to the volai REST API: POST https://volai.cz/v1/messages for SMS, POST https://volai.cz/v1/calls for calls, header Authorization: Bearer vk_YOUR_KEY. Also update webhook handling to the format in SKILL.md, including verifying the Volai-Signature header.

Switch checklist

1. 1

   Number

   Buy a Czech number (POST /v1/numbers or in the portal) and set its routing - agent, forwarding, or SIP.

2. 2

   Key

   Generate an API key in the portal, under API and MCP.

3. 3

   Webhook

   Set the webhook (PUT /v1/webhook) to the same address your Twilio StatusCallback uses today, and update the handler for the new event shape.

4. 4

   Test

   Before you switch live traffic, send yourself an SMS and place a test call to your own phone.

5. 5

   DNS and old contacts

   You usually don't need to touch DNS - volai doesn't use your domain. Do check websites, email signatures and documentation for the old phone number written in by hand.

When to stay with Twilio

Migrating isn't for everyone - beyond the overview above, weigh this too:

• Outbound calls from volai only reach Czech and Slovak numbers (+420, +421) - you can't call abroad, even from a Czech number you own.
• You need more than 60 requests a minute - that's the shared rate limit on both the REST API and the MCP server.