Zum Inhalt

SMS-Nachrichten

Senden Sie Standardtextnachrichten mit der SMSBAT-API. SMS ist der universellste Nachrichtenkanal mit den höchsten Zustellraten auf allen Mobilgeräten.

Übersicht

SMS (Short Message Service) ist ideal für:

  • Zeitkritische Benachrichtigungen
  • Fallback für Viber/RCS-Nachrichten
  • Nutzer ohne Smartphone erreichen
  • Universelle Kompatibilität in allen Mobilfunknetzen
  • Hohe Zustellraten (95 %+)

Einfache SMS-Nachricht

Anfrage

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

Parameter

Parameter Geben Sie ein Erforderlich Beschreibung
„von“ Zeichenfolge Ja Alphanumerische Absender-ID (bis zu 11 Zeichen)
„zu“ Zeichenfolge Ja Telefonnummer des Empfängers im E.164-Format
„Typ“ Zeichenfolge Ja Auf „sms“ setzen
Text Zeichenfolge Ja Nachrichteninhalt
customerMessageId Zeichenfolge Nein Ihre interne Tracking-ID
ttl Ganzzahl Nein Lebensdauer in Sekunden

Beispiele

Einfache 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 mit Kunden-ID

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

SMS mit TTL

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

Zeichenkodierung

GSM 7-Bit-Kodierung

Standard-GSM-Alphabet (160 Zeichen pro SMS):

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

Erweiterte GSM-Zeichen

Diese Zeichen zählen als 2 Zeichen:

| ^ € { } [ ] ~ \

Unicode (UCS-2)-Kodierung

Nachrichten mit Sonderzeichen verwenden die Unicode-Kodierung (70 Zeichen pro SMS):

  • Emoji: 😀 🎉 ❤️
  • Kyrillisch: А Б Г Ä Е Ж
  • Sondersymbole: ✓ ✗ ★ ♥

Nachrichtenlänge

Einzelne SMS

  • GSM 7-Bit: 160 Zeichen
  • Unicode: 70 Zeichen

Mehrteilige SMS

Wenn Ihre Nachricht das Limit überschreitet, wird sie in mehrere Teile aufgeteilt:

  • GSM 7-Bit: 153 Zeichen pro Teil
  • Unicode: 67 Zeichen pro Teil

Beispiel

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

Diese Nachricht (201 Zeichen) wird in zwei Teile aufgeteilt.

Antwort

Erfolgsantwort

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

Antwortfelder

Feld Beschreibung
messageId Eindeutige Kennung für die Nachverfolgung
Status Nachrichtenstatus („akzeptiert“, „abgelehnt“)
„Teile“ Anzahl der SMS-Teile
„zu“ Telefonnummer des Empfängers

Absender-ID

Alphanumerischer Absender

Verwenden Sie Ihren Markennamen als Absender (bis zu 11 Zeichen):

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

Einschränkungen:

  • Maximal 11 Zeichen
  • Nur Buchstaben und Zahlen
  • Keine Leerzeichen oder Sonderzeichen
  • Der Empfänger kann nicht auf alphanumerische Absender antworten

Numerischer Absender

Verwenden Sie eine Telefonnummer als Absender (für bidirektionale SMS):

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

Anwendungsfälle

OTP-Verifizierung

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

Bestellbenachrichtigungen

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

Terminerinnerungen

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

Zahlungsbestätigungen

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

Best Practices

Nachrichteninhalt

  • ✅ Halten Sie Nachrichten prägnant und klar
  • ✅ Geben Sie die Absenderidentifikation an
  • ✅ Fügen Sie bei Bedarf einen Call-to-Action hinzu
  • ✅ Verwenden Sie die richtige Grammatik und Rechtschreibung
  • ❌ Vermeiden Sie übermäßige Interpunktion!!!
  • ❌ Verwenden Sie nicht nur Großbuchstaben
  • ❌ Vermeiden Sie URL-Shortener, die verdächtig aussehen

Zeichenverwendung

  • Überprüfen Sie vor dem Senden die Anzahl der Zeichen
  • Beachten Sie die erweiterten GSM-Zeichen (zählen als 2)
  • Testen Sie vor dem Massenversand Sonderzeichen
  • Erwägen Sie die Verwendung der GSM-Verschlüsselung für längere Nachrichten

Telefonnummern

  • Verwenden Sie immer das E.164-Format: „+380XXXXXXXXX“.
  • Überprüfen Sie die Telefonnummern vor dem Senden
  • Entfernen Sie ungültige Nummern aus Ihrer Liste
  • Halten Sie Ihre Kontaktliste auf dem neuesten Stand

Timing

  • Respektieren Sie die lokalen Zeitzonen
  • Vermeiden Sie es, nachts (22:00–8:00 Uhr) zu senden.
  • Berücksichtigen Sie die Geschäftszeiten für kommerzielle Nachrichten – Legen Sie die entsprechende TTL für zeitkritische Nachrichten fest

Compliance

  • Holen Sie vor dem Versenden von Marketingnachrichten Ihre Einwilligung ein
  • Fügen Sie Anweisungen zur Abmeldung für Werbe-SMS bei
  • Befolgen Sie die örtlichen Vorschriften (DSGVO usw.)
  • Beachten Sie die „Bitte nicht stören“-Listen

Fehlerbehandlung

Häufige Fehler

Fehler Ursache Lösung
„INVALID_RECIPIENT“ Falsches Telefonformat Verwenden Sie das E.164-Format
„INVALID_SENDER“ Ungültige Absender-ID Überprüfen Sie die Absender-ID-Regeln
„MESSAGE_TOO_LONG“ Überschreitet die maximale Länge Nachricht teilen oder kürzen
„INVALID_ENCODING“ Nicht unterstützte Zeichen Verwenden Sie GSM oder Unicode

Kostenoptimierung

Nachrichtenteile reduzieren

  • Behalten Sie Nachrichten unter 160 Zeichen (GSM) oder 70 (Unicode) bei.
  • Vermeiden Sie Sonderzeichen, die Unicode auslösen
  • Verwenden Sie gegebenenfalls Abkürzungen
  • Entfernen Sie unnötige Leerzeichen

Beispieloptimierung

❌ Vorher (171 Zeichen, 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.

✅ Nachher (156 Zeichen, 1 SMS): 

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

Massenversand

Senden Sie mehrere Nachrichten in einer Anfrage:

{
  "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ächste Schritte

– Viber-Nachrichten – Rich-Media-Nachrichten – RCS-Nachrichten – Umfangreiche Kommunikationsdienste - Status prüfen – Verfolgen Sie den Lieferstatus – Fallback-Strategien – Konfigurieren Sie Fallbacks