API заавар

SMS илгээх

Нэг дугаар руу шууд, эсвэл олон дугаар руу багцаар SMS илгээнэ.

POST/v1/sms

Нэг дугаар руу илгээнэ. Хариу ирэхэд мессеж операторт хүлээлгэн өгөгдсөн байна.

Биеийн талбарууд

tostringзаавал
8 оронтой дугаар. +976, зай, зураастай байж болно. Дэмжигдэх дугааруудыг доороос харна уу.
textstringзаавал
Мессежийн агуулга. Хамгийн ихдээ 4 хэсэг.
text_by_carrierobject
Оператор бүрт өөр текст: { "mobicom": "Sain baina uu?" }. Тухайн операторын дугаарт text-ийн оронд очно. Бусад нь text-ийг авна. Түлхүүр: mobicom, unitel, skytel, gmobile, ondo, lime.
curl -X POST https://api.wesend.mn/v1/sms \
  -H "Authorization: Bearer $WESEND_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "to": "99112233",
  "text": "Tanii zahialga batalgaajlaa. #1042"
}'
Хариу200 OK
{
  "id": "0b9c1a52-6f0e-4d8b-9a3c-2f1e5d7c8a90",
  "status": "sent",
  "channel": "sms",
  "to": "99112233",
  "parts": 1,
  "rate_multiplier": 1,
  "credits": 80,
  "batch_id": null,
  "error": null,
  "sandbox": false,
  "created_at": "2026-10-06T08:15:30.000Z",
  "sent_at": "2026-10-06T08:15:31.000Z",
  "encoding": "latin",
  "non_latin_characters": [],
  "balance": 4920
}

encoding нь мессеж хэрхэн тооцогдсоныг хэлнэ: latin бол нэг хэсэгт 155, unicode бол 65 тэмдэгт. non_latin_characters нь мессежийг unicode болгосон тэмдэгт бүрийг нэг удаа жагсаана (50 хүртэл). Латинаар бичсэн мессеж unicode болсон бол эндээс шалтгааныг нь харна. Дэлгэрэнгүйг «Латин тэмдэгт гэж аль нь вэ» хэсгээс үзнэ үү. Жишээ нь Une 10,000₮ 🙂 илгээхэд:

Хариу200 OK
{
  "id": "0b9c1a52-6f0e-4d8b-9a3c-2f1e5d7c8a90",
  "status": "sent",
  "channel": "sms",
  "to": "99112233",
  "parts": 1,
  "rate_multiplier": 1,
  "credits": 80,
  "batch_id": null,
  "error": null,
  "sandbox": false,
  "created_at": "2026-10-06T08:15:30.000Z",
  "sent_at": "2026-10-06T08:15:31.000Z",
  "encoding": "unicode",
  "non_latin_characters": [
    "₮",
    "🙂"
  ],
  "balance": 4920
}

Оператор мессежийг хүлээн аваагүй бол 502 provider_failed буцаж, кредит буцаагдана. Алдааны id талбарт амжилтгүй мессежийн дугаар байна.

