SMS հաղորդագրություններ

Ուղարկեք ստանդարտ տեքստային հաղորդագրություններ SMSBAT API-ի միջոցով: SMS-ը ամենաունիվերսալ հաղորդագրությունների ալիքն է, որն ունի առաքման ամենաբարձր սակագները բոլոր բջջային սարքերում:

Տեսություն

SMS (կարճ հաղորդագրությունների ծառայություն) իդեալական է.

• Ժամանակի համար կարևոր ծանուցումներ
• Հետադարձ կապ Viber/RCS հաղորդագրությունների համար
• Հասնել օգտատերերին առանց սմարթֆոնների
• Համընդհանուր համատեղելիություն բոլոր բջջային ցանցերում
• Առաքման բարձր գներ (95%+)

Հիմնական SMS հաղորդագրություն

հարցում

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

Պարամետրեր

Պարամետր	Տեսակ	Պահանջվում է	Նկարագրություն
«ից»	լարային	Այո	Այբբենարան ուղարկողի ID (մինչև 11 նիշ)
«դեպի»	լարային	Այո	Ստացողի հեռախոսահամարը E.164 ձևաչափով
«տեսակ»	լարային	Այո	Սահմանել «sms»՝
«տեքստ»	լարային	Այո	Հաղորդագրության բովանդակությունը
«customerMessageId»	լարային	Ոչ	Ձեր ներքին հետագծման ID-ն
«ttl»	ամբողջ թիվ	Ոչ	Ապրելու ժամանակը վայրկյաններով

Օրինակներ

Պարզ 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 Հաճախորդի ID-ով

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

SMS TTL-ով

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

Նիշերի կոդավորում

GSM 7-բիթանոց կոդավորում

Ստանդարտ GSM այբուբեն (160 նիշ մեկ SMS-ի համար).

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

Ընդլայնված GSM նիշեր

Այս նիշերը հաշվվում են որպես 2 նիշ.

| ^ € { } [ ] ~ \

Unicode (UCS-2) կոդավորում

Հատուկ նիշերով հաղորդագրությունները օգտագործում են Unicode կոդավորումը (70 նիշ մեկ SMS-ի համար).

• Էմոջի՝ 😀 🎉 ❤️
• Կիրիլիցա՝ А Б В Г Д Е Ж
• Հատուկ նշաններ՝ ✓ ✗ ★ ♥

Հաղորդագրության երկարությունը

Մեկ SMS

• GSM 7-bit ՝ 160 նիշ
• Յունիկոդ՝ 70 նիշ

Բազմամասային SMS

Երբ ձեր հաղորդագրությունը գերազանցում է սահմանը, այն բաժանվում է մի քանի մասերի.

• GSM 7-bit ՝ 153 նիշ մեկ մասի համար
• Յունիկոդ՝ 67 նիշ յուրաքանչյուր մասի համար

Օրինակ

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

Այս հաղորդագրությունը (201 նիշ) կբաժանվի 2 մասի:

Պատասխան

Հաջողության պատասխան

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

Արձագանքման դաշտեր

Դաշտային	Նկարագրություն
«messageId»	Եզակի նույնացուցիչ՝ հետևելու համար
«կարգավիճակ»	Հաղորդագրության կարգավիճակը (ընդունված,մերժված)
«մասեր»	SMS մասերի քանակը
«դեպի»	Ստացողի հեռախոսահամարը

Ուղարկողի ID

Ալֆան-թվային ուղարկող

Օգտագործեք ձեր ապրանքանիշը որպես ուղարկող (մինչև 11 նիշ).

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

Սահմանափակումներ:

• Առավելագույնը 11 նիշ
• Միայն տառեր և թվեր
• Առանց բացատների կամ հատուկ նիշերի
• Ստացողը չի կարող պատասխանել այբբենական թվային ուղարկողներին

Թվային ուղարկող

Օգտագործեք հեռախոսահամար որպես ուղարկող (երկկողմանի SMS-ի համար).

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

Օգտագործման դեպքեր

