Преминаване от Twilio към volai за един следобед.

Кое на кое съответства

SDK на Twilio не се свързва с 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. Адаптирай и обработката на уебхуковете към формата от 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

   Уебхук

   Задайте уебхук (PUT /v1/webhook) на същия адрес, на който днес идва StatusCallback на Twilio, и адаптирайте обработката към новия вид събитие. Ако адресът съдържа потребителско име и парола, преместете удостоверяването в собствен хедър (headers, например Authorization: Basic ...), защото volai отхвърля адрес с данни за вход.

4. 4

   Тест

   Преди да превключите реалния трафик, изпратете си SMS и направете тестово обаждане на собствения си мобилен телефон.

5. 5

   DNS и стари контакти

   Обикновено не е нужно да променяте DNS - volai не използва Вашия домейн. Проверете обаче уебсайтовете, имейл подписите и документацията, където старият телефонен номер е написан директно.

Кога да останете при Twilio

Миграцията не е за всеки - освен прегледа по-горе обмислете и това:

• Изходящите обаждания от volai отиват само към чешки и словашки номера (+420, +421) - към чуждестранен номер не можете да се свържете, дори от купен чешки номер.
• Нуждаете се от по-голям обем от 60 заявки в минута - това е общият лимит за REST API и MCP сървъра.