SMS-berichten

Verzend standaard sms-berichten met behulp van de SMSBAT API. SMS is het meest universele berichtenkanaal met de hoogste leveringspercentages op alle mobiele apparaten.

Overzicht

SMS (Short Message Service) is ideaal voor:

Tijdkritische meldingen
Terugval voor Viber/RCS-berichten
Gebruikers zonder smartphones bereiken
Universele compatibiliteit tussen alle mobiele netwerken
Hoge bezorgpercentages (95%+)

Basis SMS-bericht

Verzoek

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

Parameters

Parameter	Typ	Vereist	Beschrijving
`van`	tekenreeks	Ja	Alfanumerieke afzender-ID (maximaal 11 tekens)
`naar`	tekenreeks	Ja	Telefoonnummer van de ontvanger in E.164-formaat
`type`	tekenreeks	Ja	Stel in op `"sms"`
`tekst`	tekenreeks	Ja	Berichtinhoud
`klantMessageId`	tekenreeks	Nee	Uw interne tracking-ID
`ttl`	geheel getal	Nee	Tijd tot leven in seconden

Voorbeelden

Eenvoudig sms'en

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 met klant-ID

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

Sms met TTL

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

Tekencodering

GSM 7-bit-codering

Standaard GSM-alfabet (160 tekens per sms):

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

Uitgebreide GSM-tekens

Deze karakters tellen als 2 karakters:

| ^ € { } [ ] ~ \

Unicode (UCS-2)-codering

Berichten met speciale tekens gebruiken Unicode-codering (70 tekens per sms):

Emoji: 😀 🎉 ❤️
Cyrillisch: А Б В Г Д Е Ж
Speciale symbolen: ✓ ✗ ★ ♥

Berichtlengte

Enkele sms

GSM 7-bit: 160 tekens
Unicode: 70 tekens

Meerdelige sms

Wanneer uw bericht de limiet overschrijdt, wordt het in meerdere delen opgesplitst:

GSM 7-bit: 153 tekens per onderdeel
Unicode: 67 tekens per deel

Voorbeeld

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

Dit bericht (201 tekens) wordt in 2 delen opgesplitst.

Reactie

Succesreactie

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

Reactievelden

Veld	Beschrijving
`berichtId`	Unieke identificatie voor tracking
`status`	Berichtstatus (`geaccepteerd`, `afgewezen`)
`onderdelen`	Aantal SMS-onderdelen
`naar`	Telefoonnummer ontvanger

Afzender-ID

Alfanumerieke afzender

Gebruik uw merknaam als afzender (maximaal 11 tekens):

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

Beperkingen:

Maximaal 11 tekens
Alleen letters en cijfers
Geen spaties of speciale tekens
Ontvanger kan niet antwoorden op alfanumerieke afzenders

Numerieke afzender

Gebruik een telefoonnummer als afzender (voor tweerichtings-sms):

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

Gebruiksscenario's

OTP-verificatie

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

Bestelmeldingen

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

Afspraakherinneringen

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

Betalingsbevestigingen

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

Beste praktijken

Berichtinhoud

✅ Houd berichten beknopt en duidelijk
✅ Inclusief afzenderidentificatie
✅ Voeg call-to-action toe indien nodig
✅ Gebruik de juiste grammatica en spelling
❌ Vermijd overmatige interpunctie!!!
❌ Gebruik niet alleen HOOFDLETTERS
❌ Vermijd URL-verkorters die er verdacht uitzien

Tekengebruik

Controleer het aantal tekens voordat u verzendt
Houd rekening met uitgebreide GSM-tekens (tel als 2)
Test met speciale tekens vóór bulkverzending
Overweeg het gebruik van GSM-codering voor langere berichten

Telefoonnummers

Gebruik altijd het E.164-formaat: +380XXXXXXXXX
Valideer telefoonnummers voordat u ze verzendt
Verwijder ongeldige nummers uit uw lijst
Houd uw contactenlijst up-to-date

Tijdstip

Respecteer lokale tijdzones
Vermijd verzending 's nachts (22.00 - 08.00 uur)
Houd rekening met openingstijden voor commerciële berichten
Stel de juiste TTL in voor tijdgevoelige berichten

Naleving

Verkrijg toestemming voordat u marketingberichten verzendt
Inclusief opt-out-instructies voor promotionele sms-berichten
Volg de lokale regelgeving (AVG, etc.)
Respecteer de "Niet storen"-lijsten

Foutafhandeling

Veelvoorkomende fouten

Fout	Oorzaak	Oplossing
`INVALID_RECIPIENT`	Verkeerd telefoonformaat	Gebruik het E.164-formaat
`INVALID_SENDER`	Ongeldige afzender-ID	Regels voor afzender-ID controleren
`MESSAGE_TOO_LONG`	Overschrijdt maximale lengte	Bericht splitsen of inkorten
`INVALID_ENCODING`	Niet-ondersteunde tekens	Gebruik GSM of Unicode

Kostenoptimalisatie

Berichtgedeelten verminderen

Houd berichten onder de 160 tekens (GSM) of 70 (Unicode)
Vermijd speciale tekens die Unicode activeren
Gebruik afkortingen waar nodig
Verwijder onnodige spaties

Voorbeeldoptimalisatie

❌ Voor (171 tekens, 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.

✅ Na (156 tekens, 1 sms):

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

Bulkverzending

Stuur meerdere berichten in één verzoek:

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

Volgende stappen

Viber-berichten - Rich media-berichten
RCS-berichten - Rijke communicatiediensten
Status controleren - Volg de leveringsstatus
Fallbackstrategieën - Configureer fallbacks