Відправка повідомлень

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

Всі параметри, які містять спеціальні символи (плюс, пробіл і т. д.), повинні бути закодовані за допомогою функції urlencode для передачі в HTTP-запиті.

Відповідь сервера і коди помилок

• ERROR = N (описание) – для помилок 1,2,4,5,9;
  
  
• ERROR = N (опис), ID - <id сообщения> – для помилок 3,6,7,8.

• 0,-N - для помилок 1,2,4,5,9;
• <id сообщения>,-N – для помилок 3,6,7,8.

• Для помилок 1,2,4,5,9:
  
  

  <result> <error>опис</error> <error_code>N</error_code> </result>

  
  
• Для помилок 3,6,7,8:

  <result> <error>опис</error> <error_code>N</error_code> <id>id сообщения</id> </result>

• Для помилок 1,2,4,5,9:

  { "error": "опис", "error_code": N }

  
  
• Для помилок 3,6,7,8:

  { "error": "опис", "error_code": N, "id": <id сообщения> }

• при cost = 0 і fmt = 0: OK - <n> SMS, ID - <id>
  
  
• при cost = 1 і fmt = 0: <cost> (<n> SMS)
  
  
• при cost = 2 і fmt = 0: OK - <n> SMS, ID - <id>, COST - <cost>
  
  
• при cost = 3 і fmt = 0: OK - <n> SMS, ID - <id>, COST - <cost>, BALANCE - <balance>
  
  
• при cost = 0 і fmt = 1: <id>,<n>
  
  
• при cost = 1 і fmt = 1: <cost>,<n>
  
  
• при cost = 2 і fmt = 1: <id>,<n>,<cost>
  
  
• при cost = 3 і fmt = 1: <id>,<n>,<cost>,<balance>
  
  
• при cost = 0 і fmt = 2:

  <result> <id>id</id> <cnt>n</cnt> </result>

  
  
• при cost = 1 і fmt = 2:

  <result> <cost>cost</cost> <cnt>n</cnt> </result>

  
  
• при cost = 2 і fmt = 2:

  <result> <id>id</id> <cnt>n</cnt> <cost>cost</cost> </result>

  
  
• при cost = 3 і fmt = 2:

  <result> <id>id</id> <cnt>n</cnt> <cost>cost</cost> <balance>balance</balance> </result>

  
  
• при cost = 0 і fmt = 3:

  { "id": <id>, "cnt": <n> }

  
  
• при cost = 1 і fmt = 3:

  { "cost": "<cost>", "cnt": <n> }

  
  
• при cost = 2 і fmt = 3:

  { "id": <id>, "cnt": <n>, "cost": "<cost>" }

  
  
• при cost = 3 і fmt = 3:

  { "id": <id>, "cnt": <n>, "cost": "<cost>", "balance": "<balance>" }

  
  
• при op = 1 і fmt = 0 або 1, інформація додається в кінець звичайного виводу з нового рядка:
  <phone>,<mccmnc>,<cost>,<status>,<error>
  
  
• при op = 1 та fmt = 2, у відповідь додається масив:

  <phones> <phone mccmnc="mccmnc" cost="cost" status="status" error="error">phone</phone> ... </phones>

  
  
• при op = 1 та fmt = 3, у відповідь додається масив:

  "phones": [{ "phone": "<phone>", "mccmnc": "<mccmnc>", "cost": "<cost>", "status": "<status>", "error": "<error>" }, ... ]

  
  

Сервер не приймає більше одного однакового запиту на відправку SMS-повідомлень протягом хвилини для захисту від помилок і зациклень в програмі на стороні клієнта для того, щоб знизити навантаження і не витрачати кошти клієнта, а також не допустити багаторазової відправки повідомлення одному абоненту.

Сервер також блокує надсилання більше 50 повідомлень одному абоненту, які були відправлені з перервою між повідомленнями менше 60-ти секунд, для захисту від флуду і зайвого списання коштів із рахунку клієнта, так як багато операторів не пропускають велику кількість повідомлень одному абоненту за короткий проміжок часу.

Приклади надсилання повідомлень

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

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

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

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

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

Приклади відправки e-mail повідомлень

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

• voice = m – чоловічий голос.
• voice = m2 – чоловічий голос 2.
• voice = m3 – чоловічий голос 3 (за замовчуванням).
• voice = m4 – чоловічий голос 4.
• voice = w – жіночий голос.
• voice = w2 – жіночий голос 2.
• voice = w3 – жіночий голос 3.
• voice = w4 – жіночий голос 4.

