Иди на текст

Пошаљи поруку

Шаљите поруке преко СМСБАТ АПИ-ја користећи крајњу тачку /бат/мессагелист.

Крајња тачка

ЦОДЕ_БЛОЦК_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 сата)

ИД поруке клијента

  • Користите јединствене идентификаторе за сваку поруку
  • Помаже у праћењу и отклањању грешака
  • Корисно за повезивање са записима вашег система

Ограничења стопе

Контактирајте свог менаџера налога за информације о:

  • Поруке у секунди
  • Поруке по дану
  • Истовремене везе

Следећи кораци