/ API-интеграции

API для отправки СМС и сервисных уведомлений

Отправка SMS из вашего сайта или CRM
Статусы сообщений и баланс в вашей системе
Дарим 100 рублей на счёт для тестирования сервиса
Попробовать бесплатно
Документация API и способы подключения
Возможности SMS API

Что можно делать через API

Отправлять SMS

Ваш проект передаёт сервису получателя и текст. Начать можно с JSON-образца на этой странице.
Отправка по JSON API

Проверять доставку

После отправки сохраните ID. С ним вы сможете узнать, дошло ли конкретное сообщение до абонента.
Проверка статуса

Получать баланс

Остаток на счёте доступен отдельным запросом. Его можно включить в проверку перед рабочей рассылкой.
Запрос баланса
Рассчитайте стоимость
Укажите количество номеров
5000
Стоимость, ₽
от 7500
Клиентов получите
~175
Попробовать бесплатно Стоимость сообщения зависит от многих параметров
После регистрации будет начислено 100 рублей для тестов
Первое подключение

Как отправить SMS через API

01

Сверьте доступ и отправителя

Откройте настройки API в кабинете. Для примера JSON ниже понадобятся логин, пароль и имя отправителя, которое вы согласовали с сервисом.
02

Откройте нужное руководство

В примере на этой странице используется JSON POST. Если подключаетесь через HTTP(S) GET, берите параметры из инструкции именно для него.
03

Проведите первую отправку

Замените данные в примере и укажите свой телефон. В ответе найдите ID: он понадобится дальше. Если сервер сообщил об ошибке, сначала устраните её.
04

Узнайте, доставлено ли SMS

Используйте сохранённый ID в запросе статуса. Сравните ответ сервиса с тем, что получили на телефоне, прежде чем запускать рассылку клиентам.
Попробовать бесплатно
Быстрый старт

Пример отправки SMS в JSON

Начните с одного SMS на свой телефон. В образце оставлены заглушки: без ваших данных он не готов к отправке. Если нужно добавить получателей или другие параметры, сверьтесь с руководством JSON API.

Тело запроса

POST https://sms.targetsms.ru/sendsmsjson.php
Content-Type: application/json; charset=utf-8

{
  "security": {
    "login": "YOUR_LOGIN",
    "password": "YOUR_API_PASSWORD"
  },
  "type": "sms",
  "message": [
    {
      "type": "sms",
      "sender": "YOUR_SENDER",
      "text": "Проверка подключения API",
      "abonent": [
        {
          "phone": "RECIPIENT_PHONE",
          "number_sms": "1"
        }
      ]
    }
  ]
}

Как прочитать ответ

Это иллюстрация ответа, реальную отправку мы здесь не выполняем. Значение EXAMPLE_SMS_ID обозначает ID, который вы получите от сервера.

{
  "sms": [
    {
      "number_sms": "1",
      "id_sms": "EXAMPLE_SMS_ID",
      "parts": "1",
      "action": "send"
    }
  ]
}

Сначала прочитайте action. Если отправка завершилась ошибкой, её описание будет в этом поле, а id_sms вы не получите.

Наличие ID говорит о том, что можно проверить дальнейшую судьбу сообщения. Для этого в новом JSON укажите type: "state", а ID передайте внутри массива get_state. Доставку узнают из отдельного ответа, не из ID.

Проверка статуса по JSON API

security
Заполните login и password своими данными доступа к API.
sender и text
В sender впишите согласованного отправителя, в text поместите текст, который должен получить абонент.
phone и number_sms
Вместо RECIPIENT_PHONE укажите телефон в международном формате, например 79001234567 для России. Поле number_sms нумерует сообщения в текущем JSON; с ID сервера его путать не следует.

Рекомендуем обращаться к API с серверной части вашего проекта. Так пароль не попадёт в код, доступный посетителю в браузере.

Перед запуском

Что проверить, если SMS не отправляется

Не отправляйте тот же запрос снова, не прочитав ответ. Сначала определите, что произошло: сервер отказал в доступе, отклонил отправку или SMS осталось без доставки.

  • При ошибке доступа заново сверьте учётные данные API. Затем проверьте, что отправляете документ в нужном формате.
  • Если проблема с отправителем, посмотрите его написание в кабинете. Для отправки также нужны средства на счёте.
  • Проверьте получателя: правильно ли записан телефон, нет ли его в стоп-листе.
  • Если сервер выдал ID, переходите к проверке статуса, а не считайте SMS уже доставленным.

Разбор типовых проблем при отправке по API

Тестирование и стоимость

Новому аккаунту начисляется 100 рублей, чтобы попробовать сервис. Когда планируете рабочую рассылку, рассчитывайте бюджет по действующим тарифам, а не по размеру тестового начисления.

Начать лучше со своего телефона: так вы увидите текст SMS и сможете сопоставить его получение со статусом в API.

Помощь с подключением

Вопросы об API-интеграции для SMS

Какие данные нужны для доступа к API?

Для JSON заполните login и password внутри security. В HTTP(S) GET им соответствуют user и pwd. Поэтому сначала выберите интерфейс, затем проверьте учётные данные API в кабинете и используйте его руководство.

Где найти подходящую документацию?

Нажмите на название интерфейса в библиотеке: за каждой ссылкой своё руководство. PHP ведёт к скриптам, JSON и XML описывают обмен документами. Условия SMPP и модули для CRM вынесены в отдельные разделы.

Можно ли протестировать отправку SMS через API?

Да. После регистрации на счёт начисляется 100 рублей для тестирования сервиса.

