Nøglepunkter
- Hold API-nøgler på serveren, og brug separate test- og live-nøgler.
- Send numre i internationalt format, giv hver besked en egen reference, og prøv kun igen ved midlertidige fejl.
- Modtag status via webhook, verificér den, og afstem det, der mangler.
- Test i de lande og på de netværk, der tæller, og sæt alarmer op før lancering.
Nøgler og miljøer
- Hold API-nøglen på din server, aldrig i en browser eller mobilapp
- Brug testnøglen, til integrationen virker, og skift så til live-nøglen
- Opbevar nøgler i en hemmelighedsstyring, og rotér dem efter en plan
- Giv hver tjeneste sin egen nøgle, så én kan tilbagekaldes uden at påvirke de andre
Forespørgslen
- Send numre i E.164-format, og valider dem først
- Vælg afsender pr. land med den registrering, den kræver
- Tæl segmenter, og hold øje med tegn, der skifter kodning
- Tilføj din egen reference til hver besked, og gem det besked-ID, du får tilbage
- Sæt en timeout, og prøv igen med voksende ventetid ved timeouts og serverfejl, ikke ved valideringsfejl
- Respektér de dokumenterede hastighedsgrænser, og sæt resten i kø
Resultatet
- Modtag status via en webhook, og verificér dens signatur
- Gør behandlingen sikker at gentage, da hændelser kan komme to gange eller i forkert rækkefølge
- Håndtér alle statusser, også fejlet og udløbet, med en regel for, hvad der sker derefter
- Afstem beskeder, der ikke har en endelig status efter den normale ventetid
Regler omkring afsendelsen
- Tjek en afmeldingsliste før hver markedsføringsudsendelse
- Respektér tidsregler for markedsføringsbeskeder
- Adskil transaktions- og markedsføringsafsendere
- Begræns anmodninger om koder, og sæt et dagligt forbrugsloft
Drift
- Dashboards for sendt mængde, fejlrate og levering pr. land
- Alarmer ved fejlspidser, faldende levering og usædvanligt forbrug
- Logs, der holder personoplysninger til det, du har brug for
- En køreplan, der siger, hvem der handler, når leveringen falder, og hvordan du når support
Testplanen
- Rigtige telefoner i hvert prioriteret land, på mere end ét netværk, hvor du kan
- Et ugyldigt nummer, en slukket telefon og et nummer, der har afmeldt sig
- Et webhook-endepunkt, der er nede i nogle minutter
- En besked, der er lang nok til flere segmenter, og en med Unicode
Hvordan ZafeConnect passer ind
ZafeConnects API tager nøglen i headeren X-API-Key, har live- og testmiljøer, dokumenterede hastighedsgrænser og signerede webhooks, og leveres med en OpenAPI 3.1-beskrivelse og en Postman-samling. Udviklerdokumentationen viser felter og svar.