ONDO, Lime дугаар руу, мөн бусад оператор мессежийг хүлээн аваагүй үед WeSend өөр сувгаар илгээнэ. Энэ суваг холбоос дамжуулдаггүй тул мессеж доторх холбоос (https://…, www.…, example.mn/…) хасагдаж хүргэгдэнэ. Мессеж зөвхөн холбоосоос бүрдсэн бол илгээхгүй, 502 provider_failed буцна.

Дэмжигдэх дугаарууд

Дугаарын эхний оронгоор операторыг тодорхойлно. Доорх эхлэлтэй 8 оронтой дугаар руу илгээнэ.

ОператорДугаарын эхлэл
Mobicom85, 94, 95, 99, мөн 5050-5099, 5550-5599
Skytel69, 90, 91, 92, 96
Unitel80, 86, 88, 89, мөн 5000-5049
G-Mobile78, 83, 87, 93, 97, 98
ONDO60, 66, мөн 8181
Lime72
Toki5500-5549 (Unitel-ийн сүлжээ)
KAOS505 (Mobicom-ийн сүлжээ)

Өөр эхлэлтэй дугаар (суурин утас, гадаад дугаар гэх мэт) 422 unsupported_number алдаа буцаана. Кредит хасагдахгүй.

Хэсэг ба үнэ

Урт мессеж хэд хэдэн хэсэг болж тооцогдоно. Үнэ = хэсгийн тоо × нэг хэсгийн кредит × баярын үржүүлэгч.

ГоримНэг хэсэгХэзээ
Латин (ASCII)155 тэмдэгтМессежийн бүх тэмдэгт доорх латин жагсаалтад багтсан үед
Латин бус (Unicode)65 тэмдэгтЖагсаалтад ороогүй ганц ч тэмдэгт байвал

Ганц тэмдэгт хангалттай. Латинаар бичсэн мессежид нэг эможи эсвэл ₮ орвол зөвхөн тэр тэмдэгт биш, мессеж бүхлээрээ латин бус горимд шилжиж, нэг хэсэгт 65 тэмдэгт багтана. Жишээ нь 120 тэмдэгттэй латин мессеж 1 хэсэг, түүнд нэг эможи нэмэхэд 2 хэсэг болж, үнэ нь 2 дахин нэмэгдэнэ.

4 хэсгээс урт мессеж 422 message_too_long алдаа буцаана. Алдаа нь encoding, non_latin_characters талбартай тул латин бус болгосон тэмдэгтийг шууд харна. Эможи 2 тэмдэгтээр тооцогдоно.

Латин тэмдэгт гэж аль нь вэ

Латин горимд зөвхөн операторын үндсэн цагаан толгойд байдаг ASCII тэмдэгтүүд багтана. Латин үсгээр бичсэн мессеж бүр латин горимд орох албагүй: доорх хоёр жагсаалтыг харьцуулна уу.

Латин горимд багтанаТэмдэгт
Англи үсэгA - Z, a - z
Тоо0 - 9
Зай, мөр шилжилтЭнгийн зай, Enter
Цэг, таслал, тэмдэгт! " # $ % & ' ( ) * + , - . / : ; < = > ? @ _
Латин горимоос гарганаТэмдэгт
Кирилл үсэгА - Я, а - я, Ө, Ү гэх мэт
Эможи😊 👍 ❤️ 🔥 гэх мэт бүгд
Мөнгөн тэмдэгт, тусгай тэмдэгт₮ € £ № ° © •
Утас, Word автоматаар солих тэмдэгтМуруй хашилт ‘ ’ “ ”, « », урт зураас –, гурван цэг …, тасрахгүй зай
Өргөлттэй үсэгé ü ö ñ гэх мэт
ASCII-ийн 9 тэмдэгт[ \ ] ^ { | } ~ болон урвуу хашилт. Оператор эдгээрийг 2 тэмдэгтээр тооцдог тул WeSend латин бус горимд тооцно
МессежГорим
Une 10,000TЛатин, нэг хэсэгт 155 тэмдэгт
Une 10,000₮Латин бус (₮), нэг хэсэгт 65 тэмдэгт
It's readyЛатин, энгийн хашилт '
It’s readyЛатин бус, муруй хашилт ’
Bayarlalaa :)Латин
Bayarlalaa 🙂Латин бус, эможи
  • Мөнгөн дүнг ₮-ийн оронд T эсвэл MNT гэж, инээмсэглэлийг эможигийн оронд :) гэж бичнэ.
  • Word, Google Docs, утаснаас хуулсан текстийг шалгана: тэд энгийн ' " --г муруй хашилт, урт зураасаар автоматаар солидог.
  • Хариуны parts нь мессеж хэдэн хэсэг болсныг, encoding, non_latin_characters нь яагаад гэдгийг хэлнэ. Sandbox түлхүүрээр кредит зарцуулалгүй шалгаж болно. Самбарын «SMS илгээх» хэсэг латин бус тэмдэгтийг тодруулж, нэг товчоор засна.

Оператор бүрт өөр текст

Mobicom 2 ба түүнээс олон хэсэгтэй SMS хүргэдэггүй. Тиймээс Mobicom дугаарт урт мессеж үгийн завсраар хуваагдаж, нэг хэсэгт багтах тусдаа SMS-үүд болж дараалан очно. SMS бүр нэг хэсгээр тооцогдох бөгөөд хариуны parts нь тэдгээрийн тоо. Цөөн SMS болгохын тулд Mobicom-д латинаар бичсэн богино текст, бусад операторт кирилл текст илгээж болно. Дугаар бүр өөрт очих текстээр тооцогдоно.

