SMS-meddelanden

Skicka vanliga textmeddelanden med SMSBAT API. SMS är den mest universella meddelandekanalen med de högsta leveranshastigheterna för alla mobila enheter.

Översikt

SMS (Short Message Service) är idealisk för:

Tidskritiska meddelanden
Reserv för Viber/RCS-meddelanden
Nå användare utan smartphones
Universell kompatibilitet över alla mobila nätverk
Höga leveranspriser (95%+)

Grundläggande SMS-meddelande

Begäran

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

Parametrar

Parameter	Skriv	Krävs	Beskrivning
`från`	sträng	Ja	Alfanumeriskt avsändar-ID (upp till 11 tecken)
`till`	sträng	Ja	Mottagarens telefonnummer i E.164-format
`typ`	sträng	Ja	Ställ in på `"sms"`
`text`	sträng	Ja	Meddelandeinnehåll
`customerMessageId`	sträng	Nej	Ditt interna spårnings-ID
`ttl`	heltal	Nej	Tid att leva på några sekunder

Exempel

Enkelt 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 kund-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
  }]
}

Teckenkodning

GSM 7-bitars kodning

Standard GSM-alfabet (160 tecken per SMS):

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

Utökade GSM-tecken

Dessa tecken räknas som 2 tecken:

| ^ € { } [ ] ~ \

Unicode (UCS-2) Kodning

Meddelanden med specialtecken använder Unicode-kodning (70 tecken per SMS):

Emoji: 😀 🎉 ❤️
Kyrilliska: А Б В Г Д Е Ж
Special symbols: ✓ ✗ ★ ♥

Meddelandelängd

Enstaka SMS

GSM 7-bitars: 160 tecken
Unicode: 70 tecken

Flerdelat SMS

När ditt meddelande överskrider gränsen delas det upp i flera delar:

GSM 7-bitars: 153 tecken per del
Unicode: 67 tecken per del

Exempel

{
  "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."
  }]
}

Detta meddelande (201 tecken) kommer att delas upp i 2 delar.

Svar

Framgångssvar

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

Svarsfält

Fält	Beskrivning
`meddelande-ID`	Unik identifierare för spårning
`status`	Meddelandestatus ('accepterat', 'avvisat')
`delar`	Antal SMS-delar
`till`	Mottagarens telefonnummer

Avsändar-ID

Alfanumerisk avsändare

Använd ditt varumärke som avsändare (upp till 11 tecken):

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

Begränsningar:

Max 11 tecken
Endast bokstäver och siffror
Inga mellanslag eller specialtecken
Mottagaren kan inte svara på alfanumeriska avsändare

Numerisk avsändare

Använd ett telefonnummer som avsändare (för tvåvägs SMS):

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

Användningsfall

OTP-verifiering

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

Beställningsmeddelanden

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

Utnämningspåminnelser

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

Betalningsbekräftelser

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

Bästa metoder

Meddelandeinnehåll

✅ Håll meddelanden kortfattade och tydliga
✅ Inkludera avsändaridentifikation
✅ Lägg till uppmaning om det behövs
✅ Använd korrekt grammatik och stavning
❌ Undvik överdrivna skiljetecken!!!
❌ Använd inte alla CAPS
❌ Undvik URL-förkortare som ser misstänkta ut

Teckenanvändning

Kontrollera antalet tecken innan du skickar
Var medveten om utökade GSM-tecken (räknas som 2)
Testa med specialtecken innan masssändning
Consider using GSM encoding for longer messages

Telefonnummer

Använd alltid formatet E.164: +380XXXXXXXXX
Validera telefonnummer innan du skickar
Ta bort ogiltiga nummer från din lista
Håll din kontaktlista uppdaterad

Timing

Respektera lokala tidszoner
Undvik att skicka på natten (22.00–08.00)
Tänk på öppettider för kommersiella meddelanden
Ställ in lämplig TTL för tidskänsliga meddelanden

Efterlevnad

Inhämta samtycke innan du skickar marknadsföringsmeddelanden
Inkludera instruktioner för att välja bort kampanj-SMS
Följ lokala bestämmelser (GDPR, etc.)
Respektera "Stör ej"-listor

Felhantering

Vanliga fel

Fel	Orsak	Lösning
`INVALID_RECIPIENT`	Fel telefonformat	Använd E.164-format
`INVALID_SENDER`	Ogiltigt avsändar-ID	Kontrollera reglerna för avsändar-ID
`MESSAGE_TOO_LONG`	Överskrider maxlängd	Dela eller förkorta meddelande
`INVALID_ENCODING`	Tecken som inte stöds	Använd GSM eller Unicode

Kostnadsoptimering

Minska meddelandedelar

Behåll meddelanden under 160 tecken (GSM) eller 70 (Unicode)
Undvik specialtecken som utlöser Unicode
Använd förkortningar när det är lämpligt
Ta bort onödiga utrymmen

Exempel optimering

❌ Före (171 tecken, 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 tecken, 1 SMS):

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

Masssändning

Skicka flera meddelanden i en begäran:

{
  "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ästa steg

Viber-meddelanden - Rich media-meddelanden
RCS-meddelanden - Rich Communication Services
Kontrollera status - Spåra leveransstatus
Fallback Strategies - Konfigurera fallbacks