Отправка сообщений

Запуск сервиса
Для запуска сервиса отправки сообщений в рамках протокола HTTP партнеру необходимо получить реквизиты доступа к API:
serviceId – уникальный идентификатор сервиса;
pass – пароль.
get
https://api.seven.tech
/send
Отправка сообщения
Примеры вызова
Отправка сообщения в латинице
https://api.seven.tech/send?serviceId=65535&pass=passme123&clientId=79031234567&source=North&message=With+such+love+as+this+now
Абоненту 79031234567 на мобильное устройcтво от имени North поступит сообщение с текстом:
With such love as this now
Отправка сообщения в кириллице
https://api.seven.tech/send?serviceId=65535&pass=passme123&clientId=79031234567&source=South&message=%d0%92+%d1%87%d0%b0%d1%89%d0%b0%d1%85+%d1%8e%d0%b3%d0%b0+%d0%b6%d0%b8%d0%bb+%d0%b1%d1%8b+%d1%86%d0%b8%d1%82%d1%80%d1%83%d1%81%3f+%d0%94%d0%b0%2c+%d0%bd%d0%be+%d1%84%d0%b0%d0%bb%d1%8c%d1%88%d0%b8%d0%b2%d1%8b%d0%b9+%d1%8d%d0%ba%d0%b7%d0%b5%d0%bc%d0%bf%d0%bb%d1%8f%d1%80%d1%8a!  
Абоненту 79031234567 на мобильное устройcтво от имени South поступит сообщение с текстом:
В чащах юга жил бы цитрус? Да, но фальшивый экземпляръ!
Дополнительная информация параметрам
Параметр
Пояснение
message
Если длина сообщения для отправки абоненту превышает 160 символов в кодировке 8859-1 или 140 байт, то сообщение должно быть передано целиком, в склеенном (полном) виде. При отправке абоненту будет происходить нарезка на несколько сообщений.
source
Как правило, на подключении выделяется согласованный набор имен отправителей с которых разрешена отправка сообщений. Возможность активация динамической подписи необходимо согласовать с аккаунт-менеджером. 

Возможно изменение настройки сервиса, когда партнер не передает в запросе данный параметр и при отправке сообщений будет использовано имя отправителя по-умолчанию. Эта опция может быть интересна для партнеров использующих фиксированное имя отправителя.
ptag
Значением может быть любой идентификатор в системе партнера. Например, уникальный идентификатор сообщения или идентификатор подразделения, инициирующего запрос на отправку.

Принимающая сторона не контролирует значения, переданные в данном параметре (проверяет только на соответствие формату). В отличие от параметра partnerMsgId (описание параметра см. ниже), который нужен для контроля повторных отправок и дублирования.

Опционально возможно получения параметра ptag в рамках функционала возврата отчетов о доставке сообщений (описание функционала доступен ниже)
sending_time
Например, при значении параметра sending_time=10_20 сообщение будет отправлено в период с 10:00 до 20:00 по местному времени в часовом поясе абонента.
Часовой пояс абонента определяется не по фактическому местоположению абонента.
Если Контент-провайдер не передает параметр time_zone, то часовой пояс абонента определяется по номеру телефона.
Если Контент-провайдер передает в параметре time_zone часовой пояс, то сообщение будет отправлено абоненту по местному времени этого часового пояса.
time_zone
​Подробнее о формате 
partnerMsgId
Данный параметр нужен для контроля повторных отправок и дублирований.
Партнер может выполнить запрос на отправку сообщения с одним и тем же partnerMsgId несколько раз. При этом:
Отправка сообщения абоненту будет выполнена только один раз (по первому запросу);
В ответах на запросы Агрегатор вернет Контент-провайдеру один тот же идентификатор сообщения в системе Агрегатора (тот же, что на первый запрос).

Last modified 3yr ago

Параметр	Пояснение
message	Если длина сообщения для отправки абоненту превышает 160 символов в кодировке 8859-1 или 140 байт, то сообщение должно быть передано целиком, в склеенном (полном) виде. При отправке абоненту будет происходить нарезка на несколько сообщений.
source	Как правило, на подключении выделяется согласованный набор имен отправителей с которых разрешена отправка сообщений. Возможность активация динамической подписи необходимо согласовать с аккаунт-менеджером. Возможно изменение настройки сервиса, когда партнер не передает в запросе данный параметр и при отправке сообщений будет использовано имя отправителя по-умолчанию. Эта опция может быть интересна для партнеров использующих фиксированное имя отправителя.
ptag	Значением может быть любой идентификатор в системе партнера. Например, уникальный идентификатор сообщения или идентификатор подразделения, инициирующего запрос на отправку. Принимающая сторона не контролирует значения, переданные в данном параметре (проверяет только на соответствие формату). В отличие от параметра partnerMsgId (описание параметра см. ниже), который нужен для контроля повторных отправок и дублирования. Опционально возможно получения параметра ptag в рамках функционала возврата отчетов о доставке сообщений (описание функционала доступен ниже)
sending_time	Например, при значении параметра sending_time=10_20 сообщение будет отправлено в период с 10:00 до 20:00 по местному времени в часовом поясе абонента. Часовой пояс абонента определяется не по фактическому местоположению абонента. Если Контент-провайдер не передает параметр time_zone, то часовой пояс абонента определяется по номеру телефона. Если Контент-провайдер передает в параметре time_zone часовой пояс, то сообщение будет отправлено абоненту по местному времени этого часового пояса.
time_zone	Подробнее о формате
partnerMsgId	Данный параметр нужен для контроля повторных отправок и дублирований. Партнер может выполнить запрос на отправку сообщения с одним и тем же partnerMsgId несколько раз. При этом: Отправка сообщения абоненту будет выполнена только один раз (по первому запросу); В ответах на запросы Агрегатор вернет Контент-провайдеру один тот же идентификатор сообщения в системе Агрегатора (тот же, что на первый запрос).