Gå til indholdet

SMS-beskeder

Send standard tekstbeskeder ved hjælp af SMSBAT API. SMS er den mest universelle beskedkanal med de højeste leveringsrater på tværs af alle mobile enheder.

Oversigt

SMS (Short Message Service) er ideel til:

  • Tidskritiske meddelelser
  • Fallback for Viber/RCS beskeder
  • Nå ud til brugere uden smartphones
  • Universel kompatibilitet på tværs af alle mobilnetværk
  • Høje leveringsrater (95%+)

Grundlæggende SMS-besked

Anmodning

{
  "from": "YourSender",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Your SMS message text"
}

Parametre

Parameter Skriv Påkrævet Beskrivelse
fra streng Ja Alfanumerisk afsender-id (op til 11 tegn)
til streng Ja Modtagerens telefonnummer i E.164-format
type streng Ja Indstil til "sms"
tekst streng Ja Beskedindhold
customerMessageId streng Nej Dit interne sporings-id
ttl heltal Nej Tid til at leve på få sekunder

Eksempler

Simpel SMS

curl -X POST https://restapi.smsbat.com/bat/messagelist \
  -H "X-Authorization-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [{
      "from": "YourBrand",
      "to": "+380XXXXXXXXX",
      "type": "sms",
      "text": "Hello! This is a test SMS message."
    }]
  }'

SMS med kunde-id

{
  "messages": [{
    "from": "YourStore",
    "to": "+380XXXXXXXXX",
    "type": "sms",
    "text": "Your order #12345 has been shipped.",
    "customerMessageId": "order-12345-notification"
  }]
}

SMS med TTL

{
  "messages": [{
    "from": "YourApp",
    "to": "+380XXXXXXXXX",
    "type": "sms",
    "text": "Your verification code is: 123456",
    "ttl": 300
  }]
}

Tegnkodning

GSM 7-bit kodning

Standard GSM alfabet (160 tegn pr. SMS):

A-Z a-z 0-9
@ £ $ ¥ è é ù ì ò Ç Ø ø Å å
Δ _ Φ Γ Λ Ω Π Ψ Σ Θ Ξ
! " # % & ' ( ) * + , - . / : ; < = > ?

Udvidede GSM-tegn

Disse tegn tæller som 2 tegn:

| ^ € { } [ ] ~ \

Unicode (UCS-2)-kodning

Beskeder med specialtegn bruger Unicode-kodning (70 tegn pr. SMS):

  • Emoji: 😀 🎉 ❤️
  • Kyrillisk: А Б В Г Д Е Ж
  • Særlige symboler: ✓ ✗ ★ ♥

Meddelelseslængde

Enkelt SMS

  • GSM 7-bit: 160 tegn
  • Unicode: 70 tegn

Multi-part SMS

Når din besked overskrider grænsen, er den opdelt i flere dele:

  • GSM 7-bit: 153 tegn pr. del
  • Unicode: 67 tegn pr. del

Eksempel

{
  "messages": [{
    "from": "YourBrand",
    "to": "+380XXXXXXXXX",
    "type": "sms",
    "text": "This is a very long message that will be split into multiple parts. Each part will be delivered separately but will appear as a single message on the recipient's phone. The system automatically handles the splitting and reassembly."
  }]
}

Denne besked (201 tegn) vil blive opdelt i 2 dele.

Svar

Successvar

{
  "messagelistId": 123456,
  "messages": [
    {
      "messageId": "abc123def456",
      "status": "accepted",
      "parts": 2,
      "customerMessageId": "order-12345-notification",
      "to": "+380XXXXXXXXX"
    }
  ]
}

Svarfelter

Felt Beskrivelse
messageId Unik identifikator til sporing
status Meddelelsesstatus ('accepteret', 'afvist')
dele Antal SMS-dele
til Modtagerens telefonnummer

Afsender-id

Alfanumerisk afsender

Brug dit varemærkenavn som afsender (op til 11 tegn):

{
  "from": "YourBrand",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Hello from YourBrand!"
}

