Инструкции по подключению к SMS- шлюзу PromoSMS
Для того чтобы отправить SMS на телефон абонента, используя SMTP-протокол (Simple Mail Transfer Protocol), требуется написать (или программа должна сгенерировать) письмо на адрес: smsgate@promosms.ru. В теме письма можно указать несколько телефонов получателей, разделенных запятой, а само сообщение – в теле письма. Кодировка письма — любая. По умолчанию (если кодировка не задана) выставляется «windows-1251». После текста сообщения должен следовать разделительный знак «@@», после которого необходимо указать дополнительные параметры. Каждый дополнительный параметр после «@@» указывается на новой строчке.
Параметры SMTP:
Название параметра |
Описание |
|
From |
Любое |
|
To |
||
Subj |
1 и более номеров через запятую |
|
Data |
Текст письма c обязательными параметрами. |
Дополнительные параметры :
Название параметра |
Значение |
Тип |
Описание |
login |
Выдается техподдержкой |
Обязательное |
Логин вашего профиля. Обязательный |
password |
Выдается техподдержкой |
Обязательное |
Пароль вашего профиля |
sender |
Имя отправителя |
Необязательное |
Имя отправителя, если параметр не указан, подставляется по умолчанию для подключения. |
translit |
true |
Необязательное |
Если текст смс указан в кириллице, будет произведен перевод текста смс в латинницу |
vcard |
true |
Необязательное |
Если указан данный параметр, смс отправляется как визитная карточка |
file |
true |
Необязательное |
Если указан данный параметр, будет создана рассылка на основе приложенного к письму файла. Файл должен быть в формате .csv или .txt и кодирован в Windows кодировке (windows-1251). |
separatedby |
Знак разделителя столбцов в файле |
Необязательное |
Если параметр не указан, по умолчанию берется знак «;» . |
Описание стандартов Vcard -
Если при отправке визитной карточки, в тексте значения параметра присутствуют символы кириллицы, то к параметру необходимо добавить свойство «CHARSET=UTF-8;ENCODING=QUOTED-PRINTABLE».
Примеры:
1. Простая отправка
2. Отправка с параметром транслитерации
3.Отправка визитной карточки.
4. Создание рассылки из файла с общим текстом смс
Содержимое файла:
Информация о статусе SMS-сообщений поступает от SMS-центров, через которые происходит отправка сообщений абоненту. При получении информации от находящихся за рубежом SMS-центров статус SMS-сообщения иногда может быть некорретным.
Для проверки статуса отправленного сообщения вызывается команда:
gsmstat <Уникальный референс отправленного сообщения>
В ответ сервис выдает строку вида:
250 <код статуса> <дата доставки и краткая расшифровка статуса>\r\n
При запросе статуса командой gsmstat |
Значение кода статуса |
2 |
Доставлено до абонента. |
7 |
Доставлено до абонента после его недоступности. |
3 |
Не доставлено за установленное оператором время. |
5 |
Не может быть доставлено, номер не существует. |
8 |
Не может быть доставлено, номер в черных списках оператора. |
-1 |
Не доставлено до абонента. |
Любое SMS-сообщение достигает окончательного статуса не более чем, через 24 часа после отправки.
Номер телефона абонента должен соответствовать рекомендации E.164 от ITU-T, определяющей общий международный телекоммуникационный план нумерации. Номера по E.164 могут иметь максимум 15 цифр и обычно записываются с префиксом «+». При отправке SMS-сообщений префикс можно «+» можно не указывать, сразу указывая код страны.
7 |
916 |
1112233 |
Код страны |
Код оператора |
Номер телефона |
Например, 79161112233 (здесь 7 – код России и Казахстана, 916 – код оператора, 1112233 – номер телефона). В том случае, если у абонента прямой городской номер, телефон абонента пишется также в международном формате, с указанием кода города. Например, для прямых Московских номеров: 70951112233. Исключение составляют абоненты Билайн Москва (и только они). Все телефоны абонентов Билайн передаются как 7903xxxxxxx (даже, если телефон прямой московский).
Пример сотового номера Армении:
374 |
9 |
1112233 |
Код страны |
Код оператора |
Номер телефона |
Пример сотового номера Израиля:
972 |
54 |
1112233 |
Код страны |
Код оператора |
Номер телефона |