Пошаљи поруку
Шаљите поруке преко СМСБАТ АПИ-ја користећи крајњу тачку /бат/мессагелист.
Крајња тачка
ЦОДЕ_БЛОЦК_0
Структура захтева
Тело захтева је ЈСОН низ објеката поруке:
ЦОДЕ_БЛОЦК_1
Параметерс
Обавезни параметри
| Параметар | Тип | Опис |
|---|---|---|
од | стринг | Алфанумерички ИД пошиљаоца |
то | стринг | Број телефона примаоца у формату Е.164 (нпр. +380КСКСКСКСКСКСКСКСКС) |
тип | стринг | Тип поруке: смс, вибер_промо, вибер_транс, вибер_цароусел, вибер_сурвеи, вибер_отп, рцс, фласхцалл |
текст | стринг | Садржај поруке (обавезно за већину типова, опционо за неке) |
Опциони параметри
| Параметар | Тип | Опис |
|---|---|---|
цустомерМессагеИд | стринг | Ваш интерни идентификатор за праћење |
ттл | цео број | Време за живот у секундама |
мессагеДата | објекат | Конфигурација специфична за тип (зависи од типа поруке) |
Аутентификација
Изаберите један од три метода аутентификације:
=== “Заглавље АПИ кључа”
__ЦОДЕ_БЛОЦК_2__
=== “ХТТП Басиц Аутх”
__ЦОДЕ_БЛОЦК_3__
=== “АПИ кључ као лозинка”
__ЦОДЕ_БЛОЦК_4__
Одговор
Успешан одговор
ЦОДЕ_БЛОЦК_5
Поља одговора
| Поље | Тип | Опис |
|---|---|---|
мессагелистИд | цео број | Јединствени идентификатор за листу порука |
мессагеИд | стринг | Јединствени идентификатор за сваку поруку |
статус | стринг | Статус поруке: прихваћено, одбијено, неуспело |
делови | цео број | Број делова поруке (за СМС) |
цустомерМессагеИд | стринг | Ваш интерни идентификатор (ако је наведен) |
то | стринг | Број телефона примаоца |
Типови порука
СМС
Једноставне текстуалне поруке:
ЦОДЕ_БЛОЦК_6
Вибер Промо
Промотивне поруке са богатим медијима:
ЦОДЕ_БЛОЦК_7
Вибер Трансацтионал
Обавештења о трансакцијама:
ЦОДЕ_БЛОЦК_8
Вибер ОТП
Једнократна обавештења о лозинки:
ЦОДЕ_БЛОЦК_9
Обрада грешака
ХТТП статусни кодови
| Код | Опис |
|---|---|
| 200 | Захтев успешан |
| 400 | Лош захтев - неважећи параметри |
| 401 | Неовлашћено - аутентификација није успела |
| 429 | Превише захтева - ограничење брзине је премашено |
| 500 | Интерна грешка сервера |
Одговор на грешку
ЦОДЕ_БЛОЦК_10
Најбоље праксе
Формат телефонског броја
Увек користите формат Е.164 за бројеве телефона:
- ✅ Тачно:
+380КСКСКСКСКСКСКСКСКС - ❌ Нетачно:
380КСКСКСКСКСКСКСКСКС,0КСКСКСКСКСКСКСКСКС
Текст поруке
- Задржите СМС испод 160 карактера да бисте избегли више делова
- Користите УТФ-8 кодирање за међународне знакове
- Тестирајте специјалне знакове пре масовног слања
ТТЛ (време за живот)
- Подесите одговарајући ТТЛ за поруке осетљиве на време
- ОТП поруке: 300-600 секунди (5-10 минута)
- Промотивне поруке: 3600-86400 секунди (1-24 сата)
ИД поруке клијента
- Користите јединствене идентификаторе за сваку поруку
- Помаже у праћењу и отклањању грешака
- Корисно за повезивање са записима вашег система
Ограничења стопе
Контактирајте свог менаџера налога за информације о:
- Поруке у секунди
- Поруке по дану
- Истовремене везе
Следећи кораци
- Вибер поруке - Истражите типове Вибер порука
- СМС поруке - Сазнајте више о СМС-у
- Провери статус - Пратите испоруку поруке