Begrænsninger:

  • Maksimalt 11 tegn
  • Kun bogstaver og tal
  • Ingen mellemrum eller specialtegn
  • Modtager kan ikke svare til alfanumeriske afsendere

Numerisk afsender

Brug et telefonnummer som afsender (til to-vejs SMS):

{
  "from": "+380123456789",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Hello! You can reply to this message."
}

Use Cases

OTP-bekræftelse

{
  "from": "YourApp",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Your verification code is: 123456. Valid for 5 minutes.",
  "ttl": 300
}

Ordremeddelelser

{
  "from": "YourStore",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Your order #12345 has been delivered. Thank you for shopping with us!"
}

Påmindelser om aftaler

{
  "from": "YourClinic",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Reminder: Your appointment is scheduled for tomorrow at 2:00 PM."
}

Betalingsbekræftelser

{
  "from": "YourBank",
  "to": "+380XXXXXXXXX",
  "type": "sms",
  "text": "Payment of 100 USD to Merchant ABC was successful. Transaction ID: 789xyz"
}

Bedste praksis

Beskedindhold

  • ✅ Hold beskeder kortfattede og klare
  • ✅ Inkluder afsenderidentifikation
  • ✅ Tilføj call-to-action, hvis det er nødvendigt
  • ✅ Brug korrekt grammatik og stavning
  • ❌ Undgå overdreven tegnsætning!!!
  • ❌ Brug ikke alle CAPS
  • ❌ Undgå URL-forkortere, der ser mistænkelige ud

Tegnbrug

  • Tjek antal tegn før afsendelse
  • Vær opmærksom på udvidede GSM-tegn (tæller som 2)
  • Test med specialtegn før masseafsendelse
  • Overvej at bruge GSM-kodning til længere beskeder

Telefonnumre

  • Brug altid E.164-format: +380XXXXXXXXX
  • Valider telefonnumre før afsendelse
  • Fjern ugyldige numre fra din liste
  • Hold din kontaktliste opdateret

Timing

  • Respekter lokale tidszoner
  • Undgå at sende om natten (22.00 - 08.00)
  • Overvej åbningstider for kommercielle beskeder
  • Indstil passende TTL for tidsfølsomme beskeder

Overholdelse

  • Indhent samtykke, før du sender marketingmeddelelser
  • Inkluder opt-out instruktioner til salgsfremmende SMS
  • Følg lokale regler (GDPR osv.)
  • Respekter "Forstyr ikke"-lister

Fejlhåndtering

Almindelige fejl

Fejl Årsag Løsning
INVALID_RECIPIENT Forkert telefonformat Brug E.164-format
INVALID_SENDER Ugyldigt afsender-id Tjek regler for afsender-id
MESSAGE_TOO_LONG Overskrider max længde Opdel eller forkort besked
INVALID_ENCODING Ikke-understøttede tegn Brug GSM eller Unicode

Omkostningsoptimering

Reducer meddelelsesdele

  • Gem beskeder under 160 tegn (GSM) eller 70 (Unicode)
  • Undgå specialtegn, der udløser Unicode
  • Brug forkortelser, når det er relevant
  • Fjern unødvendige mellemrum

Eksempel optimering

❌ Før (171 tegn, 2 SMS): 

Hello John! Your order #12345 has been successfully delivered to your address at 123 Main Street. Thank you for shopping with us! We hope to see you again soon.

✅ Efter (156 tegn, 1 SMS): 

Hi John! Order #12345 delivered to 123 Main St. Thanks for shopping with us! Visit example.com/order/12345 for details.

Masseafsendelse

Send flere beskeder på én anmodning:

{
  "messages": [
    {
      "from": "YourBrand",
      "to": "+380111111111",
      "type": "sms",
      "text": "Message 1"
    },
    {
      "from": "YourBrand",
      "to": "+380222222222",
      "type": "sms",
      "text": "Message 2"
    },
    {
      "from": "YourBrand",
      "to": "+380333333333",
      "type": "sms",
      "text": "Message 3"
    }
  ]
}

Næste trin