Как убедиться, что сообщение доставлено?

Получив ID, сделайте запрос статуса с этим идентификатором. Для JSON ответ deliver подтверждает доставку абоненту. Если вы только получили ID при отправке, результата доставки у вас ещё нет.
Не разобрались в документации? Обратитесь в техподдержку
Выберите способ, как с вами связаться
Отправить
Какие СМС можно отправлять через наш сервис

Сообщения на все случаи жизни

Суши-роллы
Роллы с тунцом со скидкой 30% только сегодня! Ул. Гурьева, 15. Ждем с 12:00 до 23:00 10:12

Рекламные СМС

Сообщения об акциях, скидках, мероприятиях, новых продуктах или услугах.
Marketplace
За ваш заказ 064651-562 вы заработали 78 бонусов от продавца COSMETICA 17:27

Сервисные уведомления

Сообщения о статусе заказов, бронировании и других сервисных процессов.
LEO-Bank
Пополнение. Счёт RUB. 12943 RUB. Др.банк. Доступно 36285, 89 RUB 12:43

Транзакционные СМС

Сообщения о подтверждении платежей, уведомления о списании средств или пополнении счета.
History-school
Код подтверждения: 4162. Вход в личный кабинет History-school.online 19:02

Авторизационные СМС

Одноразовые пароли или коды для авторизации, подтверждения действий или входа в систему.
Гард-страхование
Арсений Сергеевич, не забудьте продлить полис ОСАГО SYS2608606881 16:41

Информационные смс

Напоминание о записи, платежах, изменение графика работы, о сбоях в работе, о погоде.
ПЛК-банк
Оцените нашего сотрудника во время разговора по ссылке clck.ru/3RYB65 14:10

Опросы

Сбор отзывов, оценки или мнения клиентов для улучшения услуг или продуктов.
Кто уже увеличивает прибыль с TargetSMS
Отраслевые решения

Какому бизнесу подходят СМС-рассылки

Торговля

Оповещение о статусе заказа
Информируйте о новых товарах
Рассказывайте об акциях и скидках
Упрощение регистрации в программе лояльности
Поздравляйте с днем рождения
Оценка качества работы

Онлайн-платформы

Подтверждение регистрации по СМС
Напоминание об оплате
Рассказывайте об акциях и скидках
Информируйте о новых продуктах и возможностях сервиса
Поздравление с днем рождения
Оценка качества работы

Рестораны

Информируйте о новых блюдах и изменениях в меню
Привлекайте клиентов SMS-акциями по собственной базе
Рассказывайте об акциях и скидках
Поздравление с днем рождения
Оценка качества работы

Сфера обслуживания

Напоминание клиентам о записи
Информируйте о новых услугах
Делайте догоняющую рассылку
Рассказывайте об акциях и скидках
Поздравление клиентов с днем рождения
Оценка качества работы

Медицина

Напоминание клиентам о записи
Напоминание об оплате
Информируйте о новых услугах
Рассказывайте об акциях и скидках
Поздравление клиентов с днем рождения
Оценка качества работы

Банки, госуслуги

Транзакционные сообщения
Регистрация для онлайн-банкинга
Информируйте о статусе оказания услуги
Рассказывайте об акциях и скидках
Поздравление клиентов с днем рождения
Оценка качества работы
Начните отправлять СМС уже сегодня!
100 рублей уже будут на балансе после регистрации
Попробовать бесплатно
Отзывы наших клиентов
Что говорят о нас на крупных платформах
4,9
5,0
5,0
Анатолий Шепелев
Анатолий Шепелев Коммерческий директор ООО “Вымпел”
“Мы провели SMS-рассылку от TargetSMS с гео-таргетингом по заданному району (между двумя станциями метро) в начале учебного года.
Адаптировали некоторые шаблоны из блога компании. В нашем бизнесе клиенты приходят надолго, поэтому затраты на рекламу окупаются – это очень выгодный способ привлечения новых учеников.
Сотрудничеством с TargetSMS довольны, покупатели были реальные – не боты. Рекомендуем знакомым!”
Читать отзыв
Константин Повелик
Константин Повелик Глава компании “Ресто-групп”
“С сервисом TargetSMS мы работаем уже более 3 лет, и за это время SMS-рассылки стали для нас не просто инструментом, а ключевым каналом коммуникации с гостями.
Быстро интегрировали с нашей CRM — все процессы автоматизированы, включая бронирование и напоминания.
Отдельно отмечу поддержку 24/7. Когда нам срочно нужно было запустить новогоднюю акцию, техотдел TargetSMS помог настроить рассылку за 1 час”
Читать отзыв
Кейсы наших клиентов

Как рассылки увеличивают продажи

Только сегодня 2 пиццы по цене одной!

Доставим за 20 минут.

Сделать заказ Lapizza.ru 12:43
отправлено сообщений 9 823
прочитано сообщений 8 444
перехода по ссылке 3 123
добавлений в корзину 820
оформлено заказов 440

Топ-5 ошибок в СМС-рассылках и как их избежать

Узнайте, как повысить эффективность ваших СМС-сообщений
Читать в блоге

Законодательство об СМС-рассылках

Регулирующие СМС-рассылки законы
Читать в блоге

Составляющие успешной СМС-рассылки

Рекомендации по успешной работе с СМС-рассылками
Читать в блоге
Нужно больше возможностей?
Попробуйте другие наши решения
Остались вопросы? Свяжемся с вами и всё расскажем!
Выберите способ, как с вами связаться
Отправить