Отправка сообщений

Отправка 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-запроса

Отправка 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-сообщения

Передача файлов

• в виде полного http(s)-адреса внешнего файла, указанного в тексте сообщения, в формате <file http(s)://...> (только для картинок и файлов документов);
• методом POST в теле http(s)-запроса к серверу. При данном способе отправки прикрепляемые файлы необходимо обозначить в тексте сообщения специальным образом в виде "<file n>", где n - номер файла в формируемом списке начиная с единицы;
• добавлением в http(s)-запрос специального дополнительного параметра fileurl, содержащего полный http(s)-адрес передаваемого внешнего файла. При использовании fileurl передача в запросе параметра mes необязательна;
• при отправке с личного кабинета или через API вставкой в текст сообщения полной http(s)-ссылки ранее загруженного файла, узнать которую можно в личном кабинете на странице отправки, нажав последовательно "прикрепить файл" – "Загруженные файлы".

• jpg, jpeg, gif, png – для картинок;
• doc, docx, rtf, dotx, dot, odf, fodt, odt, txt, info, pdf, xps, eps, pdax, xlsx, xlsm, fods, ods, csv, xltx – для файлов документов;
• 3gp, m4v, mov, mp4 – для видео.

Добавление кнопки

Типы сообщений

• Только текст – абонент получает текстовое сообщение.
• Только картинка – абонент получает картинку.
• Текст+кнопка – абонент получает текстовое сообщение, под которым расположена кнопка. При нажатии на кнопку происходит переход по заданной ссылке.
• Текст+кнопка+картинка – абонент получает текстовое сообщение, под которым расположены картинка и кнопка. При нажатии на кнопку происходит переход по заданной ссылке.
• Только файл – абоненту передается файл одного из поддерживаемых форматов.
• Картинка+видео – абонент получает видео-файл, заставкой к которому является передаваемая картинка.
• Текст+картинка+видео – абонент получает видео-файл с картинкой-заставкой и указанным текстом.
• Текст+картинка+видео+кнопка – абонент получает видео-файл с картинкой-заставкой, указанным текстом и кнопкой. При нажатии на кнопку происходит переход по заданной ссылке.

• Hello! This is test message
• Здравствуйте! Это тестовое сообщение
• Test
• Тест
• Test {button,https://smsc.kz,site}
• Тест {button,https://smsc.kz,сайт}
• Picture <file http://smsc.kz/im/smsc_logo_tiny.gif>
• Картинка <file http://smsc.kz/im/smsc_logo_tiny.gif>

Примеры отправки viber-сообщений

Отправка сообщения в Telegram

Примеры отправки сообщений в Telegram

Отправка сообщения в чат-бот 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" }

  
  

Сервер не принимает более пяти одинаковых запросов на отправку уведомления в течение минуты для снижения нагрузки и защиты от ошибок и зацикливаний в программе на стороне Клиента.