PromoSMS - сервис рассылки смс, e-mail, прием входящих смс

SMTP-протокол

Инструкции по подключению к SMS- шлюзу PromoSMS

SMTP - протокол


    Для того чтобы отправить SMS на телефон абонента, используя SMTP-протокол (Simple Mail Transfer Protocol), требуется написать (или программа должна сгенерировать) письмо на адрес: smsgate@promosms.ru. В теме письма можно указать несколько телефонов получателей, разделенных запятой, а само сообщение – в теле письма. Кодировка письма — любая. По умолчанию (если кодировка не задана) выставляется «windows-1251». После текста сообщения должен следовать разделительный знак «@@», после которого необходимо указать дополнительные параметры. Каждый дополнительный параметр после «@@» указывается на новой строчке.

Параметры SMTP:

Название параметра

Описание

From

Любое

To

smsgate@promosms.ru

Subj

1 и более номеров через запятую

Data

Текст письма c обязательными параметрами.

Дополнительные параметры :

Название параметра

Значение

Тип

Описание

login

Выдается техподдержкой

Обязательное

Логин вашего профиля. Обязательный

password

Выдается техподдержкой

Обязательное

Пароль вашего профиля

sender

Имя отправителя

Необязательное

Имя отправителя, если параметр не указан, подставляется по умолчанию для подключения.

translit

true

Необязательное

Если текст смс указан в кириллице, будет произведен перевод текста смс в латинницу

vcard

true

Необязательное

Если указан данный параметр, смс отправляется как визитная карточка

file

true

Необязательное

Если указан данный параметр, будет создана рассылка на основе приложенного к письму файла. Файл должен быть в формате .csv или .txt

и кодирован в Windows кодировке (windows-1251).

separatedby

Знак разделителя столбцов в файле

Необязательное

Если параметр не указан, по умолчанию берется знак «;» .

Описание стандартов Vcard - http://ru.wikipedia.org/wiki/VCard

Если при отправке визитной карточки, в тексте значения параметра присутствуют символы кириллицы, то к параметру необходимо добавить свойство «CHARSET=UTF-8;ENCODING=QUOTED-PRINTABLE».


Примеры:

1. Простая отправка

Простая отправка

2. Отправка с параметром транслитерации 


2.png

3.Отправка визитной карточки.


3.png

4. Создание рассылки из файла с общим текстом смс


4.png

Содержимое файла:


5.png

Статусы SMS-сообщений

   Информация о статусе 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

Код страны

Код оператора

Номер телефона