Мы более не предоставляем веб-сервис рассылок, так как считаем ePochta Mailer более выгодным предложением.
Вы получаете программу для рассылок за 3900 RUB без ежемесячных платежей.
Подробнее
/ru/servis-pochtovyh-rassylok/epochta-sms-api-v-2-0/

ePochta Mail Service

Сервис почтовых рассылок

 

ePochta SMS API (v. 2.0)

Пример использования API на языке программирования PHP. Подробно

Базовые положения

Для активации смс шлюза необходимо в панели управления сервисом ePochta SMS в «Настройках» (https://myatompark.com/members/sms/profile.php) активировать использование API. Для этого в пункте «XML интерфейс включен» необходимо выбрать пункт «Да». В пункте «XML интерфейс: режим работы» выбрать либо «Реальная отправка», либо «Тестовый режим».

В случае выбора режима «Реальной отправки» сообщения будет отправлены незамедлительно после поступления запроса на шлюз. В случае выбора «Тестового режима» сообщения отправлены не будут. Но будут созданы задачи со статусом «Не готово». Это свидетельствует о том, что было успешное подключение к шлюзу и данные на сервер были переданы.

Отправка смс

Отправка смс происходит путем POST запроса на скрипт  https://api.atompark.com/members/sms/xml.php. В передаваемом POST параметре ‘XML’ находится собственно XML документ следующей структуры:

  	<SMS>		
  	<operations>		
  	<operation>SEND</operation>		
  	</operations>		
  	<authentification>		
  	<username></username>		
  	<password></password>		
  	</authentification>		
  	<message>		
  	<sender></sender>		
  	<text></text>		
  	</message>		
  	<numbers>		
  	<number></number>		
  	<number></number>		
  	<number  messageID="msg11"></number>		
  	<number  messageID="msg12"  variables="var1;var2;var3;"></number>		
  	</numbers>		
  	</SMS>

Список параметров:

<operation> — для данной операции должен быть установлен в SEND.

<username> — логин пользователя в системе SMS Sender.

<password> — пароль пользователя в системе SMS Sender.

<sender> — отправитель смс. 14 цифровых символов или 11 цифробуквенных (английские буквы и цифры).

<text> — текст SMS.

Специальные параметры для рассылки по России

В разделе <numbers> задаются номера получателей (более одного). Если Вы хотите использовать слежение за статусом SMS, установите для каждого номер атрибут messageID , в дальнейшем он будет использоваться при запросе статуса сообщения. Атрибут variables в теге <number> служит для персонализации рассылки. Выглядит персонализированная рассылка примерно следующим образом (фрагмент XML):

  	<message>		
  	<sender>SMSKA</sender>		
  	<text><![CDATA[Hello %1% I’ve bought you  %2%]]></text>		
  	</message>		
  	<numbers>		
  	<number messageID="msg11"  variables="John; a car;"></number>		
  	<number messageID="msg12"  variables="Peter;cookies;"></number>		
  	</numbers>

Первая SMS на телефоне получателя будет иметь вид “Hello John I’ve bought you a car”, вторая как “Hello Peter I’ve bought you cookies”

В ответ будет получена XML примерно такого содержания:

<RESPONSE>		
    	<status>status_code</status>		
    	<credits></credits>		
    	</RESPONSE>
СтатусЗначениеОписание
AUTH_FAILED-1Неправильный логин и/или пароль
XML_ERROR-2Неправильный формат XML
NOT_ENOUGH_CREDITS-3Недостаточно кредитов на аккаунте пользователя
NO_RECIPIENTS-4Нет верных номеров получателей
SEND_OK>  0Количество отправленных SMS.

Параметр <credits> будет указывать, сколько кредитов было снято за рассылку сообщений.

Получение количества кредитов, которые необходимы для отправки рассылки

 

Список параметров аналогичен п. 1, единственным отличием является то, что <operation> для данной операции должна быть  установлена в GETPRICE.

В ответ будет получена XML примерно такого содержания:

  	<RESPONSE>	
  	<status>status_code</status>	
  	<credits><credits>	
  	</RESPONSE>
СтатусЗначениеОписание
AUTH_FAILED-1Неправильный логин и/или пароль
ОК0Запрос верный
XML_ERROR-2Неправильный формат XML

В параметре credits будет указано количество кредитов, необходимых для отправки рассылки.

Получение статуса сообщения

Получение статуса происходит путем POST запроса на скрипт  https://api.atompark.com/members/sms/xml.php. В передаваемом POST параметре ‘XML’ находится собственно XML документ следующей структуры:

  	<SMS>		
  	<operations>		
  	<operation>GETSTATUS</operation>		
  	</operations>		
  	<authentification>		
  	<username></username>		
  	<password></password>		
  	</authentification>		
  	<statistics>		
  	<messageid></messageid>		
  	<messageid></messageid>		
  	</statistics>		
  	</SMS>

Ответом на это будет XML следующего содержания:

  	<deliveryreport>		
    	<message id="msgID"  sentdate="xxxxx" donedate="xxxxx" status="xxxxxx"/>
    	<message id="msgID" sentdate="xxxxx"  donedate="xxxxx" status="xxxxxx"/>
    	.....		
	</deliveryreport>
СтатусОписание
SENTОтослано
NOT_DELIVEREDНе доставлено
DELIVEREDДоставлено
NOT_ALLOWEDОператор не обслуживается
INVALID_DESTINATION_ADDRESSНеверный адрес для доставки
INVALID_SOURCE_ADDRESSНеправильное имя «От кого»
NOT_ENOUGH_CREDITSНедостаточно кредитов

Даты приходят в формате yyyy-mm-dd hh:mm:ss

Получение текущего баланса пользователя

Отправка смс происходит путем POST запроса на скрипт  https://api.atompark.com/members/sms/xml.php. В передаваемом POST параметре ‘XML’ находится собственно XML документ следующей структуры:

 	<SMS>		
  	<operations>		
  	<operation>BALANCE</operation>		
  	</operations>		
  	<authentification>		
  	<username></username>		
  	<password></password>		
  	</authentification>		
  	</SMS>

Список параметров:

    	<operation>	 - 
		для данной операции должна быть  установлена в BALANCE.	
    	<username>	 - логин  пользователя в системе SMS Sender.	
    	<password>	 - пароль  пользователя в системе SMS Sender.

В ответ будет получена XML примерно такого содержания:

  	<RESPONSE>		
  	<status>status_code</status>		
  	<credits></credits>		
  	</RESPONSE>
СтатусЗначениеОписание
AUTH_FAILED-1Неправильный логин и/или пароль
ОК0Запрос верный
XML_ERROR-2Неправильный формат XML

В параметре credits будет указано количество кредитов на балансе пользователя

Получение стоимости одного кредита

Отправка смс происходит путем POST запроса на скрипт  https://api.atompark.com/members/sms/xml.php. В передаваемом POST параметре ‘XML’ находится собственно XML документ следующей структуры:

  	<SMS>		
  	<operations>		
  	<operation>CREDITPRICE</operation>		
  	</operations>		
  	<authentification>		
  	<username></username>		
  	<password></password>		
  	</authentification>		
	</SMS>

Список параметров:

  	<operation> - 
	для данной операции должна быть   установлена в CREDITPRICE.	
  	<username>	 - логин  пользователя в системе SMS Sender.	
  	<password>	 - пароль  пользователя в системе SMS Sender.

В ответ будет получена XML примерно такого содержания:

  	<RESPONSE>		
  	<status>status_code</status>		
  	<price></price>		
  	</RESPONSE>
СтатусЗначениеОписание
AUTH_FAILED-1Неправильный логин и/или пароль
ОК0Запрос верный
XML_ERROR-2Неправильный формат XML

В параметре <price> будет установлена цена 1 кредита в долларах США.

Пример использования API на языке программирования PHP. Подробно

Я редко провожу емейл кампании, поэтому не вижу смысла покупать отдельный софт. А вот Email Service – это именно то, что нужно. Тем более, что для моих рассылок хватает бесплатного тарифа, а за дополнительные письма можно доплатить символическую сумму, не покупая большие и ненужные мне тарифные пакеты. Спасибо компании за такое решение! Читать далее »
Ярмоленко Владислава Сергеевна, маркетолог
Решил попробовать свои силы в интернет-бизнесе. Сразу скажу, что в работе с компьютером сын часто в шутку называет меня "чайником", и в этом определенно есть доля правды. Когда возник вопрос о привлечении новых клиентов в мой бизнес, я остановил свой выбор на e-mail рассылках в качестве оптимального инструментария. Перепробовал много софта, долго не мог разобраться с различными настройками отправки, SMTP серверами и прочим функционалом. Как-то сын пришел и предложил мне работать с вашим онлайн сервисом. Вот оно! Я разобрался в нем буквально за 10 минут. Никаких дополнительных и заумных настроек: загрузил списки получателей – создал письмо – отправил рассылку. Автоматически. Все! Я очень доволен. Читать далее »
Кирилл Романович
Попробуйте ePochta Mail Service уже сегодня!

 

Активируйте учетную запись и получите тарифный план «Бесплатно».
Отправляйте до 3500 электронных сообщений в месяц на более чем 200 адресов!

Нажмите кнопку «Скачать» и затем «Сохранить» в диалоговом окне. Загрузка произойдет автоматически