curl -X POST https://api.wesend.mn/v1/sms/bulk \
  -H "Authorization: Bearer $WESEND_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "to": [
    "99112233",
    "88112233"
  ],
  "text": "Сайн байна уу? Баярлалаа",
  "text_by_carrier": {
    "mobicom": "Sain baina uu? Bayarlalaa"
  }
}'

Операторын жагсаалт

GET/v1/carriers

WeSend илгээдэг операторууд, тэдгээрийн дугаарын эхлэл. id нь text_by_carrier-ийн түлхүүр.

curl https://api.wesend.mn/v1/carriers \
  -H "Authorization: Bearer $WESEND_API_KEY"
Хариу200 OK
{
  "data": [
    {
      "id": "mobicom",
      "name": "Mobicom",
      "includes": [
        {
          "name": "KAOS",
          "prefixes": [
            "505"
          ]
        }
      ],
      "multipart": false,
      "links": true,
      "prefixes": [
        "85",
        "94",
        "95",
        "99",
        "5050-5099",
        "5550-5599"
      ]
    },
    {
      "id": "unitel",
      "name": "Unitel",
      "includes": [
        {
          "name": "Toki",
          "prefixes": [
            "5500-5549"
          ]
        }
      ],
      "multipart": true,
      "links": true,
      "prefixes": [
        "80",
        "86",
        "88",
        "89",
        "5000-5049",
        "5500-5549"
      ]
    },
    {
      "id": "ondo",
      "name": "ONDO",
      "includes": [],
      "multipart": true,
      "links": false,
      "prefixes": [
        "60",
        "66",
        "8181"
      ]
    }
  ]
}
ТалбарУтга
includesТухайн операторын сүлжээгээр явдаг брэнд: KAOS нь Mobicom, Toki нь Unitel.
multipartfalse бол 2 ба түүнээс олон хэсэгтэй SMS хүргэдэггүй: урт мессеж үгээр хуваагдаж тусдаа SMS-үүд болж очно (Mobicom).
linksfalse бол холбоос үргэлж хасагдаж хүргэгдэнэ (ONDO, Lime).

Олон дугаар руу илгээх

POST/v1/sms/bulk

Нэг агуулгыг 1,000 хүртэл дугаар руу илгээнэ. Мессежүүд дараалалд орж, ар талд илгээгдэнэ.

Биеийн талбарууд

tostring[]заавал
1-1,000 дугаар. Давхардсан дугаарыг нэг болгоно.
textstringзаавал
Бүх хүлээн авагчид очих агуулга.
text_by_carrierobject
Оператор бүрт өөр текст: { "mobicom": "Sain baina uu?" }. Тухайн операторын дугаарт text-ийн оронд очно. Бусад нь text-ийг авна. Түлхүүр: mobicom, unitel, skytel, gmobile, ondo, lime.
curl -X POST https://api.wesend.mn/v1/sms/bulk \
  -H "Authorization: Bearer $WESEND_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "to": [
    "99112233",
    "88112233",
    "95112233"
  ],
  "text": "Shine baraa irlee! shop.mn"
}'
Хариу202 Accepted
{
  "id": "5d2a7c1e-93b4-4f6a-8e0d-b1c2d3e4f5a6",
  "status": "processing",
  "channel": "sms",
  "total": 3,
  "sent": 0,
  "failed": 0,
  "credits": 240,
  "sandbox": false,
  "created_at": "2026-10-06T08:15:30.000Z",
  "completed_at": null,
  "encoding": "latin",
  "non_latin_characters": [],
  "balance": 4680
}

encoding, non_latin_characters нь text-ийнх. text_by_carrier өгсөн бол оператор бүрийн текстийнх encoding_by_carrier-д ирнэ: { "mobicom": { "encoding": "latin", "non_latin_characters": [] } }.

  • Багцын нийт кредитийг эхэнд нь нэг дор суутгана. Илгээгдээгүй мессеж бүрийн кредит буцна.
  • Нэг ч буруу эсвэл дэмжигдээгүй дугаар байвал хүсэлт бүхлээрээ 400 invalid_request болж, алдааны invalid талбарт буруу дугааруудыг (50 хүртэл) жагсаана. Юу ч илгээгдэхгүй, суутгагдахгүй.
  • Явцыг GET /batches/{id}-ээр шалгана.