Сервис для отправки sms API
Нравится+1
Просмотров340
Поделиться
Дата обновления: 06.03.2024
Обмен текстовыми сообщениями стал проще. Отправляйте и получайте текстовые сообщения с помощью нашего стандартизированного SMS API и взаимодействуйте со своими клиентами по всему миру.
Содержание
- Как работает SMS API?
- Параметры для отправки СМС
- Статусы СМС-сообщений
Обмен текстовыми сообщениями стал проще. Отправляйте и получайте текстовые сообщения с помощью нашего стандартизированного SMS API и взаимодействуйте со своими клиентами по всему миру.
Наш API для отправки и получения ваших текстовых сообщений:
- безопасный,
- надежный,
- программируемый.
Как работает SMS API?
Интерфейс прикладного программирования (API) — это программный посредник, который позволяет двум приложениям взаимодействовать друг с другом, делая функции одной компьютерной программы доступными для другой компьютерной программы. Сам API — это программный код, который позволяет двум программным продуктам передавать данные между собой. SMS API позволяет автоматизировать отправку текстовых сообщений без вмешательства человека.
Возможны различные варианты интеграции сервиса смс-рассылок (автоматизации) с вашим сайтом или программой:
- Оповещение клиента о приближающемся событии. О визите к врачу, готовности заказа и прочее.
- Реализация процесса отправки уведомлений клиенту сразу после регистрации на Вашем сайте. Сообщение с логином и паролем, например.
- Напоминание об истечении срока оплаты. К примеру, о необходимости продления абонемента или совершения платежа интернет-провайдеру.
- Информирование потребителя о рекламных акциях, открытии новых точек продаж и скидочных предложениях, о внедрении новой услуги.
- Отправка уведомлений о предстоящих общественных мероприятиях, ухудшении погодных условий, необходимости оплаты налогов, пошлин. Наиболее часто используют такое оповещение государственные организации.
- Поздравления с персональными и общественными праздниками. Как еще один способ повысить лояльность клиентов, напомнить о себе.
API позволяет автоматизировать мгновенную или отложенную отправку SMS непосредственно из вашего приложения, сайта, интернет-магазина, отраслевого программного обеспечения. Воспользуйтесь нашим гибким API-решением и интегрируйте обмен SMS-сообщениями в свой бизнес. Наш стандартизированный интерфейс позволяет быстро и легко подключаться к вашим приложениям и системам независимо от доступа к Интернету. Почти у каждого пользователя есть мобильный телефон, так что он всегда может получать и проверять текстовые сообщения.
Интегрировать сервис смс-рассылок можно практически в любое ваше ПО, CRM-систему, 1C и прочие продукты. Интерактивная система оценки качества работы сотрудников посредством смс-сообщений позволит вам всегда быть в курсе событий и знать насколько эффективны ваши работники. Автоматизация многих бизнес-процессов дает возможность освободить сотрудников от рутинных задач, а сэкономленное время и силы направить на другие цели, например рост продаж.
В сложных технических процессах немаловажную роль играет безопасность данных. Часто компании прибегают к отправке дополнительных сообщений с кодом доступа для входа в систему. Например, почтовые браузеры используют двухфакторную авторизацию.
SMS-рассылка через Интернет становится все более популярной среди компаний и позволяет отправлять сообщения с мобильных телефонов контактам компаний, независимо от того, находятся ли они в России или за рубежом, практически без задержек по времени. API-интерфейсы SMS используются для прямого взаимодействия с клиентами. Они могут охватить широкую аудиторию в кратчайшие сроки и особенно полезны для крупных компаний, которым необходимо распространять информацию среди большой аудитории за короткий промежуток времени.
SMS-рассылка — это самый быстрый и эффективный способ связаться с вашей базой данных и отправить сообщение на ваш мобильный телефон. Запросы, встроенные в их приложения, позволяют автоматически отправлять от отдельных SMS-сообщений до масштабных рекламных кампаний с тысячами сообщений. С помощью нашего API текстовые сообщения могут быть отправлены получателю непосредственно из ваших существующих систем. SMS-шлюз обрабатывает преобразование содержимого сообщения в формат SMS и подключается к локальной мобильной сети. Получателю не требуется никакого дополнительного программного обеспечения, и он получит сообщение по своему мобильному номеру.
Параметры для отправки СМС
Мы предлагаем две автоматизированные версии API:
MESSAGES REST V2
Передача сообщения
GET запрос на сервер, вида
http://api.prostor-sms.ru/messages/v2/send/?phone=%2B71234567890&text=test
Параметр | Описание | |
login | ✔ | Логин (на выбор: GET параметр или basic access authentication) |
password | ✔ | Пароль (на выбор: GET параметр или basic access authentication) |
phone | ✔ | Номер телефона, в формате +71234567890 |
text | ✔ | Текст сообщения, в UTF-8 кодировке |
sender | Подпись отправителя (например TEST) | |
scheduleTime | Дата для отложенной отправки сообщения, в UTC (2008-07-12T14:30:01Z) | |
statusQueueName | Название очереди статусов отправленных сообщений, в случае, если вы хотите использовать очередь статусов отправленных сообщений. От 3 до 16 символов, буквы и цифры (например myQueue1) |
При успешной авторизации, в ответ сервис должен вернуть plain/text ответ вида
accepted;A132571BC
где до знака «;» сервис выдает ответ сервиса о статусе сообщения, а после знака «;» идентификатор сообщения (A-F 0-9, макс. 72 симв.)
Параметр/значение | Описание |
accepted | Сообщение принято сервисом |
invalid mobile phone | Неверно задан номер тефона (формат +71234567890) |
text is empty | Отсутствует текст |
sender address invalid | Неверная (незарегистрированная) подпись отправителя |
wapurl invalid | Неправильный формат wap-push ссылки |
invalid schedule time format | Неверный формат даты отложенной отправки сообщения |
invalid status queue name | Неверное название очереди статусов сообщений |
not enough balance | Баланс пуст (проверьте баланс) |
Проверка состояния отправленного сообщения (до 200 id в запросе)
GET запрос на сервер, вида
http://api.prostor-sms.ru/messages/v2/status/?id=A132571BC&id=A132571BD&id=A132571BE
Параметр | Описание | |
login | ✔ | Логин (на выбор: GET параметр или basic access authentication) |
password | ✔ | Пароль (на выбор: GET параметр или basic access authentication) |
id | ✔ | Идентификатор сообщения, который вернул сервис при отправке сообщения |
При успешной авторизации, в ответ сервис должен вернуть plain/text ответ вида
- A132571BC;delivered
- A132571BD;smsc submit
- A132571BE;queued
где в каждой строке до запятой id запрашиваемого статуса, а после запятой ответ сервиса о статусе сообщения
Параметр/значение | Описание |
queued | Сообщение находится в очереди |
delivered | Сообщение доставлено |
delivery error | Ошибка доставки SMS (абонент в течение времени доставки находился вне зоны действия сети или номер абонента заблокирован) |
smsc submit | Сообщение доставлено в SMSC |
smsc reject | Сообщение отвергнуто SMSC (номер заблокирован или не существует) |
incorrect id | Неверный идентификатор сообщения |
Проверка очереди статусов отправленных сообщений
GET запрос на сервер, вида
http://api.prostor-sms.ru/messages/v2/statusQueue/?statusQueueName=myQueue1&limit=5
Параметр | Описание | |
login | ✔ | Логин (на выбор: GET параметр или basic access authentication) |
password | ✔ | Пароль (на выбор: GET параметр или basic access authentication) |
statusQueueName | ✔ | Название очереди статусов сообщений. Название очереди устанавливается при передаче сообщения |
limit | Количество запрашиваемых статусов из очереди (по умолчанию 1, макс. 1000) |
При успешной авторизации, в ответ сервис должен вернуть plain/text ответ вида<
- A132571BC;delivered
- A132571BD;smsc submit
- A132571BE;queued
где сервис возвращает по одному статусу в каждой строке (подробнее о статусах)
Параметр/значение | Описание |
queue is empty | Очередь пуста |
absent status queue name | absent status queue name |
invalid status queue name | invalid status queue name |
Проверка состояния счета
GET запрос на сервер, вида
http://api.prostor-sms.ru/messages/v2/balance/
Параметр | Описание | |
login | ✔ | Логин (на выбор: GET параметр или basic access authentication) |
password | ✔ | Логин (на выбор: GET параметр или basic access authentication) |
При успешной авторизации, в ответ сервис должен вернуть plain/text ответ вида
- RUB;540.15;0.0
- RUB;540.15;0.0
где в каждой строке 1 значение – тип баланса, 2 значение – баланс, 3 значение – кредит (возможность использовать сервис при отрицательном балансе)
Список доступных подписей отправителя
GET запрос на сервер, вида
http://api.prostor-sms.ru/messages/v2/senders/
Параметр | Описание | |
login | ✔ | Логин (на выбор: GET параметр или basic access authentication) |
password | ✔ | Пароль (на выбор: GET параметр или basic access authentication) |
Пароль (на выбор: GET параметр или basic access authentication)
- MyBrand;active;
- 3132018;pending;
- MegaFon;blocked;bad sender name;
- TEST;default;
где в каждой строке 1 значение – имя подписи, 2 значение – статус, 3 значение – примечание
Параметр/значение | Описание |
active | Подпись активирована и готова к использованию |
new | Новая подпись |
pending | Подпись в процессе активации |
blocked | Подпись заблокирована |
default | Подпись заблокирована |
Проверка активной версии API
GET запрос
http://api.prostor-sms.ru/messages/v2/version/
Параметр | Описание | |
login | ✔ | Логин (на выбор: GET параметр или basic access authentication) |
password | ✔ | Логин (на выбор: GET параметр или basic access authentication) |
Пароль (на выбор: GET параметр или basic access authentication)
2
Пароль (на выбор: GET параметр или basic access authentication)
MESSAGES JSON V2
Передача сообщения (до 200 сообщений в запросе)
POST запрос
http://api.prostor-sms.ru/messages/v2/send.json
- {
- scheduleTime": "2008-07-12T14:30:01Z",
- messages": [
- {
- phone": "71234567890",
- sender": "MySender",
- clientId": "1",
- text": "Message text here"
- },
- {
- phone": "71234567891",
- clientId": "2",
- text": "text"
- },
- {
- phone": "71234567892",
- sender": "MySender",
- clientId": "3",
- text": "Message text here"
- }
- {
- ],
- statusQueueName": "myQueue",
- showBillingDetails": true,
- login": "login",
- password": "password"
- }
Параметр | Описание | |
login | ✔ | Логин |
password | ✔ | Пароль |
scheduleTime | Дата для отложенной отправки сообщения, в UTC (2008-07-12T14:30:01Z) | |
statusQueueName | Название очереди статусов отправленных сообщений, в случае, если вы хотите использовать очередь статусов отправленных сообщений. От 3 до 16 символов, буквы и цифры (например myQueue1) | |
showBillingDetails | Включение в ответ биллинговых данных: баланса, количества SMS в сообщении, стоимость сообщения | |
clientId | ✔ | Включение в ответ биллинговых данных: баланса, количества SMS в сообщении, стоимость сообщения |
phone | ✔ | Номер телефона, в формате +71234567890 |
text | ✔ | Текст сообщения, в UTF-8 кодировке |
sender | Подпись отправителя (например TEST) |
При успешной авторизации сервер должен вернуть json ответ вида
- {
- "status": "ok",
- "balance": [],
- "messages": [
- {
- "status": "accepted",
- "smscId": "12345",
- "clientId": "1"
- },
- {
- "status": "sender address invalid",
- "smscId": "12346",
- "clientId": "2"
- }
- {
- ]
- }
где сервис выдает результаты обработки сообщений
Параметр/значение | Описание |
status | Статус приема пакета (ok – ошибок не обнаружено) |
clientId | Id сообщения на стороне клиента |
smscId | Id сообщения на стороне сервера (A-F 0-9, макс. 72 симв.) |
status (в messages) | Статус отправки сообщения (подробнее о статусах в описании REST интерфейса) |
smsCount | Количество SMS в сообщении |
msgCost | Стоимость сообщения (тариф умноженный на количество SMS). Отображается, если клиент использует рублевый баланс |
balance | Остатки средств на балансе, после отправки сообщений |
Проверка состояния отправленных сообщений (до 200 сообщений в запросе)
POST запрос
http://api.prostor-sms.ru/messages/v2/status.json
- {
- "login": "login",
- "password": "password",
- "messages": [
- {
- "smscId": "12345",
- "clientId": "1"
- },
- {
- "smscId": "12346"
- }
- {
- ]
- }
Параметр | Описание | |
login | ✔ | Логин |
password | ✔ | Пароль |
smscId | ✔ | Id сообщения на стороне сервера |
clientId | Id сообщения на стороне клиента |
При успешной авторизации сервер должен вернуть json ответ вида
- {
- "status": "ok/error",
- "messages": [
- {
- "status": "delivered",
- "smscId": "12345",
- "clientId": "1"
- },
- {
- "status": "smsc reject",
- "smscId": "12346"
- }
- {
- ]
- }
где сервис выдает статусы сообщений
Параметр/значение | Описание |
status | Статус приема пакета (ok – ошибок не обнаружено) |
smscId | Id сообщения на стороне сервера |
clientId | Id сообщения на стороне сервера |
status (в messages) | Id сообщения на стороне сервера |
Проверка очереди статусов сообщений (до 1000 сообщений в запросе)
POST запрос
http://api.prostor-sms.ru/messages/v2/statusQueue.json
- {
- "login": "login",
- "login": "login",
- "statusQueueLimit": "100",
- "statusQueueName": "myQueue"
- }
Параметр | Описание | |
login | ✔ | Логин |
password | ✔ | Пароль |
statusQueueName | ✔ | Название очереди статусов сообщений. Название очереди устанавливается при передаче сообщения |
statusQueueLimit | ✔ | Количество запрашиваемых статусов из очереди (по умолчанию 1, макс. 1000) |
При успешной авторизации сервер должен вернуть json ответ вида
- {
- "status": "ok/error",
- "messages": [
- {
- "status": "delivered",
- "smscId": "12345"
- },
- {
- "status": "smsc reject",
- "smscId": "12346"
- }
- {
- ]
- }
где сервис выдает статусы сообщений
Параметр/значение | Описание |
status | Статус приема пакета (ok – ошибок не обнаружено) |
smscId | Id сообщения на стороне сервера |
status (в messages) | Статус отправленного сообщения (подробнее о статусах в описании REST интерфейса) |
Проверка состояния счета
POST запрос
http://api.prostor-sms.ru/messages/v2/balance.json
- {
- "login": "login",
- "password": "password"
- }
Параметр | Описание | |
login | ✔ | Логин |
password | ✔ | Пароль |
При успешной авторизации сервер должен вернуть json ответ вида
- {
- "status": "ok/error",
- "balance": [
- {
- "credit": 0.0,
- "balance": "0.00",
- "balance": "0.00",
- },
- {
- "credit": 1000000,
- "balance": -508784,
- "type": "SMS"
- }
- {
- ]
- }
где сервис выдает информацию о балансах клиента: типе баланса, количестве и возможном кредите (возможности использовать сервис при отрицательном балансе)
Параметр/значение | Описание |
status | Статус приема пакета (ok – ошибок не обнаружено) |
type | Тип баланса: RUB, SMS |
balance | Количество средств на балансе |
credit | Кредит (возможность использовать сервис при отрицательном балансе) |
Список доступных подписей отправителя
POST запрос
http://api.prostor-sms.ru/messages/v2/senders.json
- {
- "login": "login",
- "password": "password"
- }
Параметр | Описание | |
login | ✔ | Логин |
password | ✔ | Пароль |
- {
- "status": "ok/error",
- "senders": [
- {
- "status": "active",
- "info": "",
- "name": "MyBrand"
- },
- {
- "status": "pending",
- "info": "",
- "name": "3132018"
- },
- {
- "status": "blocked",
- "info": "bad name",
- "name": "MegaFon"
- },
- {
- "status": "default",
- "info": "",
- "name": "TEST"
- }
- {
- ]
- }
где сервис выдает информацию о подписях отправителя
Параметр/значение | Описание |
status | Статус приема пакета (ok – ошибок не обнаружено) |
senders | Список доступных подписей |
active | Подпись активирована и готова к использованию |
new | Новая подпись |
pending | Подпись в процессе активации |
blocked | Подпись заблокирована |
default | Подпись по умолчанию, готова к использованию |
Проверка активной версии API
POST запрос
http://api.prostor-sms.ru/messages/v2/version.json/
- {
- "login": "login",
- "password": "password"
- }
Параметр | Описание | |
login | ✔ | Логин (на выбор: GET параметр или basic access authentication) |
password | ✔ | Пароль (на выбор: GET параметр или basic access authentication) |
При успешной авторизации сервер должен вернуть json ответ вида
- {
- "status": "ok/error",
- "version": 2
- }
Параметр/значение | Описание |
status | Статус приема пакета (ok – ошибок не обнаружено) |
version | Номер активной версии API |
Возможности сервиса
Отправляйте отдельные сообщения или массовые рассылки и оценивайте влияние своих кампаний. Следите за историей и подробностями всего за несколько кликов благодаря нашему сервису. После создания учетной записи вам предоставляется возможность создавать ключи API, которые применяются только к вашей учетной записи. Ключи содержат информацию, которая обеспечивает доступ к нашему API и позволяет отправлять SMS-сообщения через вашу учетную запись из приложения, в которое вставлены ключи. По этой причине ключи API должны быть строго конфиденциальными, как и пароли.
Отправьте SMS-кампанию и персонализируйте сообщение, настроив отправителя и содержание. Вы также можете включить ссылку. Создавайте рассылки, отменяйте свои неотправленные кампании и получайте квитанции о получении. API SMS позволяет вашим разработчикам интегрировать функцию отправки SMS-сообщений в ваш сайт, приложения, или даже программное обеспечение всего за несколько кликов.
- Импортируйте свой список контактов напрямую с помощью SMS API. Контакты легко удалить, изменить или проверить на наличие дубликатов.
- Создавайте и управляйте своей учетной записью и вспомогательными учетными записями с помощью единой платформы и просто проверяйте свой баланс.
- Пройдите простую аутентификацию в нашем SMS API благодаря нашему токену API. Оптимально управляйте своими токенами и входите в систему безопасным способом.
- Автоматизируйте отправку текстового сообщения с подтверждением, чтобы завершить процесс регистрации или подтвердить заказ, размещенный на вашем веб-сайте или в приложении.
- Установите напоминания для своих клиентов, такие как напоминание о вакцинации, техническом осмотре транспортного средства, процедуре, которая требует обновления.
Текстовые сообщения имеют решающее преимущество перед электронной почтой: они с высокой вероятностью будут открыты получателем.
Общайтесь со своими клиентами с помощью текстовых сообщений и информируйте свою целевую аудиторию о новых продуктах с помощью SMS-маркетинга.Собирайте и отправляйте текстовые сообщения, чтобы узнать мнение своих клиентов. Получайте важные аналитические данные благодаря высокому количеству открытий и ответов на текстовые сообщения.
Выигрывайте время с помощью наших веб-справочников, например, напрямую получая уведомления и информацию о подтверждениях получения ваших SMS-кампаний. Скорость открытия текстовых сообщений составляет 98% — 90% открытий происходит в течение первых трех минут.
Статусы СМС-сообщений
В зависимости от типа API При успешной авторизации, в ответ сервис должен вернуть plain/text ответ вида:
- A132571BC;delivered
- A132571BD;smsc submit
- A132571BE;queued
где в каждой строке до запятой id запрашиваемого статуса, а после ответ сервиса:
Параметр/значение | Описание |
queued | Сообщение находится в очереди |
delivered | Сообщение доставлено |
delivery error | Ошибка доставки SMS (абонент в течение времени доставки находился вне зоны действия сети или номер абонента заблокирован) |
smsc submit | Сообщение доставлено в SMSC |
smsc reject | Сообщение отвергнуто SMSC (номер заблокирован или не существует) |
incorrect id | Неверный идентификатор сообщения |
Параметр/значение | Описание |
status | Статус приема пакета (ok – ошибок не обнаружено) |
clientId | Id сообщения на стороне клиента |
smscId | Id сообщения на стороне сервера (A-F 0-9, макс. 72 симв.) |
status (в messages) | Статус отправки сообщения (подробнее о статусах в описании REST интерфейса) |
Любое сообщение получает окончательный статус не позднее чем через сутки после отправки.
Управление списками для рассылок
Чтобы управлять списками для рассылок, необходимо запросить скрипт.
Скачать программу для рассылки СМС бесплатно!
Программный комплекс предназначен для безопасной смс рассылки. Программа использует модули шифрования, сертифицированные в ФСБ России, и полностью исключает возможную утечку клиентской базы.
Почему стоит выбрать нас?
Простота установки | Подробная документация | Лучшая техподдержка |
Наш интерфейс предоставит вам легкий доступ к примерам кода на многих языках и большому количеству функций. | Онлайн-документация по SMS API доступна для просмотра в любое время и регулярно обновляется. | С нашими разработчиками можно связаться в чате или по телефону, чтобы они ответили на все ваши вопросы по SMS API. |
Контроль данных | Персонализированные текстовые сообщения | Двухфакторная аутентификация |
Наша система позволяет вам определять продолжительность хранения ваших данных, даже с помощью API. | Отправьте SMS-кампанию и персонализируйте сообщение, настроив отправителя и содержание. Вы также можете включить ссылку. Имитируйте рассылки, отменяйте свои неотправленные кампании и получайте квитанции о получении. | Защитите вашу личную информацию и данные ваших клиентов с помощью двухфакторной аутентификации с помощью текстовых сообщений, также называемой 2FA. |
Расширьте свое общение с помощью SMS-канала и общайтесь со своими клиентами по всему миру. Благодаря обмену текстовыми сообщениями вы получаете максимальный охват и открываемость более 90%. Интегрируйте наш SMS API в свои приложения и отправляйте мгновенные уведомления с использованием одноразовых паролей (OTP), 2FA, маркетинговых сообщений и многого другого быстро и легко в виде коротких сообщений.
Стоимость услуги
Мы предлагаем воспользоваться нашим SMS API по низким ценам без фиксированной абонентской платы. Вы пополняете баланс, а средства с него списываются только за отправленные сообщения.
У нас выгодные условия на SMS-рассылки по России и всему миру. Сделайте ставку на SMS-маркетинг и отправляйте предложения и новости о продуктах прямо на смартфоны ваших пользователей с помощью текстовых сообщений.