ГоловнаAPI SMS

Інтеграція API для відправки СМС

SMS Club пропонує приєднання до інтерфейсу (SMS-шлюз) для автоматичного розсилання СМС. Інтегрувати сервіс можна з будь-яким проектом.

Підключити зараз

1 Вересня 2022 р.

Тетяно, отримайте знижку -15% перед Новим роком на масаж усього тіла

Міжнародне відправлення SA12234 у відділенні 03100 у Києві, пр. Перемоги 60

-3000.00 UAH Zniattia hotivky, Kartka 5355***4487. Balans:1031.89 UAH

Ваш пароль для входу: 223ytubrg3#. Не передавайте особисті дані 3-м особам!

Напишіть повідомлення...

Про нас у цифрах

3 000 000 000 Надіслано повідомлень

32 000+ Клієнтів довіряють нам

до 10 секунд Доставка повідомлень

від 0,64 грн Ціна за повідомлення

15 років Компанія на ринку

Підключення до СМС-шлюзу сервісу нашої компанії — безкоштовне без активації послуги. Єдина умова: кодування даних для передачі в API має бути UTF-8.

Специфікація JSON: API

*рекомендовано

Для зв’язку з сервером браузеру потрібний метод POST. На потрібну адресу надсилаються запити за протоколом HTTP, для цього використовується стандартний формат тексту – JSON (JavaScript Object Notation).

Право доступу до ресурсів користувача здійснюється через протокол авторизації OAuth 2.0. Щоб автентифікувати запити, потрібний токен, для отримання якого зайдіть до Особистого кабінету в розділ Профіль. Виберіть token та вставте його у шапку запиту: ‘Authorization: Bearer your_token’.

Ліміт на кількість запитів (доступ до API) — до 9 шт/сек від кожного користувача.

Як відправляти персоналізовані SMS в SMS Club

Інтернет-адреса служби: https://im.smsclub.mobi/sms/send

Для надсилання SMS-повідомлень через API необхідно задати такі дані:

src_addr

Альфанумеричне ім'я відправника

телефон

Абонентські номери (не більше 100 шт. в одному запиті)

message

Вміст SMS

integration_id

*можна не заповнювати

*вказувати, якщо працюєте за реферальними програмами

Результативне відправлення повідомлень у партнерську систему підтверджується поверненням масиву, де «info» — це ключ, id повідомлення у системі СМС Клуб. Тому id надається статус, де телефонний номер абонента, якому надсилалося СМС — значення. Див. зразок: "107" — id sms, 380989371132 - номер клієнта.

Приклад надсилання повідомлення в форматі «JSON»:

                                {
         "phone" : ["380989361131"],
         "message" : "test text",
         "src_addr" : "VashZakaz"
}

Приклад відповіді у «JSON» форматі:

                                {
      "success_request": {
              "info": {
                    "106": "380989361131"
               }
       }
}

Інтеграція API для надсилання SMS

Тарифи

Як отримати статус СМС

Інтернет-адреса служби: https://im.smsclub.mobi/sms/status

id_sms — уникальный идентификатор СМС, передача которого вызывает получение статуса. Отсылать можно и массив ID уведомлений, не превышающий 100 идентификаторов. При результативном запросе, программа возвращает массив info, где id — ключ СМС,значение — статус.

Приклад:

                                {
         "id_sms" : ["107"],
}

Варіант відповіді:

                                {
      "success_request": {
              "info": {
                      "107": "ENROUTE"
               }
      }
}

Варіанти статусу

200 – Успіх! Запит виконано. Ймовірні статуси повідомлень:

ENROUTE

СМС надіслано

DELIVRD

СМС отримано

EXPIRED

Вичерпано час доставки

UNDELIV

СМС не вдається відправити

REJECTD

СМС відхилено

Помилки

400

Вихідні дані не пройшли валідацію

401

Користувач не розпізнаний системою

429

Перевищено ліміт запитів за одиницю часу

453

Подвоєні СМС менше ніж за 2 хвилини

500x

Збій програми. Спробуй пізніше

Отримання альфанумеричних імен абонентів

Інтернет-адреса техпідтримки: https://im.smsclub.mobi/sms/originator

Отримати активні альфа-імена можна, запросивши їх за вищевикладеним URL. Достатньо відправити наявні дані, що не включають текстовий зміст.

Якщо запит виконано, програма видасть перелік вільних альфа імен:

Зворотній зв'язок при успішному запиті

                    {
      "success_request": {
                  "info": [
                            "test1",
                            "test2"
                  ]
     }
}

Як отримати баланс користувача

Інтернет-адреса техпідтримки: https://im.smsclub.mobi/sms/balance

Надішліть запит на вказану URL-адресу. Текстове зміст авторизованих даних користувача вказувати зайве.

Якщо запит виконано, програма видасть масив “info”, в якому:

money — баланс

currency — валюта

Зворотній зв'язок при успішному запиті

                    {
           "success_request": {
                     "info": [
                               "money": "8121.1800",
                               "currency": "UAH"
                     ]
             }
}

SMPP-шлюз

ESME

SMSC

MSC

SMS, EMS, WAP, USSD, ets

Апаратний маршрутизатор відповідає протоколу SMPP v3.4. Щоб протестувати апаратний маршрутизатор,

HTTP-шлюз

Мережевий шлюз відсилає HTTP запити на призначений URL сервісу. Для надсилання використовується протокол HTTP та методи GET/POST. Щоб протестувати маршрутизатор, зверніться до наших фахівців.

XML-шлюз

Апаратний маршрутизатор призначений для надсилання запитів XML за призначеною адресою. Закодовані в UTF-8 запити йдуть за протоколом HTTP, використовуючи спосіб POST. Щоб перевірити мережевий шлюз, зв'яжіться з нашим фахівцем.

Завантаження зразків

Виберіть шлюз та завантажте зразки скриптів.

Метод	JSON
Поодинока
Масова
Баланс
Статус
Альфа-імена

Відгуки

Олег Ярощук

Відмінний і недорогий сервіс! Найадекватніші ціни на вайбер розсилки.

Володимир Куніцин

Працюємо з SMS CLUB уже другий рік. Усе чітко, швидко і без проблем. Менеджери завжди підкажуть, якщо виникають питання.

Вадим Дорош

Регулярно розсилаємо як рекламні, так і сервісні повідомлення. Шукати дешевший сервіс для вайбер розсилок навіть не бачимо сенсу. Ціни як і у всіх, але якість обслуговування на порядок вища. Є з чим порівняти.