Тарифи  Послуги  API  Партнерам  Про сервіс  Контакти 
0 (800) 30 7672
Безкоштовно по Україні
 

Інтеграція з сервісом (API)

API дозволяє розсилати повідомлення через ваші проекти і сервіси по протоколах HTTP/HTTPS, SMTP і SMPP. Готові бібліотеки на різних мовах програмування підключаються до вашого проекту і допомагають відправляти повідомлення з будь-якого місця за допомогою однієї команди.


HTTP/HTTPS SMTP SMPP SOAP OMS SMS-команди Бібліотеки та приклади коду

ВІДПРАВКА ПОВІДОМЛЕНЬ

Відправка SMS-повідомлення

Коментарі в SMS-повідомленнях

Відправка на групу номерів

Відправка HLR-запиту

Надсилання MMS-повідомлення

Відправка e-mail повідомлення

Надсилання голосового повідомлення (дзвінок)

Відправка viber-повідомлення

Відправка telegram-повідомлення

Використання префіксів при відправці повідомлень

Керування шаблонами повідомлень

Керування шаблонами операторів

Віртуальна відправка (режим тестування)

Повідомлення про події

УПРАВЛІННЯ РОЗСИЛКАМИ

СТАТУСИ ПОВІДОМЛЕНЬ

ПЕРЕВІРКА СТАНУ БАЛАНСУ

УПРАВЛІННЯ КОНТАКТАМИ

УПРАВЛІННЯ КЛІЄНТАМИ

КЕРУВАННЯ ІМЕНАМИ ВІДПРАВНИКІВ (SENDER ID)

ОТРИМАННЯ ДАНИХ

РІЗНЕ

Передача статусів і повідомлень на обробник Клієнта

В особистому кабінеті Клієнта в "Налаштуваннях користувача" є можливість вказати http(s)-адресу (URL) скрипта для обробки статусів доставки повідомлень, вхідних SMS-повідомлень, а також службових повідомлень (при використанні послуги "Підтвердження номеру за допомогою дзвінка") на стороні Клієнта. Зазначений скрипт буде викликатися Сервером після кожного отримання статусу доставки раніше відправленого Клієнтом повідомлення, після отримання вхідного SMS-повідомлення від абонента або дзвінка від абонента (при використанні послуги "Підтвердження номеру за допомогою дзвінка").

В адресі обробника можна вказати параметр charset для вибору кодування переданих параметрів: ?charset=utf-8
?charset=koi8-r
?charset=windows-1251
За замовчуванням використовується кодування windows-1251.

Також в адресі обробника статусів і вхідних повідомлень можна передавати параметр fmt для вказівки формату параметрів, що повертаються. Можливі значення: fmt=2 (для формату xml) і fmt=3 (для формату json). При передачі параметра fmt кодування koi8-r не використовується.

Для захисту даних, що передаються від підміни в адресі обробника, додатково можна вказати будь-який із параметрів md5, sha1, crc32, що визначають алгоритм підрахунку контрольного параметра з хешем рядку:
"id:phone:status:<секретная строка>" − для статусу доставки
"phone:mes:to:<секретная строка>" − для вхідного повідомлення
"phone:ts:<секретная строка>" − для підтвердження номера за допомогою дзвінка
у вигляді:
?md5=<секретная строка>
?sha1=<секретная строка>
?crc32=<секретная строка>
В якості символів секретного рядка можна використовувати латинські літери, цифри, мінус і підкреслення. Оброблювачу буде передано відповідний параметр, в якому секретний рядок буде замінено на значення хешу переданих даних.

Всі параметри передаються методом POST (для fmt=p1 і fmt=3 параметри передаються в тілі запиту). У разі необхідності передачі параметрів, зазначених в URL обробника методом GET потрібно прописати їх спеціальним чином через символ "!"(наприклад, у URL-адресі " https://mysite.ru/!param1&param2?param3&param4 " параметри param1 і param2 будуть передані методом GET, а param3 і param4 методом POST).

Параметри, що передані для статусу SMS-повідомлення:

ПараметрЗначення
idІдентифікатор повідомлення.
phoneНомер телефону.
statusСтатус повідомлення.
timeЧас зміни статусу (або доставки SMS-повідомлення абоненту).
Формат: DD.MM.YY hh:mm:ss (за часовим поясом, вказаним у настройках).
tsЧас зміни статусу у вигляді штампу в секундах.
errКод помилки, якщо повідомлення не може бути доставлено (список). Передається, якщо не дорівнює нулю.
syserrДодаткова помилка від оператора, наявна не завжди.
cntКількість частин (при відправці SMS-повідомлення) або кількість секунд (при голосовому повідомленні (дзвінку)).
typeТип повідомлення (0 – SMS, 1 – Flash-SMS, 2 – Бінарне SMS, 3 – Wap-push, 4 – HLR-запит, 5 – Ping-SMS, 6 – MMS, 7 – Дзвінок, 10 – Viber, 12 – Соцмережі).
costВартість повідомлення.
flagПрапор у вигляді 2-х байтового числа, що містить різну інформацію про повідомлення. Можливі комбінації значень бітів різних характеристик.

Біти 0-3 (тип повідомлення):
0 (за замовчуванням) – SMS.
1 – Flash-SMS.
2 – Бінарне SMS.
3 – Wap-push.
4 – HLR-запит.
5 – Ping-SMS.
6 – MMS.
7 – Дзвінок.
8 – E-mail.
10 – Viber.
12 – Соцмережі.


