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

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

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