Slik bytter du fra Twilio

Hva slags migrering dette er

Twilio sitter på svært lite av dataene deres — det er infrastruktur koden deres kaller. Denne migreringen er derfor 90% et kontrollert kodebytte og 10% regulatorisk logistikk (avsenderregistrering). Den gylne regelen: rut med feature flag, ikke big bang, slik at dere kan flytte trafikken gradvis og rulle tilbake øyeblikkelig.

Steg 1 — Start den trege klokka: avsender-ID-er

Registreringstiden er det eneste dere ikke kan komprimere, så gjør det først. List opp hver avsender dere bruker (alfanumeriske navn, numeriske avsendere) og hvert mottakerland, og registrer dem under Innstillinger → Avsendere (POST /v1/senders). Sjekk kravene per land programmatisk:

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

Land med operatørregistrering tar dager til uker — start nå, kod senere.

Steg 2 — Ta med opt-outene

Bruker dere Twilios Advanced Opt-Out (eller sporer STOP selv), eksporter de numrene og importer dem som sperringer. WeZend fanger opp STOP/START-nøkkelord automatisk framover, men historikken må bli med — en mottaker som sa STOP hos Twilio, skal forbli stoppet hos WeZend.

Steg 3 — Kodediffen

Twilio (Node):

const twilio = require("twilio")(ACCOUNT_SID, AUTH_TOKEN);
await twilio.messages.create({
  to: "+4512345678",
  messagingServiceSid: "MG…",
  body: "Koden din 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: "Koden din er 493202",
    category: "transactional",
    webhook_url: "https://api.yourapp.com/sms-status",
  }),
});

Forskjellene som betyr noe:

• Autentisering er én header (X-API-Key), ingen SID/token-par. Nøkler roteres med et 24-timers nådevindu.
• messagingServiceSid forsvinner — ruting til beste leverandør per destinasjon er plattformens jobb, med automatisk failover når en rute degraderes.
• category: "transactional" merker engangskoder og kvitteringer slik at de går utenom markedsføringstak og stilletimer.
• Status-callbacks kommer til webhook_url med en X-WeZend-Signature-HMAC — verifiser den. Mapp statusene: Twilios queued/sent/delivered/undelivered/failed tilsvarer queued/sent/delivered/failed (undelivered og failed kommer begge som failed, med årsaken vedlagt).

Steg 4 — Innkommende og toveis

Pek svarhåndteringen deres mot WeZend: sett den innkommende webhook-URL-en, så POSTes innkommende meldinger til endepunktet deres akkurat som Twilios MO-webhooks gjorde — i tillegg lander de trådet i innboksen, som supportteamet får med på kjøpet.

Steg 5 — Trinnvis utrulling

Legg leverandørvalget bak et flagg og flytt trafikken etappevis: 5% → verifiser leveringsratene mot Twilios baseline → 50% → 100%. Hold Twilio-kontoen i live (den koster nesten ingenting i ro) til hver webhook-konsument er migrert og en hel faktureringsperiode har gått. Feiler noe underveis, viser Delivery Inspector operatørårsaken i klartekst — slutt på å tyde feil 30008.

Hva med Verify, Voice og numre?

• OTP-flyter: send med category: "transactional"; legg til fallbacken "ingen levering på N sekunder → taleanrop" som en totrinns journey.
• Voice/TTS: voice-kanalen dekker automatiserte TTS-anrop og varsler.
• Dedikerte long codes/short codes: nummerportering håndteres fra sak til sak — kontakt oss med numrene og destinasjonene deres før dere planlegger cutover.