| Отправка сообщенияОтправка SMS-сообщенияДля отправки SMS-сообщения используйте команду SUBMIT_SM согласно спецификации.
Поддерживаются следующие кодировки:
- 7-битная GSM для латинского текста с поддержкой европейских символов − (coding = 0);
- 8-битная ISO-8859-1 (ASCII) для латинского текста или бинарных данных − (coding = 1);
- UCS2 (UCS-2BE или UTF-16BE) для национальных алфавитов (например, русского) − (coding = 2).
Поле coding кодируется двумя битами в составном поле data_coding, поэтому data_coding = coding * 4.
Для использования кодировки ISO-8859-1 (ASCII) вместо GSM при подключении нужно указать:
system-type = "ISO"
В текст SMS-сообщения можно добавлять комментарии, предназначенные для просмотра
отправителем истории сообщений в личном кабинете.
Команда SUBMIT_MULTI для множественной рассылки пока не реализована.
Сервер не принимает более одного одинакового запроса на отправку SMS-сообщений в течение минуты
для защиты от ошибок и зацикливаний в программе на стороне Клиента для того, чтобы снизить нагрузку и не
расходовать средства Клиента, а также не допустить многократной отправки сообщения одному абоненту.
Сервер также блокирует отправку более 50 сообщений одному абоненту, которые были отправлены с перерывом
между сообщениями менее 30-ти секунд, для защиты от флуда и лишнего списания средств со счета Клиента,
так как многие операторы не пропускают большое количество сообщений одному абоненту за короткий промежуток времени.
Комментарии в SMS-сообщенияхПри отправке SMS-сообщений можно добавлять в конец текста любой комментарий, уточняющий либо дополняющий SMS-сообщение для отправителя.
Данный текст не будет отправляться абонентам и влиять на стоимость SMS и доступен для просмотра и фильтрации в списке отправленных сообщений в личном кабинете.
Для добавления комментария необходимо в конце текста SMS-сообщения, предназначенного для отправки, указать специальную комбинацию "\n~~~\n"
(перевод строки, 3 символа тильды и снова перевод строки), и после этого любой текст, который будет считаться комментарием, не будет отправлен абоненту,
но отобразится в истории.Отправка MMS-сообщенияДля отправки MMS-сообщения используйте команду SUBMIT_SM с текстом "__MMS__: <message>\nsubj:<subject>" (текст "__MMS__", двоеточие, пробел, текст сообщения, перевод строки, текст "subj", двоеточие, тема MMS-сообщения).Отправка e-mail сообщенияДля отправки e-mail сообщения используйте команду SUBMIT_SM с текстом "__MAIL__: <message>\nsubj:<subject>" (текст "__MAIL__", двоеточие, пробел, текст сообщения, перевод строки, слово "subj", двоеточие, тема e-mail сообщения).Отправка голосового сообщения (звонок)Для отправки голосового сообщения используйте команду SUBMIT_SM с текстом "__CALL__: <message>\nvoice:<voice>" (текст "__CALL__", двоеточие, пробел, текст сообщения, перевод строки, слово "voice", двоеточие, голос, используемый для озвучивания текста).
Возможные значения для используемого голоса:
- m (по умолчанию) – мужской голос.
- m2 – мужской альтернативный голос.
- w – женский голос.
- w2 – женский альтернативный голос.
При отправке голосового сообщения в конце текста можно указать специальную комбинацию "\n~~~\n" (перевод строки, 3 символа
тильды и снова перевод строки), после которой передать параметр param, определяющий некоторые характеристики звонка
(более подробно можно посмотреть в описании).Отправка viber-сообщенияДля отправки viber-сообщения используйте команду SUBMIT_SM с текстом "__VIBER__: <message>" (текст "__VIBER__", двоеточие, пробел, текст сообщения).
При формировании текста сообщения можно использовать специальные макросы для создания кнопки, при нажатии на которую будет происходить открытие браузера и переход по указанной в макросе ссылке, а также прикреплять файлы. Более подробно
дополнительные возможности при отправке viber-сообщений описаны в документации к http-протоколу.Отправка soc-сообщенияДля отправки soc-сообщения, отправляемого пользователям социальных сетей "Одноклассники", "ВКонтакте" или пользователям "Mail.Ru Агент", используйте команду SUBMIT_SM с текстом "__SOC__: <message>" (текст "__SOC__", двоеточие, пробел, текст сообщения).
Отправка HLR-запросаДля отправки HLR-запроса используйте команду SUBMIT_SM с текстом __HLR__.
Результат запроса приходит в обычном статусе (Delivery Report), который можно получить
как по SMPP-подключению, так и по HTTP на свой обработчик.
Формат статуса с результатом HLR-запроса, возвращаемого по SMPP:
id:<id> stat:<status> err:<err> imsi:<imsi> msc:<msc> mcc:<mcc> mnc:<mnc> cn:<cn> net:<net> rcn:<rcn> rnet:<rnet>
Описание параметров:
| Параметр | Значение
|
|---|
| id | Идентификатор сообщения.
|
|---|
| status | Статус сообщения.
|
|---|
| err | Код ошибки, если абонент недоступен (список).
|
|---|
| imsi | Уникальный код IMSI SIM-карты абонента.
|
|---|
| msc | Номер сервис-центра оператора, в сети которого находится абонент.
|
|---|
| mcc | Числовой код страны абонента.
|
|---|
| mnc | Числовой код оператора абонента.
|
|---|
| cn | Название страны регистрации абонента.
|
|---|
| net | Название оператора регистрации абонента.
|
|---|
| rcn | Название роуминговой страны абонента при нахождении в чужой сети.
|
|---|
| rnet | Название роумингового оператора абонента при нахождении в чужой сети.
|
|---|
Строковые данные, например, страна и оператор, закодированы через функцию urlencode.
Пример результата HLR-запроса:
id:855469 stat:DELIVRD err:000 imsi:250023012345678 msc:79232510066 mcc:250 mnc:02 cn:Russian+Federation net:MegaFON+open+Joint+Stock+Company rcn: rnet:
Пример кода на PHP для разбора строки с результатом HLR-запроса:
$dlr = strtr($dlr, ": ", "=&"); // $dlr - строка статуса
parse_str($dlr, $m); // $m - массив параметров, $m["id"], $m["err"], $m["imsi"] и тд.
Пример разбора через регулярные выражения:
preg_match("/^id:(\d+) stat:(\w+) err:(\d+) imsi:(\d*) msc:(\d*) mcc:(\d*) mnc:(\d*) cn:([^ ]*) net:([^ ]*) rcn:([^ ]*) rnet:([^ ]*)/", $dlr, $m); // $dlr - строка статуса
for ($i = 6; $i <= 9; $i++)
$m[$i] = urldecode($m[$i]);
// $m - массив параметров, $m[1] = id, $m[2] = status, $m[3] = err и тд.
Для отправки Ping-SMS используйте команду SUBMIT_SM с текстом __PING__. |
ОТПРАВКА СООБЩЕНИЯ