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

Запуск сервиса

Для запуска сервиса отправки сообщений в рамках протокола HTTP партнеру необходимо получить реквизиты доступа к API:

• serviceId – уникальный идентификатор сервиса;

• pass – пароль.

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

GET https://api.seven.tech/send

Метод позволяет инициировать отправку сообщения с указанием номера абонента, текста и имени отправителя.

Path Parameters

Name	Type	Description
clientId	integer	Номер абонента в международном формате. Пример 79031234567
message	string	Сообщение для отправки абоненту в кодировке UTF-8 (urlencoded)
serviceId	integer	Идентификатор сервиса от которого происходит отправка сообщений
pass	string	Пароль для отправки сообщений. Пароль заводится при подключении сервиса и передается партнеру
source	string	Имя отправителя. Сообщение абоненту будет отправлено с номера, указанного в данном параметре. Допустимая длина 2-11 символов. Допустимые символы: 0...9a...zA...Z!@#$%^&*()/{}';:,+-_ и пробел.
ptag	string	Признак сообщения в системе партнера. Максимальная длина: 50 символов; допустимые символы: 0...9a...zA...Z-
sending_time	string	Локальное время отправки сообщения абоненту. Задается в формате HH_HH
time_zone	string	Часовой пояс абонента. Задается в формате ±hh:mm
flash	integer	Признак отправки Flash-SMS. При flash=1 абоненту будет оправлено Flash-SMS
ttl	integer	Время жизни сообщения (TTL) между элементами каскада. (значение в секундах) Допустимые интервалы от 100 до 86400.

200 Успешная обработка запроса. В теле ответа передаётся идентификатор принимающей стороны. Действий не требуется

OK
12345678

400 Отсутствуют обязательные параметры или заданы некорректного значения параметров. Например, параметр message не задан или значение параметра serviceId содержит буквы. Необходимо исключить возможные ошибки и повторить запрос. При невозможности разрешить проблему своими силами, обратиться в техническую поддержку

Message body required

401 Передано неверное сочетание параметров serviceId/pass. Можно повторить запрос с правильным сочетанием serviceId/pass.

wrong password passme123 for service with id=65535

402 Исчерпан остаток оплаченных сообщений (для партнеров, работающих по предоплате). Не следует повторять запрос. Необходимо внести предоплату и обратиться к аккаунт-менеджеру.

Exceeded limit MT

403 Выполнен запрос с IP-адреса не добавленого в список разрешенных. Частный случай данной ошибки — сервис с переданным serviceId отсутствует или не активен. Не повторять запрос. Обратиться в техническую поддержку.

Forbidden

406 Невозможно отправить сообщение абоненту с переданным clientId. Как правило, ошибка указывает на невалидный номер абонента.

wrong clientId '79031234567' for pattern '^7[34589]\d{9}$(?<!(7940\d{7}))'

408 Превышение допустимой скорости отправки сообщений. Повторить запрос, не превышая допустимой скорости.

speed exceed for serviceId=65535 max request speed is 300/sec

409 Признак срабатывания функционала Защиты от дубликатов. При необходимости, обратиться в техническую поддержку за дополнительными разъяснениями.

such message already has been sent

414 Превышение допустимой длины (1000 символов) текста сообщения, переданного в параметре message. Необходимо сократить длину отправляемого сообщений не превышая лимит в 1000 символов и повторить отправку.

so long message

423 Отправка сообщений абоненту с переданным clientId отключена за фрод. Выдержать паузу минимум 1 час и повторить запрос.

500 Внутренняя ошибка сервера.Технические проблемы платформы. Выдержать паузу минимум 1 минуту и повторить запрос. При повторении ошибки более 10 раз прекратить передачу запроса. Сообщить о проблеме в техническую поддержку.

System error

503 Запрос в обработке. Выдержать паузу и подождать ответ на первый запрос с переданным значением partnerMsgId. Допускается повторить запрос, если не получен ответ на первый.

Request processing is unavailable

Примеры вызова

Отправка сообщения в латинице

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 несколько раз. При этом: Отправка сообщения абоненту будет выполнена только один раз (по первому запросу); В ответах на запросы Агрегатор вернет Контент-провайдеру один тот же идентификатор сообщения в системе Агрегатора (тот же, что на первый запрос).