ИНТЕГРАЦИЯ С ДРУГИМИ СЕРВИСАМИ
Интеграция, если нет готового решения: услуга EMAIL2SMS

Email2SMS — это механизм создания SMS рассылок с помощью отправки E-mail сообщений на адрес email2sms@sms-assistent.by с определенными параметрами
Такое решение подойдёт в следующих случаях:
1
В вашей системе нет интеграции с нашим сервисом и, соответственно, нет возможности отправить SMS через наш сервис
2
У вас нет знаний или возможности программирования
3
В вашей системе нет возможности провести интеграцию или разработчик этой системы не хочет её делать по какой-то причине
4
Владельцам сайта, у которых на хостинге, на котором размещается сайт, нет возможности отправлять API запросы
5
Для пользователей почтовых клиентов (Outlook, Thunderbird и т.п.)
В вашей системе должна быть предусмотрена отправка e-mail с возможностью менять тему письма и адрес, на который происходит отправка писем
Общий принцип работы EMAIL2SMS
Когда письмо приходит на email2sms@sms-assistent.by, проверяется его тема и начинается обработка письма согласно опциям, выставленным в личном кабинете. Обработка письма происходит в зависимости от выбранного вами режима работы (3 варианта).
Режим работы «XML email сообщение»
В этом режиме вы можете формировать любую рассылку как одному, так и нескольким абонентам. Отправитель и текст сообщения, номер абонента и срок жизни SMS вы можете указывать самостоятельно. Для этого достаточно в письме в любом месте в единственном экземпляре вставить текст сообщения согласно примера:
<package login="login" password="123456">
<message>
<default sender="TEST-assist"/>
<msg recipient="295363600" sender="notdefault" validity_period="86400">text</msg>
<msg recipient="8(029)536-36-00">text</msg>
</message>
</package>
При обработке письма происходит поиск <package и выбирается информация, которая находится внутри тега «package». Причём не важно, что в письме может находиться другой текст.
Описание параметров в примере
package
тег, в котором указываются основные параметры запроса:
login
ваш логин, для доступа в Личный кабинет (ЛК)
password
ваш пароль к Email2SMS (пароль, который устанавливается на странице настроек Email2SMS в поле «Персональный пароль для Email2SMS»)
date_send
дата отправки SMS (передается только в том случае, если необходимо отправить запланированную рассылку).
Формат: ГГГГММДДЧЧММ. Например, передаем значение 201612250159 для того, чтобы запланировать рассылку на 25 декабря 2016 г. на 1ч 59м. Дата запланированной рассылки должна быть не меньше, чем текущая дата +10 минут

default
тег, в котором определяются общие атрибуты, указываемые для всех отправляемых SMS. Если какой-либо атрибут указан в SMS, то атрибут данного тега игнорирует­ся. В качестве содержимого можно также указать общий текст для всех SMS.

msg
тег SMS, в качестве параметра указывается текст отправляемого SMS, мо­жет содержать атрибуты:
recipient
номер получателя (формат номеров телефонов)
sender
отправитель SMS (подпись SMS). Необязательный атрибут
validity_period
срок жизни SMS в часах, значения >48 часов не обрабатываются (в этом случае выставляется значение равное 48)

Происходят следующие проверки:
  • значение параметра в диапазоне от 1 до 48 воспринимается как часы;
  • значение параметра в диапазоне от 49 до 3600 воспринимается как ошибочное, по умолчанию присваивается 48 ч;
  • в диапазоне от 3600 до 172800 воспринимается как передача данных в секундах;
  • значение больше, чем 172800, воспринимается как ошибочное и выставляется по умолчанию 48 ч.
