Универсальный шлюз

Правила пользования сервисом
Взаимодействие с сервисом
Функция пересылки
Договор об оказании услуг
Пример настройки уведомлений UPS по SMS
Пример настройки уведомлений Антивируса по ICQ
Пример настройки уведомлений резервного копирования Acronis по SMS

Правила пользования сервисом:

Запрещается:
1. Отправлять сообщения, противоречащие действующему законодательству (сообщения, носящие экстремистский, порнографический, фашистский или другой предосудительный характер), а также вторгаться в частную сферу получателей.
2. Отправлять сообщения рекламного характера (спама).

Взаимодействие с сервисом:

1. Метод SMTP. Для передачи сообщения необходимо отправить специально сформированное сообщение вида:
![login]:[password]:[flag]:[to]:[text] .
Где
[login] Ваш логин в системе,
[password] пароль или хеш md5 пароля,
[flag] одна буква, указывающая направление передачи сообщения "I" - ICQ "S" - SMS "M" - mail (регистр значения не имеет),
[to] ящик, icq или sms номер,
[text] текст сообщения.

Параметр [flag] может быть дополнен ещё двумя параметрами через запятую: Sender ID и Flash (Flash = 0 или 1).
Пример: [S,Gatesms.ru,1] - отправит SMS сообщение с Sender ID = Gatesms.ru и оно сразу появится на экране телефона.

Входящие сообщения отправляются на почтовый ящик, ICQ или SMS номер, указанные на главной странице системы, доступной после авторизации.

Пример: !test:1234:i:112233445:Привет, как дела? Отправит ICQ сообщение,
!test:1234:s:79201234567:Привет, позвони! Отправит SMS сообщение,
!test:1234:m:test@mail.ru:Привет, включай телевизор. Отправит E-mail сообщение.

2. Метод HTTP(S). Сервис позволяет принимать сообщения, переданные GET или POST запросом. http://gatesms.ru/sender.php?lg=LOGIN&pw=PASSWORD&fl=FLAG&to=TO&mg=TEXT
параметры запроса соответствуют параметрам, описанных в SMTP запросе.
Результатом запроса является статус успеха OK: N, где N - ID отправленного пакета или статус ошибки ERROR: N, где N - номер ошибки.
Используемые статусы ошибок:
0 - "Ошибка в параметрах."
1 - "Неверный логин/пароль."
2 - "Ошибка в флаге назначения."
3 - "Ошибка в адресе назначения."
4 - "Баланс ниже необходимого уровня."
5 - "Запрещено."
6 - "Баланс ниже необходимого уровня. Пакет не отправлен или отправлен не полностью."
Адрес назначения [to] может содержать несколько значений разделённых запятой.
Список дополнительных параметров:
&senderid=<ваше_значение>. Подмена номера отправителя. Если значение SenderID задано некорректно или будет отсутствовать, в таком случае SenderID примет значение из соответствующего поля настроек профиля, если оно указано.
&flash=1 Flash сообщения сразу появляются на экране мобильного телефона и не сохраняются.
&char=utf8 Изменение кодировки. Требуется, если сообщения передаются в utf8 кодировке.
&cost=1 Определение стоимости рассылки. Позволяет получить предварительную стоимость рассылки.

Для повышения надёжности доставки SMS сообщений мы используем несколько серверов в разных DATA-центрах. Если при отправке SMS первый сервер gatesms.ru оказался недоступным, отправьте запрос на ВТОРОЙ сервер www2.gatesms.ru. Ниже приведён пример php-кода реализующий эту возможность в автоматическом режиме.
Пример php-кода реализации функции HTTP(S)

3. Получение ответов и статусов.
Способ 1. Сервер при получении статусов и ответов сам может вызывать Ваш скрипт для передачи полученной информации. Для этого в настройках укажите URL-адрес вызываемого скрипта. Данные передаются методом POST в переменной msg.
Общий вид статуса:
xxxx : Отправка SMS : 79201234567 - status: Доставлено - time: 2010-02-14 17:14:36
Общий вид ответа:
xxxx : Ответ на ICQ сообщение : 123456789 - time: 2010-02-14 15:30:02 - msg: test
xxxx - внутренний ID сообщения.
Способ 2. Самостоятельно запросить статус или ответ командой:
http://gatesms.ru/status.php?lg=LOGIN&pw=PASSWORD&id=[ID]
При указании &id=0 можно получить Ваш текущий баланс в системе.
Параметр &frt=xml (или &frt=1) отобразит ответ в XML формате.
Обратите внимание, что излишние запросы одного и того же статуса, многократная попытка ввода неверного логина/пароля, а так же частые запросы несуществующего ID могут заблокировать Вам доступ к этой функции. Так же рекомендуем не делать запрос статусов чаще, чем раз в минуту.

4. В случаях, когда нет возможности изменить содержимое письма, например, в системе уведомлений UPS, на вкладке "Пересылка" можно задать правила обработки входящих писем.
Настройка уведомлений:
Окно настройки уведомлений представляет из себя список правил, разделённых на группы по признаку входящих сообщений (E-mail, SMS, ICQ)

Для создания нового правила нажать "Добавить"

Ввести имя правила и его позицию. Позиция играет роль в порядке обработки правил, как только находится условие, удовлетворяющее правилу, правило выполняется, а оставшиеся отбрасываются.

Указать, с какого адресата ожидать сообщения. Если этот адрес отсутствует в списке правил (например, является новым), на него будет выслан код подтверждения.

Поля "дополнительные условия" служат для переопределения тела сообщения.
Поле 1. Указывается фраза или несколько фраз, разделённых символом "|". Правило будет работать только в том случае, если эта последовательность будет найдена .
Поле 2. Служит для подмены текста сообщения полностью либо частично, используя предлагаемые макросы.

Управляющие флаги позволяют отформатировать сообщение до минимального размера. Уровень гистерезиса предназначен для блокировки одинаковых повторяющихся сообщений. Время жизни гистерезиса задаётся в минутах.

В полях назначения указывается, куда отправить полученное или обработанное сообщение. Допустимо несколько адресов в поле, разделённых запятыми.
Внимание: для критически важных сообщений рекомендуется указывать более одного способа доставки для повышения надёжности.