OTP ստուգում

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

Պատվերի ծանուցումներ

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

Նշանակման հիշեցումներ

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

Վճարման հաստատումներ

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

Լավագույն պրակտիկա

Հաղորդագրության բովանդակություն

• ✅ Պահպանեք հաղորդագրությունները հակիրճ և պարզ
• ✅ Ներառում է ուղարկողի նույնականացումը
• ✅ Անհրաժեշտության դեպքում ավելացրեք գործողության կոչ
• ✅ Օգտագործեք ճիշտ քերականություն և ուղղագրություն
• ❌ Խուսափեք ավելորդ կետադրությունից!!!
• ❌ Մի օգտագործեք բոլոր CAPS-ները
• ❌ Խուսափեք URL կրճատողներից, որոնք կասկածելի են թվում

Նիշերի օգտագործում

• Ստուգեք նիշերի քանակը ուղարկելուց առաջ
• Իմացեք ընդլայնված GSM նիշերի մասին (հաշվեք որպես 2)
• Փորձարկեք հատուկ նիշերով նախքան զանգվածային ուղարկելը
• Մտածեք ավելի երկար հաղորդագրությունների համար օգտագործել GSM կոդավորումը

Հեռախոսահամարներ

• Միշտ օգտագործեք E.164 ձևաչափը՝ «+380XXXXXXXXX»:
• Վավերացրեք հեռախոսահամարները նախքան ուղարկելը
• Հեռացրեք անվավեր համարները ձեր ցուցակից
• Պահպանեք ձեր կոնտակտների ցանկը թարմացված

Ժամկետ

• Հարգեք տեղական ժամային գոտիները
• Խուսափեք գիշերը ուղարկելուց (22:00 - 8:00)
• Հաշվի առեք առևտրային հաղորդագրությունների աշխատանքային ժամերը
• Սահմանեք համապատասխան TTL ժամանակի զգայուն հաղորդագրությունների համար

Համապատասխանություն

• Ստացեք համաձայնություն նախքան մարքեթինգային հաղորդագրություններ ուղարկելը
• Ներառեք գովազդային SMS-ների անջատման հրահանգներ
• Հետևեք տեղական կանոնակարգերին (GDPR և այլն)
• Հարգեք «Մի խանգարեք» ցուցակները

Սխալների մշակում

Ընդհանուր սխալներ

Սխալ	Պատճառը	Լուծում
«INVALID_RECIPIENT»	Հեռախոսի սխալ ձևաչափ	Օգտագործեք E.164 ձևաչափը
«INVALID_SENDER»	Անվավեր ուղարկողի ID	Ստուգեք ուղարկողի ID կանոնները
«MESSAGE_TOO_LONG»	Գերազանցում է առավելագույն երկարությունը	Բաժանել կամ կրճատել հաղորդագրությունը
«INVALID_ENCODING»	Չաջակցվող նիշ	Օգտագործեք GSM կամ Unicode

Ծախսերի օպտիմիզացում

Կրճատել հաղորդագրության մասերը

• Պահպանեք հաղորդագրությունները մինչև 160 նիշ (GSM) կամ 70 (Յունիկոդ)
• Խուսափեք հատուկ նիշերից, որոնք գործարկում են Unicode-ը
• Անհրաժեշտության դեպքում օգտագործեք հապավումներ
• Հեռացրեք ավելորդ բացատները

Օպտիմալացման օրինակ

❌ Նախկինում (171 նիշ, 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.

✅ Հետո (156 նիշ, 1 SMS).

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

Զանգվածային ուղարկում

Ուղարկեք բազմաթիվ հաղորդագրություններ մեկ հարցման մեջ.

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

Հաջորդ քայլերը

• Viber Messages - Հարուստ մեդիա հաղորդագրություններ
• RCS Messages - Հարուստ հաղորդակցման ծառայություններ
• Ստուգեք կարգավիճակը - Հետևեք առաքման կարգավիճակին
• Fallback Strategies - Կարգավորել հետադարձ կապերը