Біт 5 – оплата повідомлення з другого балансу.
Біт 8 – ознака шаблонного повідомлення.

Біти 10,9 - тип шаблонного повідомлення:
00 - сервісне.
01 - транзакційне.
10 - авторизаційне.
11 - рекламний.
senderІм'я відправника, що відображається в телефоні одержувача.
dtmfПослідовність символів, що набирається абонентом на цифровій клавіатурі під час прослуховування голосового повідомлення (дзвінка).
cmtКоментарі клієнта, що передаються при відправці повідомлення. У разі виникнення overtime при голосовому повідомленні він буде переданий у коментарі окремим рядком у вигляді "overtime: mm:ss".
md5MD5-хеш строки "id:phone:status:<секретная строка>". Передається, якщо був указаний в якості додаткового параметра в http(s)-адресі обробника.
sha1sha1-хеш строки "id:phone:status:<секретная строка>". Передається, якщо був указаний в якості додаткового параметра в http(s)-адресі обробника.
crc32Контрольная сумма crc32 строки "id:phone:status:<секретная строка>". Передається, якщо був указаний в якості додаткового параметра в http(s)-адресі обробника.
Розширені можливості пошуку для HLR-запитів
imsiУнікальний код IMSI SIM-карти абонента.
mscНомер сервіс-центру оператора, в мережі якого знаходиться абонент.
mccЧисловий код країни абонента.
mncЧисловий код оператора абонента.
cnНазва країни реєстрації абонента.
netНазва оператора реєстрації абонента.
rcnНазва роумінгової країни абонента при знаходженні в чужій мережі.
rnetНазва роумінгового оператора абонента при знаходженні в чужій мережі.

Передані параметри для вхідного SMS-повідомлення:

ПараметрЗначення
idУнікальний ідентифікатор вхідного повідомлення, який призначається сервером автоматично.
sms_idІдентифікатор повідомлення, на яке отримана відповідь. Даний параметр відсутній, якщо повідомлення від абонента було відправлене на виділений вхідний номер або при вказівці абонентом префікса "логін, двокрапка і пробіл".
phoneНомер телефону абонента.
mesТекст SMS-повідомлення.
toВхідний номер телефону, на який було відправлено повідомлення абонентом.
smscSMS-центр оператора, від якого було отримано вхідне повідомлення.
sentЧас відправки повідомлення абонентом у вигляді штампа в секундах.
timeЧас отримання повідомлення Сервером у вигляді штампу в секундах.
md5MD5-хеш строки "phone:mes:to:<секретная строка>". Передається, якщо був указаний в якості додаткового параметра в http(s)-адресі обробника.
sha1sha1-хеш строки "phone:mes:to:<секретная строка>". Передається, якщо був указаний в якості додаткового параметра в http(s)-адресі обробника.
crc32Контрольная сумма crc32 строки "phone:mes:to:<секретная строка>". Передається, якщо був указаний в якості додаткового параметра в http(s)-адресі обробника.

Передані параметри при використанні послуги "Підтвердження номеру за допомогою дзвінка":

ПараметрЗначення
waitcall1 – ознака службового повідомлення для послуги "Підтвердження номеру за допомогою дзвінка".
phoneНомер телефону абонента, з якого надійшов дзвінок.
tsЧас дзвінка.
md5MD5-хеш строки "phone:ts:<секретная строка>". Передається, якщо був указаний в якості додаткового параметра в http(s)-адресі обробника.
sha1sha1-хеш строки "phone:ts:<секретная строка>". Передається, якщо був указаний в якості додаткового параметра в http(s)-адресі обробника.
crc32Контрольная сумма crc32 строки "phone:ts:<секретная строка>". Передається, якщо був указаний в якості додаткового параметра в http(s)-адресі обробника.

Розширені можливості пошуку, що передаються при використанні функції голосового меню в дзвінках:

ПараметрЗначення
calltime Час розмови, після закінчення якого була натиснута клавіша на цифровій клавіатурі телефону абонента або загальний час розмови.
callmenuПослідовність клавіш цифрової клавіатури телефону, натиснуті абонентом під час проходження по голосовому меню.
ringtimeЧас очікування підняття трубки абонентом.

Крім описаних вище стандартних параметрів Сервер також буде передавати методом POST всі параметри, зазначені в http(s)-адресі обробника після знаку "?".

Для розрізення статусу повідомлення, вхідного SMS-повідомлення або службового повідомлення (при використанні послуги "Підтвердження номера за допомогою дзвінка") в одному обробнику можна виконати перевірку на наявність параметра mes (для вхідного повідомлення) та waitcall (для послуги підтвердження номеру): if (isset($_POST["mes"])) {
   
// message
}
elseif (isset(
$_POST["waitcall"])) {
   
// confirmation
}
else {
   
// status
}

Пересилання статусів на обробник Клієнта здійснюється тільки при відправленні повідомлень по протоколах HTTP/HTTPS, SMTP або SMPP. При відправці повідомлень з особистого кабінету передача статусів на обробник Клієнта не відбувається.

У разі якщо від обробника Клієнта повернеться відповідь з кодом помилки, відмінним від 200 або 404, то Сервер з певною періодичністю буде повторювати запит на обробник (1 запит кожні 4 хвилини, всього 50 спроб).




© 2003–2024 ТОВ " СМСЦЕНТР»
Код ЄДРПОУ 38404962
support@smsc.ua
Контакти
Дизайн — Студія Артемія Лебедєва
Інформація про сайт
SMS-центр для Android Яндекс.Метрика