Pāriet uz saturu

SMS ziņas

Sūtiet standarta īsziņas, izmantojot SMSBAT API. SMS ir universālākais ziņojumapmaiņas kanāls ar visaugstākajiem piegādes rādītājiem visās mobilajās ierīcēs.

Pārskats

SMS (īsziņu pakalpojums) ir ideāli piemērots:

  • Laika kritiskie paziņojumi
  • Atkāpšanās Viber/RCS ziņojumiem
  • Sasniedziet lietotājus bez viedtālruņiem
  • Universāla saderība visos mobilajos tīklos
  • Augstas piegādes likmes (95%+)

Pamata īsziņa

Pieprasījums

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

Parametri

Parametrs Tips Nepieciešams Apraksts
no stīga Jā Burtciparu sūtītāja ID (līdz 11 rakstzīmēm)
uz stīga Jā Saņēmēja tālruņa numurs E.164 formātā
"tips" stīga Jā Iestatīt uz "īsziņas"
teksts stīga Jā Ziņojuma saturs
customerMessageId stīga Nē Jūsu iekšējais izsekošanas ID
ttl vesels skaitlis Nē Izdzīvošanas laiks sekundēs

Piemēri

Vienkārša 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 ar klienta ID

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

SMS ar TTL

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

Rakstzīmju kodējums

GSM 7 bitu kodējums

Standarta GSM alfabēts (160 rakstzīmes vienā īsziņā):

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

Paplašinātās GSM rakstzīmes

Šīs rakstzīmes skaitās 2 rakstzīmes:

| ^ € { } [ ] ~ \

Unikoda (UCS-2) kodējums

Ziņojumos ar speciālajām rakstzīmēm tiek izmantots unikoda kodējums (70 rakstzīmes vienā īsziņā):

  • Emocijzīme: 😀 🎉 ❤️
  • Kirilica: А Б В Г Д Е Ж
  • Īpaši simboli: ✓ ✗ ★ ♥

Ziņojuma garums

Viena SMS

  • GSM 7 bitu: 160 rakstzīmes
  • Unikods: 70 rakstzīmes

Daudzdaļīga SMS

Kad jūsu ziņojums pārsniedz ierobežojumu, tas tiek sadalīts vairākās daļās:

  • GSM 7 bitu: 153 rakstzīmes katrā daļā
  • Unikods: 67 rakstzīmes katrā daļā

Piemērs

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

Šis ziņojums (201 rakstzīme) tiks sadalīts 2 daļās.

Atbilde

Veiksmīga atbilde

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

Atbildes lauki

Lauks Apraksts
messageId Unikāls izsekošanas identifikators
statuss Ziņojuma statuss ("pieņemts", "noraidīts")
"daļas" SMS daļu skaits
uz Saņēmēja tālruņa numurs

Sūtītāja ID

Burtciparu sūtītājs

Izmantojiet sava zīmola nosaukumu kā sūtītāju (līdz 11 rakstzīmēm):

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

Ierobežojumi:

  • Ne vairāk kā 11 rakstzīmes
  • Tikai burti un cipari
  • Bez atstarpēm vai īpašām rakstzīmēm
  • Adresāts nevar atbildēt burtciparu sūtītājiem

Skaitliskais sūtītājs

Izmantojiet tālruņa numuru kā sūtītāju (divvirzienu SMS):

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

Lietošanas gadījumi

OTP verifikācija

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

Pasūtījumu paziņojumi

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

Atgādinājumi par tikšanos

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

Maksājuma apstiprinājumi

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

Labākā prakse

Ziņojuma saturs

  • ✅ Saglabājiet ziņojumus kodolīgus un skaidrus
  • ✅ Iekļaut sūtītāja identifikāciju
  • ✅ Ja nepieciešams, pievienojiet aicinājumu uz darbību
  • ✅ Izmantojiet pareizu gramatiku un pareizrakstību
  • ❌ Izvairieties no pārmērīgas pieturzīmju lietošanas!!!
  • ❌ Neizmantojiet visus lielos burtus
  • ❌ Izvairieties no URL saīsinātājiem, kas izskatās aizdomīgi

Rakstzīmju lietojums

  • Pirms nosūtīšanas pārbaudiet rakstzīmju skaitu
  • Esiet informēts par paplašinātajām GSM rakstzīmēm (skaitiet 2)
  • Pirms lielapjoma sūtīšanas pārbaudiet ar speciālajām rakstzīmēm
  • Apsveriet iespēju izmantot GSM kodējumu garākiem ziņojumiem

Tālruņa numuri

  • Vienmēr izmantojiet E.164 formātu: +380XXXXXXXXX
  • Pirms nosūtīšanas apstipriniet tālruņa numurus
  • Noņemiet nederīgos numurus no sava saraksta
  • Atjauniniet savu kontaktpersonu sarakstu

Laiks

  • Ievērojiet vietējās laika joslas
  • Izvairieties no sūtīšanas naktī (22:00–8:00)
  • Apsveriet komerciālo ziņojumu darba laiku
  • Iestatiet atbilstošu TTL ziņojumiem, kas ir jutīgi pret laiku

Atbilstība

  • Pirms mārketinga ziņojumu nosūtīšanas saņemiet piekrišanu
  • Iekļaujiet atteikšanās instrukcijas reklāmas īsziņām
  • Ievērojiet vietējos noteikumus (VDAR utt.)
  • Ievērojiet "Netraucēt" sarakstus

Kļūdu apstrāde

Izplatītas kļūdas

Kļūda Cēlonis Risinājums
INVALID_RECIPIENT Nepareizs tālruņa formāts Izmantojiet E.164 formātu
INVALID_SENDER Nederīgs sūtītāja ID Pārbaudiet sūtītāja ID noteikumus
MESSAGE_TOO_LONG Pārsniedz maksimālo garumu Sadaliet vai saīsiniet ziņojumu
INVALID_ENCODING Neatbalstītas rakstzīmes Izmantojiet GSM vai Unicode

Izmaksu optimizācija

Samaziniet ziņojumu daļas

  • Saglabājiet ziņojumus, kas nepārsniedz 160 rakstzīmes (GSM) vai 70 rakstzīmes (unikods)
  • Izvairieties no īpašām rakstzīmēm, kas aktivizē Unicode
  • Ja nepieciešams, izmantojiet saīsinājumus
  • Noņemiet nevajadzīgās vietas

Optimizācijas piemērs

❌ Pirms (171 rakstzīme, 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.

✅ Pēc (156 rakstzīmes, 1 SMS): 

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

Lielapjoma sūtīšana

Nosūtiet vairākus ziņojumus vienā pieprasījumā:

{
  "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ākamie soļi