Використання голосового меню (IVR)

Приклади відправки голосових повідомлень

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

Передача картинок

Додавання кнопки

Типи повідомлень

• Тільки текст – абонент отримує текстове повідомлення.
• Тільки картинка – абонент отримує картинку.
• Текст+кнопка – абонент отримує текстове повідомлення, під яким розташована кнопка. При натисненні на кнопку відбувається перехід за заданим посиланням.
• Текст+кнопка+картинка – абонент отримує текстове повідомлення, під яким розташовані картинка і кнопка. При натисненні на кнопку відбувається перехід за заданим посиланням.

• Hello! This is test message
• Вітаємо! Це тестове повідомлення
• Test
• Тест
• Test {button,https://smsc.ua,site}
• Тест {button,https://smsc.ua,сайт}
• Picture <file http://smsc.ua/im/smsc_logo_tiny.gif>
• Картинка <file http://smsc.ua/im/smsc_logo_tiny.gif>

Приклади відправки viber-повідомлень

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

Приклади відправки telegram-повідомлень

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

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

• при fmt = 0:
  ERROR = N (опис)
  
  
• при fmt = 1:
  0,-N
  
  
• при fmt = 2:

  <result> <error>опис</error> <error_code>N</error_code> </result>

  
  
• при fmt = 3:

  { "error": "опис", "error_code": N }

• при fmt = 0: ID - <id>
  
  
• при fmt = 1: <id>
  
  
• при fmt = 2:

  <template> <id>id</id> </template>

  
  
• при fmt = 3:

  { "id": <id> }

• при fmt = 0, 1: OK
  
  
• при fmt = 2:
  <result>OK</result>
  
  
• при fmt = 3:
  

  { "result": "OK" }

  
  
  

• при fmt = 0:

  id = <id>, name = <name>, format = <format>, sender = <sender>, flag = <flag>, message = <message> ...

  
  
• при fmt = 1:

  <id>,<name>,<format>,<sender>,<flag>,<message> ...

  
  
• при fmt = 2:

  <list> <template> <id>id</id> <name>name</name> <format>format</format> <sender>sender</sender> <flag>flag</flag> <message>message</message> </template> ... </list>

  
  
• при fmt = 3:

  [{ "id": <id>, "name": "<name>", "format": "<format>", "sender": "<sender>", "flag": <flag>, "message": "<message>" }, ...]

  
  

Сервер не приймає більше трьох однакових запитів на дії з шаблонами протягом хвилини для зниження навантаження і захисту від помилок і зациклень в програмі на стороні клієнта.

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

• при fmt = 0:
  ERROR = N (опис)
  
  
• при fmt = 1:
  0,-N
  
  
• при fmt = 2:

  <result> <error>опис</error> <error_code>N</error_code> </result>

  
  
• при fmt = 3:

  { "error": "опис", "error_code": N }

• при fmt = 0:

  name = <status>, id = <id> ...

  
  
• при fmt = 1:

  <name>,<status>,<id> ...

  
  
• при fmt = 2:

  <result> <template> <name>name</name> <status>status</status> <id>id</id> </template> ... </result>

  
  
• при fmt = 3:

  [{ "name": <status>, "id": <id> }, ...]

• при fmt = 0:

  name = <status>, id = <id> ...

  
  
• при fmt = 1:

  <name>,<status>,<id> ...

  
  
• при fmt = 2:

  <result> <template> <name>name</name> <status>status</status> <id>id</id> </template> ... </result>

  
  
• при fmt = 3:

  [{ "name": <status>, "id": <id> }, ...]

  
  

Сервер не приймає більше десяти однакових запитів на дії з шаблонами протягом хвилини для зниження навантаження і захисту від помилок і зациклення в програмі на стороні Клієнта.

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

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

• ERROR = N (опис)
  
  
• При fmt = 1:
  0,-N
  
  
• При fmt = 2:

  <result> <error>опис</error> <error_code>N</error_code> </result>

  
  
• При fmt = 3:

  { "error": "опис", "error_code": N }

• при fmt = 0 и fmt = 1: OK
  
  
• при fmt = 2:

  <result>OK</result>

  
  
• при fmt = 3:

  { "result": "OK" }

  
  

Сервер не приймає більше п'яти однакових запитів на відправку повідомлення протягом хвилини для зниження навантаження і захисту від помилок і зациклення в програмі на стороні Клієнта.