Подключение в вашем личном кабинете SMS-ассистента
1
Зайдите в раздел «Email2SMS → Подключить Email2SMS»
2
Поставьте чек-бокс «Включить / Отключить»
3
В появившемся меню режима работы выберите «XML email сообщение»
4
Введите уникальную тему письма, например, УНИКАЛЬНАЯ_ТЕМА_ПИСЬМА. Тема письма должна быть обязательно уникальной, так как именно по теме письма идёт привязка к вашему аккаунту. Придумайте такую тему письма, чтобы её не могли случайно повторить другие наши клиенты
5
Введите свой пароль в поле «Персональный пароль для Email2SMS»
6
Нажмите кнопку [Сохранить]
Настройка отправки SMS, если у вас программа/система
1
Зайдите в вашу программу/систему и в настройках отправки E-mail введите тему письма, которую вы прописали при подключении. На нашем примере это: УНИКАЛЬНАЯ_ТЕМА_ПИСЬМА
2
Здесь же, в текст письма, в любое нужное вам место, вставьте следующий текст, заменив в нём данные, указанные красным цветом, на ваши и вставьте текст SMS вместо ТЕКСТ_СМС_СООБЩЕНИЯ:
<package login="ВАШ_ЛОГИН_В_SMS-ASSISTENT" password="ВАШ_ПАРОЛЬ_УКАЗАННЫЙ_В_ЛК_НА_СТРАНИЦЕ_ПОДКЛЮЧЕНИЯ_УСЛУГИ_EMAIL2SMS">
<message>
<default sender="ОТПРАВИТЕЛЬ_СМС_СООБЩЕНИЯ_ИЗ_ЛК_SMS-ASSISTENT"/>
<msg recipient="НОМЕР_ТЕЛЕФОНА_АБОНЕНТА_КОТОРОМУ_НУЖНО_ОТПРАВИТЬ_СМС">ТЕКСТ_СМС_СООБЩЕНИЯ</msg>
</message>
</package>
Настройка отправки SMS, если вы владелец сайта с доступом к редактированию исходного кода
В этом случае для отправки SMS рассылки вам может подойти следующий PHP-код:
<?php
$mail_to = 'email2sms@sms-assistent.by';
$mail_subject = 'УНИКАЛЬНАЯ_ТЕМА_ПИСЬМА';
$mail_message = '<package login="ВАШ_ЛОГИН_В_SMS-ASSISTENT" password="ВАШ_ПАРОЛЬ_УКАЗАННЫЙ_В_ЛК_НА_СТРАНИЦЕ_ПОДКЛЮЧЕНИЯ_УСЛУГИ_EMAIL2SMS">
<message>
<default sender="ОТПРАВИТЕЛЬ_СМС_СООБЩЕНИЯ_ИЗ_ЛК_SMS-ASSISTENT"/>
<msg recipient="НОМЕР_ТЕЛЕФОНА_АБОНЕНТА_КОТОРОМУ_НУЖНО_ОТПРАВИТЬ_СМС">ТЕКСТ_СМС_СООБЩЕНИЯ</msg>
</message>
</package>';
$res_send = mail($mail_to, $mail_subject, $mail_message)
?>
Режим работы «Модуль к магазинам shop.by»
Данный режим работы предназначен для магазинов shop.by. Как подключить смотрите здесь.
Режим работы «По отправителю e-mail»
Если при проверке темы пришедшего email–письма на адрес email2sms@sms-assistent.by она не совпадает с темой, прописанной в поле «Тема email» в основных настройках услуги Email2SMS пользователя, то проверяется e-mail адрес отправителя письма. При совпадении e-mail–адреса отправителя письма с установленным e-mail–адресом в дополнительных настройках услуги Email2SMS в вашем аккаунте, выполняется последующее действие, указанное для этого e-mail в настройках типа режима (6 типов)
Основные требования
1
E-mail отправителя в настройках услуги Email2SMS должен быть уникальным для каждого варианта последующих действий
2
E-mail отправителя в настройках услуги Email2SMS должен быть уникальным в системе SMS-ассистент и принадлежать (быть указан) только у одного пользователя
3
Для каждого e-mail-адреса отправителя письма можно настроить персональный(ые) номер(а) телефона(ов) для отправки SMS-сообщения. В случае указания персональных номеров отправка SMS будет идти только на них, телефоны из XML или из темы e-mail письма будут игнорироваться
4
Указание темы письма обязательно, даже если тип режима не предполагает его указание
Подключение в вашем личном кабинете SMS-ассистента
1
Зайдите в раздел «Email2SMS → Подключить Email2SMS»
2
Поставьте чек-бокс «Включить / Отключить»
3
В появившемся меню режима работы выберите «По отправителю e-mail»
4
Введите уникальную тему письма, например, УНИКАЛЬНАЯ_ТЕМА_ПИСЬМА. Тема письма должна быть обязательно уникальной, так как именно по теме письма идёт привязка к вашему аккаунту. Придумайте такую тему письма, чтобы её не могли случайно повторить другие наши клиенты
5
Введите свой пароль в поле «Персональный пароль для Email2SMS»
6
Нажмите кнопку [Сохранить]
Типы режима работы
Тип 1. Общий текст SMS для разных абонентов, указанных в тексте письма
На телефон получателя, указанного в тексте пришедшего письма в специальном XML-блоке, отправляется текст SMS, указанный в настройках услуги, независимо от того, что указано в тексте пришедшего письма.

Пример XML-блока, который должен быть в тексте письма:
<package login="[Логин]" password="[Пароль для Email2SMS]">
  <message>
    <default sender="[Отправитель]" validity_period="[Срок жизни СМС]" />
    <msg recipient="[Получатель 1]" />
    <msg recipient="[Получатель 2]" />
    <msg recipient="[Получатель N]" />
  </message>
</package>

Тип 2. Разный текст SMS из части текста письма для одного и того же заранее указанного абонента
На телефон получателя, указанного в настройках услуги, отправляется текст SMS, указанный в тексте письма в специальном XML-блоке.

Пример XML-блока, который должен быть в тексте письма:
<package login="[Логин]" password="[Пароль для Email2SMS]">
  <message>
    <default sender="[Отправитель]" validity_period="[Срок жизни СМС]">
      [Текст СМС сообщения]
    </default>
  </message>
</package>

Тип 3. Для одного и того же заранее указанного абонента разный текст SMS, повторяющий весь текст письма
На телефон получателя, указанного в настройках услуги, отправляется текст SMS, который повторяет полностью содержимое текста письма. В этом случае в письме не нужно передавать в тексте специальный XML-блок, а в тему письма необходимо обязательно добавить параметры аккаунта пользователя в следующем формате:
[Логин]::[Пароль для Email2SMS]

Тип 4. Весь текст письма для абонента, указанного в теме этого письма
На телефон получателя, указанного в теме письма, отправляется текст SMS, который повторяет полностью содержимое текста письма. В этом случае в письме не нужно передавать в тексте специальный XML-блок, а в тему письма необходимо обязательно добавить параметры аккаунта пользователя и телефон(ы) получателя(ей) SMS в следующем формате:
[Логин]::[Пароль для Email2SMS]::[Номера телефонов через запятую]

Тип 5. Для одного и того же заранее указанного абонента один и тот же заранее заданный текст SMS
На телефон получателя, указанного в настройках услуги, отправляется текст SMS, указанный в настройках услуги

Тип 6. Общий текст SMS для разных абонентов, указанных в теме письма
На телефон получателя, указанного в теме письма, отправляется текст SMS, указанный в настройках услуги. В этом случае в письме не нужно передавать в тексте письма специальный XML-блок, а в тему письма необходимо обязательно добавить параметры аккаунта пользователя и телефон(ы) получателя(ей) SMS в следующем формате:
[Логин]::[Пароль для Email2SMS]::[Номера телефонов через запятую]
Ещё в этом разделе