Sådan skifter du fra Twilio

Hvilken slags migrering det her er

Twilio ligger inde med meget lidt af jeres data — det er infrastruktur, jeres kode kalder. Så denne migrering er 90% et kontrolleret kodeskift og 10% regulatorisk logistik (afsenderregistrering). Den gyldne regel: rout med feature-flag, ikke big bang, så du kan flytte trafikken gradvist og rulle tilbage øjeblikkeligt.

Trin 1 — Start det langsomme ur: afsender-ID'er

Registreringstid er det eneste, du ikke kan komprimere, så gør det først. List hver afsender, I bruger (alfanumeriske navne, numeriske afsendere), og hvert modtagerland, og registrér dem under Indstillinger → Afsendere (POST /v1/senders). Tjek kravene pr. land programmatisk:

curl "https://api.wezend.com/v1/sender/rules?country=DK" -H "X-API-Key: $WEZEND_API_KEY"

Lande med operatørregistrering tager dage til uger — start nu, kod senere.

Trin 2 — Flyt opt-outs med

Bruger I Twilios Advanced Opt-Out (eller tracker selv STOP'er), så eksportér de numre og importér dem som suppressioner. WeZend opsnapper STOP/START-keywords automatisk fremadrettet, men historikken skal med — en modtager, der sagde STOP hos Twilio, skal forblive stoppet hos WeZend.

Trin 3 — Kode-diffen

Twilio (Node):

const twilio = require("twilio")(ACCOUNT_SID, AUTH_TOKEN);
await twilio.messages.create({
  to: "+4512345678",
  messagingServiceSid: "MG…",
  body: "Din kode er 493202",
  statusCallback: "https://api.yourapp.com/sms-status",
});

WeZend — ren HTTP, ingen SDK nødvendig:

await fetch("https://api.wezend.com/v1/messages/send", {
  method: "POST",
  headers: { "X-API-Key": process.env.WEZEND_API_KEY, "Content-Type": "application/json" },
  body: JSON.stringify({
    to: "+4512345678",
    channel: "sms",
    sender: "Acme",
    message: "Din kode er 493202",
    category: "transactional",
    webhook_url: "https://api.yourapp.com/sms-status",
  }),
});

Forskellene der betyder noget:

• Auth er én header (X-API-Key), intet SID/token-par. Nøgler roteres med et 24-timers nådevindue.
• messagingServiceSid forsvinder — routing til den bedste vendor pr. destination er platformens job, med automatisk failover når en rute degraderer.
• category: "transactional" markerer engangskoder og kvitteringer, så de omgår marketinglofter og quiet hours.
• Status-callbacks ankommer på din webhook_url med en X-WeZend-Signature-HMAC — verificér den. Map statusser: Twilios queued/sent/delivered/undelivered/failed svarer til queued/sent/delivered/failed (undelivered og failed ankommer begge som failed, med årsagen vedhæftet).

Trin 4 — Indgående og tovejs

Peg jeres svar-håndtering mod WeZend: sæt den indgående webhook-URL, og indgående beskeder POSTes til jeres endpoint præcis som Twilios MO-webhooks gjorde — plus de lander trådet i indbakken, som jeres supportteam får gratis.

Trin 5 — Faseopdelt udrulning

Læg leverandørvalget bag et flag og flyt trafikken i etaper: 5% → verificér leveringsrater mod Twilios baseline → 50% → 100%. Hold Twilio-kontoen i live (den koster næsten intet i tomgang), indtil hver webhook-forbruger er migreret og en fuld faktureringsperiode er gået. Fejler noget under overgangen, viser Delivery Inspector carrier-årsagen i klart sprog — slut med at dechifrere fejl 30008.

Hvad med Verify, Voice og numre?

• OTP-flows: send med category: "transactional"; tilføj "ingen levering på N sekunder → taleopkald"-fallbacken som en to-trins journey.
• Voice/TTS: voice-kanalen dækker automatiserede TTS-opkald og alarmer.
• Dedikerede longcodes/shortcodes: nummerportering håndteres fra sag til sag — kontakt os med jeres numre og destinationer, før I lægger cutover-planen.