Тарифи	Послуги	API	Партнерам	Про сервіс	Контакти

^{Безкоштовно по Україні}

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

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

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

ПІДКЛЮЧЕННЯ

ШВИДКІСТЬ РОЗСИЛОК

МНОЖИННІ ПІДКЛЮЧЕННЯ

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

ПЕРЕВІРКА СТАТУСУ

ОТРИМАННЯ ВХІДНИХ ПОВІДОМЛЕНЬ

КОДИ ПОМИЛОК У СТАТУСІ

Перевірка статусу

Отримувати статус доставки відправленого SMS-повідомлення по SMPP-протоколу можна як в автоматичному режимі, отримуючи від сервера відповідну PDU-команду DELIVER_SM відразу після зміни статусу, так і за запитом окремою командою QUERY_SM. Для автоматичного отримання статусу по SMPP-протоколу необхідно підключатися в режимі transceiver або receiver і при відправці SMS вказувати прапор запиту статусу (registered_delivery). Якщо при відправці не вказувати цей прапор, то статуси повідомлень будуть передаватися на HTTP-обробник.

При автоматичному поверненні статусу в команді DELIVER_SM передаються стандартні TLV-параметри receipted_message_id (<id>), message_state (числовий <status>) та network_error_code (<err>), а також додаткові TLV-поля, описані нижче:

Ім'я (код) поля	Розмір	Тип	Опис
8192 (0x2000)	Var. max 6	COctet String	Вартість повідомлення у форматі "n.nnnn".
8193 (0x2001)	2	Integer	Прапор у вигляді 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 - рекламний.
8194 (0x2002)	2	Integer	Кількість частин в повідомленні.
8195 (0x2003)	Var. max 5	COctet String	mccmnc код країни / оператора абонента.
8196 (0x2004)	2	Integer	Додатковий статус повідомлення (2-прочитано, 4-натиснуто посилання).

Також в команді DELIVER_SM передається текст статусу в наступному форматі:


id:<id> sub:<sub> dlvrd:<dlvrd> submit date:<submit date> done date:<done date> stat:<status> err:<err>

Опис параметрів:

Параметр	Значення
id	Ідентифікатор повідомлення, призначений сервером при відправці.
sub	Кількість SMS частин у відправленому повідомленні.
dlvrd	Кількість доставлених SMS.
submit date	Дата відправки.
done date	Дата зміни статусу.
status	Статус повідомлення у вигляді рядка (DELIVRD, EXPIRED, UNDELIV).
err	Код помилки, якщо повідомлення не може бути доставлене (список).

Приклад результату рядка статусу (Delivery Report):


id:854019 sub:001 dlvrd:001 submit date:1108202241 done date:1108202241 stat:DELIVRD err:000

За замовчуванням для довгих повідомлень, що розбиваються на кілька SMS, сервер повертає тільки один статус (DELIVER_SM) для всього склеєного повідомлення і однакові ID у відповіді SUBMIT_SM_RESP для всіх SMS-частин даного повідомлення. Для включення режиму обробки і повернення статусів для кожної SMS-частини окремо встановіть наступний параметр в налаштуваннях підключення (або в налаштуваннях особистого кабінету):


system-type = "SINGLE"

Якщо необхідно вказати кілька параметрів у поле system-type, то вкажіть їх через кому:


system-type = "ISO,SINGLE"

Увійти через:


Запам'ятати для автовходу



Реєстрація	Забули пароль?


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