Бұл модуль SMS кампанияларын құруға, оларды алушыларды мүмкін тәсілдердің бірімен қосуға, кампанияны жіберуге жіберуге, өзекті емес кампанияларды жоюға, кампаниялар тізімін қарауға және олар бойынша іздеуге арналған функцияларды қамтиды.
Массалық SMS науқанына алушыларды қосу
https://api.mobizon.kz/service/Campaign/AddRecipients
Жаңа науқан құру
https://api.mobizon.kz/service/Campaign/Create
Науқанды жою
https://api.mobizon.kz/service/Campaign/Delete
Науқанның негізгі деректерін алу
https://api.mobizon.kz/service/Campaign/Get
Кампанияның статистикалық деректерін алу
https://api.mobizon.kz/service/Campaign/GetInfo
Науқандар тізімін алу
https://api.mobizon.kz/service/Campaign/List
Кампанияны жіберу
https://api.mobizon.kz/service/Campaign/Send
https://api.mobizon.kz/service/Campaign/AddRecipients
Бір сұрауда тек бір типтегі алушылар туралы деректерді жіберуге рұқсат етіледі:
Әртүрлі алушылар типтерін бірден жіберуге тырысқанда 12 қатесі қайтарылады. Егер бір науқанға бірнеше көздерден алушыларды қосу қажет болса, оны бірнеше сұрауда орындау керек.
Алушылардың нөмірлерін, контактілерін немесе байланыс карталарын қосқанда, бір сұрауда жүктелетін алушылардың ең көп саны 500 нөмірден аспауы керек. Шектен асқан жағдайда 12 қатесі қайтарылады және алушылар қосылмайды.
Кез келген қажетті байланыстар санын бір науқанға жүктеу үшін тізімді 500 немесе одан аз бөліктерге бөлу қажет және әрбір бөлікті API арқылы жүктеу керек - алушылар бар тізімге қосылады, егер replace=1 параметрі көрсетілмесе.
Нөмірлерді, байланыстарды және карталарды жүктеу веб-сервердің негізгі ағынында орындалады және әрбір өңделген алушы үшін массив түрінде нәтиже қайтарады (қайтарылатын деректер форматын төменде қараңыз).
Байланыс тобы немесе файлдан жүктеу фондық тапсырма (асинхронды жүктеу) құруды шақырады және оның күйін қадағалау үшін оның ID қайтарылады. Бұл жағдайда API жауабының коды 100 болады.
Алушылардың нөмірлері халықаралық форматта жіберілуі керек. Нөмірден барлық бөгде таңбалар автоматты түрде жойылады.
Әрбір нөмір ел коды мен оған тиесілі операторға сәйкес хабарлама жіберу мүмкіндігі бойынша тексеріледі.
Барлық тексеруден өтпеген нөмірлер сәйкес қате кодымен (code) қабылданбайды, ал әрбір қосылған нөмір үшін хабарлама статусының кейінгі сұрауы үшін жасалған хабарламаның ID қайтарылады.
Егер жіберілген барлық алушылар қосылмаса (қателер пайда болса), онда API екі жауап кодтарының бірін қайтаруы мүмкін:
Алушыларды қосу кезінде науқан басқа процестермен қосудан блокталады, сондықтан бір науқанға бірнеше ағынмен параллельді қосу мүмкін емес.
Параметр | Түрі | Сипаттамасы |
---|---|---|
id | integer | Алушыларды қосу қажет науқанның идентификаторы |
recipients | array string | Қарапайым тарату үшін (мәтіндегі ауыстыру айнымалыларын пайдаланбай) алушыларды мына түрде жіберуге болады:
recipient және алушы нөмірі бар массив. Сол сияқты, бұл массивте SMS мәтініндегі ауыстыру айнымалыларының атауларына сәйкес келетін кілттері бар элементтер болуы мүмкін (фигурлық жақшасыз).Бұл ретте, егер мәтінде бар кейбір ауыстыру айнымалылары массивте көрсетілмесе, онда өңдеу params[placeholdersFlag] параметрінде берілген мәнге байланысты болады (төменде осы параметрдің сипаттамасын қараңыз). |
recipientContacts | array string | Байланыс кітабындағы контактілердің үтірлермен немесе жолдардың ауысуларымен бөлінген массиві немесе жолы. Байланыс мына түрде көрсетілуі мүмкін:
|
recipientGroups | array string | Байланыс кітабындағы топтардың идентификаторларының үтірлермен немесе жолдардың ауысуларымен бөлінген массиві немесе жолы, ол арқылы науқан құрылады. Егер бір байланыс бірнеше топта болса - ол науқанға бір рет қана қосылады. Егер бірнеше байланыста бірдей телефон нөмірі болса - тек бірінші болып қосылғаны қосылады. |
recipientsFile | file | Алушылар тізімі бар файл объектісі - CSV немесе Excel (тек XLS) файл, халықаралық форматтағы алушылар нөмірлері бар. Қарапайым тарату үшін (мәтіндегі ауыстыру айнымалыларын пайдаланбай) - жолда бір нөмір. Шаблондық тарату үшін - жолда бір нөмір және бірінші жолда recipient тақырыбы бар бағанда, ал қалған бағандарда ауыстыру айнымалыларына арналған деректер болуы мүмкін. Мұндай бағандардың тақырыптары (кестенің бірінші жолында) SMS мәтініндегі ауыстыру айнымалыларына қатаң сәйкес келуі керек (фигурлық жақшаларсыз, регистрді ескере отырып). Ауыстыру айнымалы атаулары үшін тек латын әріптері мен цифрлар, сондай-ақ '_ ', '- ' таңбалары рұқсат етіледі. Бірдей тақырыптары бар бағандар болған жағдайда, қате қайтарылады.Бұл ретте, егер мәтінде бар кейбір ауыстыру айнымалыларына сәйкес бағандар болмаса, онда өңдеу params[placeholdersFlag] параметрінде берілген мәнге байланысты болады (төменде осы параметрдің сипаттамасын қараңыз). |
params | array | Қосымша баптаулар (қосымша баптаулар кестесін осы жерден қараңыз). |
Параметр | Түрі | Сипаттамасы |
---|---|---|
params[replace] | integer | Барлық қосылған алушыларды жою және қайтадан қосуды бастау керектігін көрсетеді: 0 - жоқ, алушыларды бұрын қосылғандарға қосу (әдепкі мәні); 1 - иә, жаңа алушыларды қосар алдында барлық бұрын қосылған алушыларды жою; |
params[placeholdersFlag] | integer | Шаблондық тарату үшін жетіспейтін ауыстыру айнымалыларын өңдеу. Егер мәтінге ауыстыру үшін айнымалылар мәндері табылмаса, келесі әрекеттердің бірі мүмкін: 1 - хабарлама таратуға қосылады, бірақ ауыстыру айнымалылары мәтінде қалай болса солай қалады, ауыстыру орындалмайды (әдепкі әрекет); 2 - хабарлама таратуға қосылады, ал ауыстыру айнымалылары жойылады (егер сіз мәтінде фигурлық жақшаларды пайдалансаңыз және олардың жіберу кезінде жойылуын қаламасаңыз, бұл пайдалы болуы мүмкін); 3 - хабарлама мәтінге ауыстыру үшін деректердің жетіспеуіне байланысты қатемен қабылданбайды. |
params[recipientsFileEncoding] | string | Алушылар деректері бар файлдың кодталуы. Қол жетімді кодтаулар: KOI8-R, CP866, WINDOWS-1252, WINDOWS-1251, UTF-8, ASCII, ISO-8859-1, UCS-2. Әдепкі бойынша: UTF-8. |
params[recipientsFileSkipHeader] | integer | Файлдың бірінші жолын өткізіп жіберу және өңдеуді екінші жолдан бастау керектігін көрсетеді. Алушыларды бірінші жолда бағандардың атаулары бар файлдан жүктеген кезде пайдалы. Бұл жағдайда бірінші жолды өткізіп жіберіп, файлды екінші жолдан өңдеуді бастау керек. Мүмкін мәндер: 0 - бірінші жолдан бастау (әдепкі мәні); 1 - файлдың бірінші жолын өткізіп жіберіп, екінші жолдан бастау (шаблондық таратуда мәжбүрлі түрде орнатылған); Шаблондық тарату кезінде бұл параметрдің мәні әрқашан 1 және қайта орнатылмайды, себебі бірінші жолда ауыстыру айнымалыларының атаулары болуы керек. |
params[recipientsFileDelimiter] | string | Алушылар деректері бар файлдағы бағандардың бөлгіші, әдепкі бойынша: , (үтір). Қажет болған жағдайда кез келген басқа таңбаны қолдануға болады. |
params[recipientsFileEnclosure] | string | Алушылар деректері бар файлдағы мәтіннің қоршауы, әдепкі бойынша: ' (жалғыз тырнақша). Бұл таңба бағандардағы мәтінді екі жағынан қоршауы керек, осылайша жүйе файлды бағандарға дұрыс талдай алады. |
array | integer : Нөмірлер тізімі, контактілер немесе байланыс карталарынан алушыларды жүктеу кезінде әрбір элементінде алушылар туралы деректер бар массив қайтарылады:
Өріс | Түрі | Сипаттамасы |
---|---|---|
recipient | string | Науқанға қосылатын алушының нөмірі |
code | integer | Алушыны қосу нәтижесінің коды: 0 - нөмір сәтті науқанға қосылды 1 - жіберілген деректерде телефон нөмірі жоқ немесе оның мәні бос 2 - жіберілген деректерде телефон нөмірі табылмады (мүмкін, деректер дұрыс форматталмаған) 3 - нөмір халықаралық телефон нөмірлерінің форматына сәйкес келмейді 4 - нөмір науқанға бұрыннан қосылған (таратудан қайталануларды алып тастау) 5 - нөмір стоп-тізімде (бұл сіздің стоп-тізіміңіз немесе жүйенің стоп-тізімі болуы мүмкін) 6 - жіберу шотыңыздың параметрлерімен мақсатты елге шектелген 7 - мақсатты ел мен/немесе операторды анықтау мүмкін емес 8 - жүйеде осы операторға жіберу мүмкіндігі жоқ, жіберу мүмкіндігін нақтылау үшін техникалық қолдау қызметіне хабарласыңыз 20 - жіберілген деректер барлық қажетті ауыстыру айнымалыларын қамтымайды (егер placeholdersFlag мәні 1 орнатылған болса)30 - байланыс картасы байланыс кітабында табылмады ( recipient мәні null болады)31 - байланыс картасында мобильді нөмір жоқ ( recipient мәні null болады)32 - байланыс байланыс кітабында табылмады ( recipient мәні null болады)51 - техникалық себептерге байланысты қысқа сілтеме жасау мүмкін емес 99 - алушы нөмірін қосу кезінде жүйелік қате |
messageId | integer | Нөмір қосылған жағдайда хабарламаның идентификаторы, көрсетілген идентификатор бойынша хабарламаның күйін алуға болады. |
number | integer | Пайдаланушы жіберген алушы нөмірінің бастапқы мәні (егер алушы нөмірі жіберілген болса) |
contact | integer | Жіберілген байланыстың идентификаторы (егер recipientContacts жіберілсе) |
Файлдан алушыларды немесе байланыс топтарын жүктеу кезінде алушыларды қосу фондық тапсырмасының сандық идентификаторы қайтарылады. Фондық тапсырмаларды өңдеу туралы толық ақпаратты осы жерден табуға болады.
Код | Сипаттамасы |
---|---|
1 | Егер қандай да бір параметрлерде дұрыс емес мәндер бар болса. |
2 | Егер көрсетілген ID бар науқан табылмаса. |
10 | Егер көрсетілген науқан алушыларды қосу процесімен немесе науқанның күйі алушыларды қосуға мүмкіндік бермейтін күйде болса. |
12 | Егер алушылардың бірде-бір типі жіберілмесе немесе бір сұрауда бірнеше алушылар типтері жіберілсе. |
98 | Егер барлық жіберілген алушылардың кем дегенде біреуі науқанға қосылмаса. |
99 | Егер сұрау нәтижесінде бірде-бір алушы науқанға қосылмаса. |
100 | Егер алушыларды қосу фондық тапсырмасы басталса. Фондық тапсырмаларды өңдеу туралы толық ақпаратты осы жерден табуға болады. |
Алушылар тізімін таратуға қосу үшін олардың массивін келесі түрде жіберуге болады:
recipients[]=380971112233&recipients[]=79101112233&recipients[]=77071112233
немесе осылай:
recipients=380971112233,79101112233,77071112233
Екі жазу формасы бірдей.
SMS мәтіні келесідей деп есептейік: Сәлеметсіз бе, {name}! {date} күнгі сіздің балансыңыз {balance}{currency}.
Бұл жағдайда recipients
параметрінде келесі деректер болуы керек:
recipients[0][recipient]=380971112233
&recipients[0][name]=%D0%92%D0%B0%D1%81%D0%B8%D0%BB%D0%B8%D0%B9
&recipients[0][date]=26.10.17
&recipients[0][balance]=123.45
&recipients[0][currency]=%D0%B3%D1%80%D0%BD
&recipients[1][recipient]=380971112255
&recipients[1][name]=%D0%9E%D0%BB%D1%8C%D0%B3%D0%B0
&recipients[1][date]=26.10.17
&recipients[1][balance]=3222.99
&recipients[1][currency]=%D1%80%D1%83%D0%B1
&recipients[2][recipient]=4901122211112
&recipients[2][name]=Markus
&recipients[2][date]=26.10.17
&recipients[2][balance]=555.45
&recipients[2][currency]=eur
HTTP сұрауының серверге жіберілетін барлық деректері алдын ала URL кодталу керек (әрбір бағдарламалау тілінде бұл үшін сәйкес функция бар).
https://api.mobizon.kz/service/Campaign/Create
Бұл әдіс жаңа SMS-науқанын құруға мүмкіндік береді. Науқан құрылғаннан кейін оған алушыларды қосу және содан кейін жіберу қажет.
data array
– Науқан параметрлері
Параметр | Түрі | Сипаттамасы |
---|---|---|
data[name] | string | Науқан атауы. Осы өрістің арқасында құрылған науқандарды бағыттау ыңғайлы болады. Мысалы: «Қара жұмадағы жеңілдіктер» немесе «Шоттағы теріс баланс туралы ескерту». Науқан атауының максималды ұзындығы – 255 символ. |
data[text] | string | Жіберуге арналған SMS хабарлама мәтіні. Үлгі тарату (data[type]=3) үшін бұл мәтін әрбір алушыға бірегей мәндерге ауыстырылатын айнымалыларды қамтуы керек. Айнымалы латын әріптерімен, сандармен және «_» ,«-» таңбаларымен жазылуы керек және фигуралы жақшалармен қоршалуы керек, мысалы: {name} немесе {clientBalance} .SMS мәтініне қойылатын талаптар. Хабарлама мәтінінде қысқа сілтемелерді және алушыларды қадағалау функциясын пайдалана аласыз, кімнің сіздің сілтемеңізді басқанын білу үшін. |
data[type] | integer | Науқан түрі: 1 – Жалғыз хабарлама (бір нөмірге жіберу); 2 – Жаппай тарату (әдепкі бойынша орнатылған); 3 – Үлгі науқан (хабарлама мәтінінде әрбір алушы үшін бірегей мәтінге ауыстырылатын тіркелген орындар болуы мүмкін). |
data[from] | string | Жіберушінің қолтаңбасы. Өз қолтаңбаңызды пайдалану үшін оны алдын ала тіркеу қажет. Егер қолтаңба көрсетілмесе, әдепкі бойынша орнатылған немесе қызметтің стандартты қолтаңбасы пайдаланылады. |
data[rateLimit] | integer | Белгілі бір уақыт кезеңінде жіберілген хабарламалар санын шектеу, ratePeriod өрісінде көрсетілген.Бұл опция үлкен SMS-тарату жылдамдығын баяулатуға мүмкіндік береді, осылайша сіздің Қолдау орталығыңызға жүктемені тарату. Жіберу жылдамдығын шектеу – секундқа есептелгенде 100 хабарламадан артық емес. Хабарламалар бірдей аралықтармен 10 дана пакеттермен жіберіледі, көрсетілген rateLimit -ке ratePeriod бойынша. Мысалы, егер жылдамдықты 600 және кезеңді 60 деп көрсетсеңіз, әр секунд сайын 600/60=10 SMS жіберіледі. |
data[ratePeriod] | integer | SMS жіберілетін уақыт кезеңі, rateLimit өрісінде көрсетілген.Ол тең болуы мүмкін: 60 – 1 минут; 3600 – 1 сағат; 86400 – 1 тәулік. |
data[deferredToTs] | string | Науқанды кейінге қалдыру күні мен уақыты. Жіберуді бастау кем дегенде бір сағаттан кейін және ең көп дегенде 14 күннен кейін болуы мүмкін. Формат: ЖЖЖЖ-АА-КК СС:ММ:СС . |
data[mclass] | integer | Жіберілген хабарламаның класы: 0 – хабарламалар қалқымалы терезеде көрсетіледі және еш жерде сақталмайды (flashSMS); 1 – хабарламалар телефонның Кіріс хабарламалар қалтасына сақталады (әдепкі бойынша орнатылған). |
data[validity] | integer | Хабарламаның жеткізілуін күту уақытының максималды уақыты, егер алушы оны дереу қабылдай алмаса. Мысалы, егер телефон өшірулі немесе желі аясынан тыс болса. Жіберу сәтінен бастап минутпен көрсетіледі: 60 (1 сағат) және 1440 (24 сағат) арасында. |
data[trackShortLinkRecipients] | integer | Алушыларды қадағалау функциясы. Бұл функцияны пайдалану тек қысқа сілтемелер болған кезде ғана қолжетімді, біздің қызметімізде жасалған. 0 – функцияны пайдаланбау (әдепкі бойынша орнатылған); 1 – функцияны пайдалану. |
integer
– науқанның идентификаторы, егер ол сәтті құрылған болса.
Код | Сипаттама |
---|---|
0 | Науқан сәтті құрылды. |
1 | Егер кез келген параметрлерде қате мәндер болса. |
curl -X POST \
'https://api.mobizon.kz/service/campaign/create?output=json&api=v1&apiKey=KKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKK' \
-H 'cache-control: no-cache' \
-H 'content-type: application/x-www-form-urlencoded' \
-d 'data%5Btype%5D=3&data%5Bfrom%5D=Alpha&data%5Btext%5D=%D0%A1%D3%99%D0%BB%D0%B5%D0%BC%D0%B5%D1%82%D1%81%D1%96%D0%B7+%D0%B1%D0%B5%2C+%7Bname%7D%21+%7Bdate%7D+%D0%BA%D2%AF%D0%BD%D0%B3%D1%96+%D0%B1%D0%B0%D0%BB%D0%B0%D0%BD%D1%81+%7Bbalance%7D%7Bcurrency%7D+%D2%9B%D2%B1%D1%80%D0%B0%D0%B9%D0%B4%D1%8B.'
var data = "data%5Btype%5D=3&data%5Bfrom%5D=Alpha&data%5Btext%5D=%D0%A1%D3%99%D0%BB%D0%B5%D0%BC%D0%B5%D1%82%D1%81%D1%96%D0%B7+%D0%B1%D0%B5%2C+%7Bname%7D%21+%7Bdate%7D+%D0%BA%D2%AF%D0%BD%D0%B3%D1%96+%D0%B1%D0%B0%D0%BB%D0%B0%D0%BD%D1%81+%7Bbalance%7D%7Bcurrency%7D+%D2%9B%D2%B1%D1%80%D0%B0%D0%B9%D0%B4%D1%8B.";
var xhr = new XMLHttpRequest();
xhr.withCredentials = true;
xhr.addEventListener("readystatechange", function () {
if (this.readyState === 4) {
console.log(this.responseText);
}
});
xhr.open("POST", "https://api.mobizon.kz/service/campaign/create?output=json&api=v1&apiKey=KKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKK");
xhr.setRequestHeader("content-type", "application/x-www-form-urlencoded");
xhr.setRequestHeader("cache-control", "no-cache");
xhr.send(data);
<?php
use Mobizon\MobizonApi;
$api = new MobizonApi('KKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKK', 'api.mobizon.kz');
// АПИ әдісін шақыру
if ($api->call(
'campaign',
'create',
array(
//кампанияның параметрлері
'data' => array(
//кампанияның түрі
'type' => '3',
//жіберушінің қолтаңбасы
'from' => 'Alpha',
//хабарламаның мәтіні
'text' => 'Сәлеметсіз бе, {name}! {date} күнгі баланс {balance}{currency} құрайды.'
)
)
)
) {
// Әдістің орындалу нәтижесін алу
$result = $api->getData();
} else {
// Орындалу кезінде қате болды, қате коды мен хабарлама мәтінін шығару
echo '[' . $api->getCode() . '] ' . $api->getMessage() . PHP_EOL;
}
https://api.mobizon.kz/service/Campaign/Delete
Бұл әдіс науқанды оның ID бойынша жоюға мүмкіндік береді.
Науқан оның жіберілуі әлі басталмаған болса жойылуы мүмкін.
Егер науқан кейінге қалдырылса: кейінге қалдырылған науқанды жіберу басталуына кем дегенде 5 минут қалғанда жоюға болады.
Параметр | Түрі | Сипаттамасы |
---|---|---|
id | integer | Науқанның идентификаторы. |
Код | Сипаттама |
---|---|
0 | Науқан сәтті жойылды. |
2 | Егер көрсетілген идентификатормен науқан табылмаса. |
10 | Егер көрсетілген идентификатормен науқан жойылмайтын болса. |
curl -X POST \
'https://api.mobizon.kz/service/campaign/delete?output=json&api=v1&apiKey=KKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKK' \
-H 'cache-control: no-cache' \
-H 'content-type: application/x-www-form-urlencoded' \
-d 'id=123'
var data = "id=123";
var xhr = new XMLHttpRequest();
xhr.withCredentials = true;
xhr.addEventListener("readystatechange", function () {
if (this.readyState === 4) {
console.log(this.responseText);
}
});
xhr.open("POST", "https://api.mobizon.kz/service/campaign/delete?output=json&api=v1&apiKey=KKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKK");
xhr.setRequestHeader("content-type", "application/x-www-form-urlencoded");
xhr.setRequestHeader("cache-control", "no-cache");
xhr.send(data);
<?php
use Mobizon\MobizonApi;
$api = new MobizonApi('KKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKK', 'api.mobizon.kz');
// АПИ әдісін шақыру
if ($api->call(
'campaign',
'delete',
array(
//кампания идентификаторы
'id' => '123'
)
)
) {
// Әдістің орындалу нәтижесін алу
$result = $api->getData();
} else {
// Орындалу кезінде қате болды, қате коды мен хабарлама мәтінін шығару
echo '[' . $api->getCode() . '] ' . $api->getMessage() . PHP_EOL;
}
https://api.mobizon.kz/service/Campaign/Get
Бұл әдіс құрылған науқанның негізгі деректерін оның ID бойынша алуға мүмкіндік береді.
Параметр | Түрі | Сипаттамасы |
---|---|---|
id | integer | Науқанның идентификаторы. |
Массив деректері келесі өрістерді қамтиды:
Өріс | Түрі | Сипаттамасы |
---|---|---|
id | string | Науқанның идентификаторы. |
moderationStatus | string | Қазіргі модерация мәртебесі: MODERATION – науқан модерацияда; DECLINED – науқан модератордан бас тартылды; READY_FOR_SEND – науқан модератордан жіберуге рұқсат етілді; AUTO_READY_FOR_SEND – науқан модерациясыз жіберілді. |
commonStatus | string | Науқанның қазіргі күйі: MODERATION – науқан модерациядан өтуде; DECLINED – науқан модератордан бас тартылды (бас тарту себебі globalComment өрісінде көрсетілген); READY_FOR_SEND – науқан жіберуге дайын, бірақ жіберу әлі басталмаған; RUNNING – науқан жіберу процесінде; SENT – науқан толығымен жіберілді, бірақ барлық хабарламалар байланыс операторынан жеткізу туралы есеп ала алмады; DONE – науқан толығымен аяқталды: барлық соңғы жеткізу есептері алынды, санауыштар түпкілікті мәндерді қамтиды. |
groupsList | array | Науқанға енгізілген контакт топтарының тізімі. Әрбір топ үшін келесілерді қамтиды: id – топ нөмірі; name – топ атауы; cardsCnt – хабарлама жіберуге қолжетімді топтағы контакт саны. Егер топтар науқанда пайдаланылмаса, бұл өріс бос болады. |
type | integer | Науқан түрі: 1 – Жалғыз хабарлама (бір нөмірге жіберу); 2 – Жаппай тарату; 3 – Үлгі науқан; 7 – Функционалды (қызметтік) науқан. |
msgType | string | Науқан хабарламаларының түрі. Қазіргі уақытта тек «SMS» түрі қолжетімді. |
rateLimit | integer | Белгілі бір уақыт кезеңінде жіберілген хабарламалар санын шектеу, ratePeriod өрісінде көрсетілген. |
ratePeriod | integer | SMS жіберілетін уақыт кезеңі, rateLimit өрісінде көрсетілген. |
sendStatus | string | Науқан жіберу мәртебесі: SENT – науқан жіберілді; DONE – науқан аяқталды. |
isDeleted | integer | Науқанның жойылғанын көрсететін жалауша: 0 – науқан қолжетімді; 1 – науқан жойылды. |
deferredToTs | string | Науқанның кейінге қалдырылған жіберу күні мен уақыты. Формат: ЖЖЖЖ-АА-КК СС:ММ:СС . |
createTs | string | Науқанның құрылған күні мен уақыты. Формат: ЖЖЖЖ-АА-КК СС:ММ:СС . |
startSendTs | string | Науқанды нақты жіберудің басталу күні мен уақыты. Формат: ЖЖЖЖ-АА-КК СС:ММ:СС . |
endSendTs | string | Науқанның барлық хабарламаларын жіберудің аяқталу күні мен уақыты. Формат: ЖЖЖЖ-АА-КК СС:ММ:СС . |
name | string | Науқан атауы. |
from | string | Науқанды жіберу үшін таңдалған жіберушінің қолтаңбасы. |
text | string | Хабарламаның толық мәтіні немесе айнымалы орнатылған үлгі мәтін. |
validity | integer | Хабарламаның жеткізілуін күту уақытының максималды уақыты, егер алушы оны дереу қабылдай алмаса, жіберу сәтінен бастап минутпен. |
mclass | integer | Жіберілген хабарламаның класы: 0 – хабарламалар қалқымалы терезеде көрсетіледі және еш жерде сақталмайды (flashSMS); 1 – хабарламалар телефонның Кіріс хабарламалар қалтасына сақталады. |
trackShortLinkRecipients | integer | Алушыларды қадағалау функциясы пайдаланылған ба: 0 – функция пайдаланылмаған; 1 – функция пайдаланылған. |
groups | string | Науқанда пайдаланылатын контакт топтарының идентификаторлары, үтірмен бөлінген. |
globalComment | string | Егер науқаннан бас тартылған болса, модератордың түсініктемесі. |
curl -X POST \
'https://api.mobizon.kz/service/campaign/get?output=json&api=v1&apiKey=KKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKK' \
-H 'cache-control: no-cache' \
-H 'content-type: application/x-www-form-urlencoded' \
-d 'id=123'
var data = "id=123";
var xhr = new XMLHttpRequest();
xhr.withCredentials = true;
xhr.addEventListener("readystatechange", function () {
if (this.readyState === 4) {
console.log(this.responseText);
}
});
xhr.open("POST", "https://api.mobizon.kz/service/campaign/get?output=json&api=v1&apiKey=KKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKK");
xhr.setRequestHeader("content-type", "application/x-www-form-urlencoded");
xhr.setRequestHeader("cache-control", "no-cache");
xhr.send(data);
<?php
use Mobizon\MobizonApi;
$api = new MobizonApi('KKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKK', 'api.mobizon.kz');
// АПИ әдісін шақыру
if ($api->call(
'campaign',
'get',
array(
//кампания идентификаторы
'id' => '123'
)
)
) {
// Әдістің орындалу нәтижесін алу
$result = $api->getData();
} else {
// Орындалу кезінде қате болды, қате коды мен хабарлама мәтінін шығару
echo '[' . $api->getCode() . '] ' . $api->getMessage() . PHP_EOL;
}
https://api.mobizon.kz/service/Campaign/GetInfo
Бұл әдіс науқанның негізгі және статистикалық деректерін оның ID арқылы алуға мүмкіндік береді.
Статистика counters
өрісінде көрсетілетін әртүрлі есептегіштер арқылы қалыптастырылады.
МАҢЫЗДЫ!
Науқан құнының техникалық есептеу ерекшеліктеріне байланысты, науқанның мүмкін құны туралы деректер алушыларды қосу сәтінде көрсетіледі және уақыт өте келе өзгермейді.
Өзгерістер тек алушыларды қайта жүктеу немесе науқан деректерін өңдеу кезінде орын алуы мүмкін (деректерді өңдеу жағдайында барлық алушылар мен есептеулер қайта жүктеледі).
Параметр | Түрі | Сипаттамасы |
---|---|---|
id | integer | Науқан идентификаторы. |
getFilledTplCampaignText | integer | Қайтарылатын деректер форматы: 0 – науқан мәтіні плейсхолдерлермен; 1 – алушылардың нақты деректерімен толтырылған шаблондық науқан мәтінін қайтару (әдепкі бойынша). |
Өріс | Түрі | Сипаттамасы |
---|---|---|
id | integer | Науқан идентификаторы. |
moderationStatus | string | Модерацияның ағымдағы күйі: MODERATION – науқан модерацияда; DECLINED – науқан модератормен қабылданбаған; READY_FOR_SEND – науқан модератормен мақұлданған; AUTO_READY_FOR_SEND – науқан модерациясыз жіберілген. |
commonStatus | string | Науқанның ағымдағы күйі: MODERATION – науқан модерациядан өтуде; DECLINED – науқан модератормен қабылданбаған ( globalComment өрісінде қабылданбау себебі көрсетілген);READY_FOR_SEND – науқан жіберуге дайын, бірақ жіберу әлі басталған жоқ; RUNNING – науқан жіберу процесінде; SENT – науқан толық жіберілген, бірақ оператордан жеткізу туралы есептер әлі алынбаған; DONE – науқан толық өңделген, барлық соңғы жеткізу есептері алынған. |
groupsList | array | Науқанға енгізілген байланыс топтарының тізімі. Әрбір топ үшін келесі деректер бар: id – топтың нөмірі; name – топтың атауы; cardsCnt – топта хабарлама жіберу үшін қолжетімді контактілер саны. Егер науқанда топтар қолданылмаса, бұл өріс бос болады. |
type | integer | Науқанның түрі: 1 – Жалғыз хабарлама (бір нөмірге жіберу); 2 – Массалық тарату; 3 – Шаблондық науқан; 7 – Функционалдық (қызметтік) науқан. |
msgType | string | Науқан хабарламаларының түрі. Қазіргі уақытта тек «SMS» түрі қолдау көрсетіледі. |
rateLimit | integer | Белгілі бір уақыт кезеңінде жіберілетін хабарламалар санының шектеуі ratePeriod өрісінде көрсетілген уақыт кезеңінде. |
ratePeriod | integer | rateLimit өрісінде көрсетілген SMS саны жіберілетін уақыт кезеңі. |
sendStatus | string | Науқан жіберу күйі: SENT – науқан жіберілген; DONE – науқан аяқталған. |
isDeleted | integer | Науқанның жойылғанын көрсететін белгі: 0 – науқан қолжетімді; 1– науқан жойылған. |
deferredToTs | string | Науқанды кейінге қалдыру жіберу күні мен уақыты. Формат: ЖЖЖЖ-АА-КК СС:ММ:СС . |
createTs | string | Науқанды құру күні мен уақыты. Формат: ЖЖЖЖ-АА-КК СС:ММ:СС . |
startSendTs | string | Науқанды нақты жіберу басталған күні мен уақыты. Егер жіберу басталмаса, бұл өрісте NULL болады. Формат: ЖЖЖЖ-АА-КК СС:ММ:СС . |
endSendTs | string | Науқан хабарламаларын жіберуді аяқтау күні мен уақыты. Егер хабарламаларды жіберу аяқталмаса – бұл өрісте NULL болады. Формат: ЖЖЖЖ-АА-КК СС:ММ:СС . |
name | string | Науқан атауы. |
from | string | Науқанды жіберу үшін таңдалған жіберушінің қолтаңбасы. |
text | string | Хабарламаның толық мәтіні немесе плейсхолдерлері бар шаблондық мәтін. |
validity | integer | Егер алушы оны бірден қабылдай алмаса, хабарламаны жеткізуді күту үшін ең ұзақ уақыт, жіберу сәтінен бастап минутпен. |
mclass | integer | Жіберілген хабарламаның класы: 0 – хабарламалар қалқымалы терезеде көрсетіледі және еш жерде сақталмайды (flashSMS); 1 – хабарламалар телефонның Кіріс хабарламалар қалтасына сақталады. |
trackShortLinkRecipients | integer | Алушыларды бақылау функциясы пайдаланылды ма: 0 – функция пайдаланылмады; 1 – функция пайдаланылды. |
groups | string | Науқанда пайдаланылған байланыс топтарының идентификаторлары, үтірлермен бөлінген. |
globalComment | string | Егер науқан қабылданбаған болса, модератордың түсініктемесі. |
creationWay | integer | Науқанды құру тәсілі: 1 – Интернет-браузер арқылы; 5 – функционалдық (қызметтік) науқан. |
counters | array | counters объектінің өрістерінде сипатталған науқанның әртүрлі есептегіштері осы жерден қараңыз. |
counters
объектінің өрістеріӨріс | Түрі | Сипаттамасы |
---|---|---|
updateTs | datetime | Есептегіштер соңғы жаңартылған уақыт. Жүйеге жүктемені азайту үшін есептегіштерді жаңарту кешігуі мүмкін. Формат: ЖЖЖЖ-АА-КК СС:ММ:СС . |
totalNewSegNum | integer | NEW күйіндегі сегменттердің жалпы саны. |
totalAcceptdSegNum | integer | ACCEPTD күйіндегі сегменттердің жалпы саны. |
totalDelivrdSegNum | integer | DELIVRD күйіндегі сегменттердің жалпы саны. |
totalRejectdSegNum | integer | REJECTD күйіндегі сегменттердің жалпы саны. |
totalExpiredSegNum | integer | EXPIRED күйіндегі сегменттердің жалпы саны. |
totalUndelivSegNum | integer | UNDELIV күйіндегі сегменттердің жалпы саны. |
totalDeletedSegNum | integer | DELETED күйіндегі сегменттердің жалпы саны. |
totalUnknownSegNum | integer | UNKNOWN күйіндегі сегменттердің жалпы саны. |
totalPdlivrdSegNum | integer | PDLIVRD күйіндегі сегменттердің жалпы саны. |
totalSegNum | integer | Науқандағы сегменттердің жалпы саны. Алушыларды қосу кезінде жаңартылады. |
totalNewMsgNum | integer | NEW күйіндегі хабарламалардың жалпы саны. |
totalAcceptdMsgNum | integer | ACCEPTD күйіндегі хабарламалардың жалпы саны. |
totalDelivrdMsgNum | integer | DELIVRD күйіндегі хабарламалардың жалпы саны. |
totalRejectdMsgNum | integer | REJECTD күйіндегі хабарламалардың жалпы саны. |
totalExpiredMsgNum | integer | EXPIRED күйіндегі хабарламалардың жалпы саны. |
totalUndelivMsgNum | integer | UNDELIV күйіндегі хабарламалардың жалпы саны. |
totalDeletedMsgNum | integer | DELETED күйіндегі хабарламалардың жалпы саны. |
totalUnknownMsgNum | integer | UNKNOWN күйіндегі хабарламалардың жалпы саны. |
totalPdlivrdMsgNum | integer | PDLIVRD күйіндегі хабарламалардың жалпы саны. |
totalMsgNum | integer | Хабарламалардың жалпы саны (сегменттер емес). Науқан хабарламалары/сегменттері өңделген кезде жаңартылады (жіберу алдында). |
totalNewMsgCost | float | NEW күйіндегі барлық сегменттердің жалпы құны. |
totalAcceptdMsgCost | float | ACCEPTD күйіндегі барлық сегменттердің жалпы құны. |
totalDelivrdMsgCost | float | DELIVRD күйіндегі барлық сегменттердің жалпы құны. |
totalRejectdMsgCost | float | REJECTD күйіндегі барлық сегменттердің жалпы құны. |
totalExpiredMsgCost | float | EXPIRED күйіндегі барлық сегменттердің жалпы құны. |
totalUndelivMsgCost | float | UNDELIV күйіндегі барлық сегменттердің жалпы құны. |
totalDeletedMsgCost | float | DELETED күйіндегі барлық сегменттердің жалпы құны. |
totalUnknownMsgCost | float | UNKNOWN күйіндегі барлық сегменттердің жалпы құны. |
totalPdlivrdMsgCost | float | PDLIVRD күйіндегі барлық сегменттердің жалпы құны. |
totalCost | float | Науқанның жалпы құны. |
recipientsRejected | integer | Науқанға қосылмаған қабылданбаған алушылар саны. Алушыларды қосу кезінде жаңартылады. |
curl -X POST \
'https://api.mobizon.kz/service/campaign/getInfo?output=json&api=v1&apiKey=KKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKK' \
-H 'cache-control: no-cache' \
-H 'content-type: application/x-www-form-urlencoded' \
-d 'id=123'
var data = "id=123";
var xhr = new XMLHttpRequest();
xhr.withCredentials = true;
xhr.addEventListener("readystatechange", function () {
if (this.readyState === 4) {
console.log(this.responseText);
}
});
xhr.open("POST", "https://api.mobizon.kz/service/campaign/getInfo?output=json&api=v1&apiKey=KKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKK");
xhr.setRequestHeader("content-type", "application/x-www-form-urlencoded");
xhr.setRequestHeader("cache-control", "no-cache");
xhr.send(data);
<?php
use Mobizon\MobizonApi;
$api = new MobizonApi('KKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKK', 'api.mobizon.kz');
// АПИ әдісін шақыру
if ($api->call(
'campaign',
'getInfo',
array(
//кампания идентификаторы
'id' => '123'
)
)
) {
// Әдістің орындалу нәтижесін алу
$result = $api->getData();
} else {
// Орындалу кезінде қате болды, қате коды мен хабарлама мәтінін шығару
echo '[' . $api->getCode() . '] ' . $api->getMessage() . PHP_EOL;
}
https://api.mobizon.kz/service/Campaign/List
Бұл әдіс құрылған науқандар тізімін алуға мүмкіндік береді. Іздеу ID және басқа өрістер бойынша жүргізілуі мүмкін.
Параметр | Түрі | Сипаттамасы |
---|---|---|
criteria | array | Іздеу критерийлері (қараңыз Іздеу критерийлері кестесін). |
pagination | array | Беттерді шығару параметрлері (қараңыз Беттерді шығару параметрлері кестесін). |
sort | array | Сұрыптау параметрлері (қараңыз Сұрыптау параметрлері кестесін). |
Төменде науқандар бойынша іздеу жүргізілетін өрістер келтірілген. Іздеуді бір немесе бірнеше өрістер бойынша бір уақытта жүргізуге болады.
Параметр | Түрі | Сипаттамасы |
---|---|---|
criteria[id] | integer | Бір науқанды оның ID бойынша іздеу. |
criteria[ids] | array | Бірнеше науқанды олардың ID бойынша іздеу. Параметр массив немесе үтірмен бөлінген идентификаторлар жолы түрінде берілуі керек. Максималды идентификаторлар саны – 100, бұл шектен асқан жағдайда іздеу тізімдегі алғашқы 100 ID бойынша жүргізіледі. |
criteria[recipient] | string | Алушының телефон нөмірі немесе оның бөлігі бойынша іздеу. Мысалы: 77273573423 – осы нөмір қатысқан барлық науқандарды табады; 38097 – көрсетілген сандар комбинациясын қамтитын барлық науқандар табылатын болады. Іздеуге тек бір нөмір қатыса алады. |
criteria[from] | string | Науқанда пайдаланылған жіберушінің қолтаңбасы бойынша іздеу. |
criteria[text] | string | Науқан хабарламасы мәтіні бойынша іздеу. Іздеу ізделетін мәннің толық сәйкестігі бойынша жүргізіледі. |
criteria[status] | string | Науқан күйі бойынша іздеу. |
criteria[createTsFrom] | string | Белгіленген күн мен уақыттан бастап құрылған науқандарды іздеу. Формат: ЖЖЖЖ-АА-КК СС:ММ:СС . |
criteria[createTsTo] | string | Көрсетілген күні мен уақытына дейін жасалған науқанды іздеу. Формат: ЖЖЖЖ-АА-КК СС:ММ:СС . |
criteria[sentTsFrom] | string | Жіберу көрсетілген күні мен уақытынан бастап болған науқанды іздеу. Формат: ЖЖЖЖ-АА-КК СС:ММ:СС . |
criteria[sentTsTo] | string | Жіберілген күні мен уақытына дейінгі науқандарды іздеу. Формат: ЖЖЖЖ-АА-КК СС:ММ:СС . |
criteria[type] | integer | Науқан түрі бойынша іздеу: 1 – Жалғыз хабарлама (бір нөмірге жіберу); 2 – Массалық тарату (әдепкі бойынша орнатылған); 3 – Шаблондық науқан (хабарлама мәтіні әрбір алушыға арналған бірегей мәтінмен ауыстырылатын плейсхолдерлерді қамтуы мүмкін). |
criteria[groups] | string | Науқанда қолданылатын байланыс топтарының идентификаторлары бойынша іздеу. Параметр массив немесе үтірмен бөлінген идентификаторлар жолы түрінде берілуі керек. |
Бұл параметрлер сұралатын ақпаратты құрылымдық (ішінара) шығару үшін арналған.
Параметр | Түрі | Сипаттамасы |
---|---|---|
pagination[pageSize] | integer | Беттегі көрсетілетін элементтер саны (25, 50, 100). |
pagination[currentPage] | integer | Ағымдағы бет. Беттердің нөмірленуі 0-ден басталады. |
Бұл параметрлерді пайдалана отырып, іздеу нәтижелерін өрістердің біреуі бойынша өсу (ASC) немесе кему (DESC) тәртібімен сұрыптауға болады.
Мысалы:
Науқан құру күні бойынша өсу ретімен сұрыптау – sort[createTs]=ASC
.
Науқанның ID бойынша кему ретімен сұрыптау – sort[id]=DESC
.
Параметр | Сипаттамасы |
---|---|
sort[id] | Науқанның ID бойынша сұрыптау. |
sort[name] | Науқан атауы бойынша сұрыптау. |
sort[from] | Жіберушінің қолтаңбасы бойынша сұрыптау. |
sort[counters.totalMsgNum] | Науқанның телефон нөмірлерінің саны бойынша сұрыптау. |
sort[counters.totalCost] | Науқанның құны бойынша сұрыптау. |
sort[createTs] | Науқан құру күні мен уақыты бойынша сұрыптау. |
sort[startSendTs] | Науқан жіберу басталған күні мен уақыты бойынша сұрыптау. |
sort[endSendTs] | Науқан жіберу аяқталған күні мен уақыты бойынша сұрыптау. |
Екі өрістен тұратын массивті қамтиды:
Өріс | Түрі | Сипаттамасы |
---|---|---|
items | array | Табылған науқан тізімі. Науқан өрістерінің сипаттамасын campaign/getInfo әдісінің сипаттамасынан қараңыз. |
totalItemCount | integer | Табылған элементтердің жалпы саны. |
Статус | Сипаттамасы |
---|---|
NEW | Науқан жасалған, бірақ пайдаланушы әлі жібермеген. Бұл күйде алушыларды қосуға рұқсат етіледі. |
MODERATION | Қызмет көрсету ережелеріне сәйкестігіне модерациядан өтуде. |
DECLINED | Модератормен қабылданбаған, себебі ол қызмет көрсету ережелеріне немесе науқандағы нөмірлердің операторларының талаптарына сәйкес келмейді. |
READY_FOR_SEND | Науқан жіберуге дайын, бірақ жіберу әлі басталмаған. |
AUTO_READY_FOR_SEND | Науқан модерациялаусыз жіберіледі. Науқан модерациясыз жіберіледі. |
NOT_YET_SENT | Науқан жіберілмеген барлық статустарды қамтиды. Бұл мән тек іздеу үшін қолданылады. Науқандарда бұл статус болмауы мүмкін. |
RUNNING | Науқан басталған, операторға жіберу процесі жүруде. |
DEFERRED | Науқанды жіберу белгілі бір уақытқа жоспарланған. Бұл мән тек іздеу үшін қолданылады. Науқандарда бұл статус болмауы мүмкін. |
SENT | Науқан толық жіберілген, бірақ операторлардан жеткізу туралы есептер әлі алынбаған. |
DONE | Науқан толық өңделген, барлық соңғы жеткізу есептері алынған. Бұл статус орнатылғаннан кейін науқанның ешбір есептегіштері өзгермейді. |
curl -X POST \
'https://api.mobizon.kz/service/campaign/list?output=json&api=v1&apiKey=KKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKK' \
-H 'cache-control: no-cache' \
-H 'content-type: application/x-www-form-urlencoded' \
-d 'criteria%5Bfrom%5D=Alpha&pagination%5BcurrentPage%5D=2&pagination%5BpageSize%5D=50&sort%5Btype%5D=ASC'
var data = "criteria%5Bfrom%5D=Alpha&pagination%5BcurrentPage%5D=2&pagination%5BpageSize%5D=50&sort%5Btype%5D=ASC";
var xhr = new XMLHttpRequest();
xhr.withCredentials = true;
xhr.addEventListener("readystatechange", function () {
if (this.readyState === 4) {
console.log(this.responseText);
}
});
xhr.open("POST", "https://api.mobizon.kz/service/campaign/list?output=json&api=v1&apiKey=KKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKK");
xhr.setRequestHeader("content-type", "application/x-www-form-urlencoded");
xhr.setRequestHeader("cache-control", "no-cache");
xhr.send(data);
<?php
use Mobizon\MobizonApi;
$api = new MobizonApi('KKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKK', 'api.mobizon.kz');
// АПИ әдісін шақыру
if ($api->call(
'campaign',
'list',
array(
//іздеу критерийлері
'criteria' => array(
//жіберушінің қолтаңбасы
'from' => 'Alpha'
),
//беттер бойынша параметрлер
'pagination' => array(
//ағымдағы бет
'currentPage' => '2',
//беттегі элементтер саны
'pageSize' => '50'
),
//сұрыптау параметрлері
'sort' => array(
//кампания түрі бойынша сұрыптау
'type' => 'ASC'
)
)
)
) {
// Әдістің орындалу нәтижесін алу
$result = $api->getData();
} else {
// Орындалу кезінде қате болды, қате коды мен хабарлама мәтінін шығару
echo '[' . $api->getCode() . '] ' . $api->getMessage() . PHP_EOL;
}
https://api.mobizon.kz/service/Campaign/Send
Бұл әдіс кампанияны ID бойынша жіберуге мүмкіндік береді.
Назар аударыңыз! Спамға күдік туындаған жағдайлар, хабарлама мәтінінде күдікті мазмұнның болуы, белгілі бір бағытқа шектеу және т.б., сондай-ақ келісім-шарт бойынша жағдайлар байланысты, кампания модерацияға түсуі мүмкін.
Параметр | Түрі | Сипаттамасы |
---|---|---|
id | integer | Кампанияның идентификаторы. |
integer
: кампанияның жіберілу статусы.
1 – кампания модератор тексерісінде;
2 – кампания жіберілді.
Код | Сипаттамасы |
---|---|
0 | Кампания сәтті жіберілді. |
2 | Кампания табылмады. |
10 | Кампанияның статусын өзгерту мүмкін болмады. |
curl -X POST \
'https://api.mobizon.kz/service/campaign/send?output=json&api=v1&apiKey=KKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKK' \
-H 'cache-control: no-cache' \
-H 'content-type: application/x-www-form-urlencoded' \
-d 'id=123'
var data = "id=123";
var xhr = new XMLHttpRequest();
xhr.withCredentials = true;
xhr.addEventListener("readystatechange", function () {
if (this.readyState === 4) {
console.log(this.responseText);
}
});
xhr.open("POST", "https://api.mobizon.kz/service/campaign/send?output=json&api=v1&apiKey=KKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKK");
xhr.setRequestHeader("content-type", "application/x-www-form-urlencoded");
xhr.setRequestHeader("cache-control", "no-cache");
xhr.send(data);
<?php
use Mobizon\MobizonApi;
$api = new MobizonApi('KKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKK', 'api.mobizon.kz');
// АПИ әдісін шақыру
if ($api->call(
'campaign',
'send',
array(
//кампания идентификаторы
'id' => '123'
)
)
) {
// Әдістің орындалу нәтижесін алу
$result = $api->getData();
} else {
// Орындалу кезінде қате болды, қате коды мен хабарлама мәтінін шығару
echo '[' . $api->getCode() . '] ' . $api->getMessage() . PHP_EOL;
}