API заавар
SMS илгээх
Нэг дугаар руу шууд, эсвэл олон дугаар руу багцаар SMS илгээнэ.
/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"
}'{
"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₮ 🙂 илгээхэд:
{
"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 оронтой дугаар руу илгээнэ.
Өөр эхлэлтэй дугаар (суурин утас, гадаад дугаар гэх мэт) 422 unsupported_number алдаа буцаана. Кредит хасагдахгүй.
Хэсэг ба үнэ
Урт мессеж хэд хэдэн хэсэг болж тооцогдоно. Үнэ = хэсгийн тоо × нэг хэсгийн кредит × баярын үржүүлэгч.
Ганц тэмдэгт хангалттай. Латинаар бичсэн мессежид нэг эможи эсвэл ₮ орвол зөвхөн тэр тэмдэгт биш, мессеж бүхлээрээ латин бус горимд шилжиж, нэг хэсэгт 65 тэмдэгт багтана. Жишээ нь 120 тэмдэгттэй латин мессеж 1 хэсэг, түүнд нэг эможи нэмэхэд 2 хэсэг болж, үнэ нь 2 дахин нэмэгдэнэ.
4 хэсгээс урт мессеж 422 message_too_long алдаа буцаана. Алдаа нь encoding, non_latin_characters талбартай тул латин бус болгосон тэмдэгтийг шууд харна. Эможи 2 тэмдэгтээр тооцогдоно.
Латин тэмдэгт гэж аль нь вэ
Латин горимд зөвхөн операторын үндсэн цагаан толгойд байдаг ASCII тэмдэгтүүд багтана. Латин үсгээр бичсэн мессеж бүр латин горимд орох албагүй: доорх хоёр жагсаалтыг харьцуулна уу.
- Мөнгөн дүнг
₮-ийн оронд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"
}
}'Операторын жагсаалт
/v1/carriersWeSend илгээдэг операторууд, тэдгээрийн дугаарын эхлэл. id нь text_by_carrier-ийн түлхүүр.
curl https://api.wesend.mn/v1/carriers \
-H "Authorization: Bearer $WESEND_API_KEY"{
"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"
]
}
]
}Олон дугаар руу илгээх
/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"
}'{
"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}-ээр шалгана.