API SMS

Формат номера телефона

Номер телефона абонента всегда должен передаваться в международном формате в виде : код_страны код_оператора номер_телефона (без ведущего знака «+») .

Если у абонента прямой городской номер (это касается только российских абонентов), у него должен быть также и второй номер в федеральном формате. В частности, московские абоненты Билайн имеют федеральный аналог своего номера с кодом 903, московские абоненты МТС — с кодом 985, московские абоненты МегаФон — с кодом 925. Прямые номера необходимо указывать с федеральным кодом, например, для абонентов московского МТС не 74951234567, а 79851234567. Если нет информации, какому оператору принадлежит прямой московский номер, можно указывать его с кодом 495. Нам известны большинство диапазонов прямых московских номеров и, как правило, мы можем сконвертировать номер в федеральный формат. В этом случае в журнале сообщений номер будет отображаться в федеральном формате. В отчёте о доставке, переданном через любой из предоставляемых нами протоколов, номер телефона так же будет в федеральном формате.

Адрес отправителя

При отправке СМС в качестве адреса отправителя можно подставить число или альфанумерическую (буквенно-цифровую) последовательность. При этом максимальная длина числового отправителя ограничена 15 цифрами, а альфанумерического - 11 символами. Это ограничение стандарта GSM. В сетях других стандартов могут быть другие ограничения. Например, в CDMA альфанумерические отправители недоступны.

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

Большинство операторов создают и используют чёрные списки имён отправителей. В них заносятся имена, замеченные в спам-рассылках, мошенничестве и иных нарушениях, предусмотренных законодательством страны. У SMS Traffic тоже есть подобный список. Как и чёрные списки операторов, наш список не публикуется и не предоставляется по запросу, так как является коммерческой тайной организации.

Если в сеть оператора поступает сообщение с именем, не подходящим под налагаемые ограничения, наиболее типичная реакция — отказ в передаче (хотя все зависит от конкретного оператора, а в некоторых случаях - даже от настроек каждого отдельного СМС-центра в пределах одного оператора). У зарубежных операторов встречается практика передачи ложно-положительных статусов доставки.

Формально, в адресе отправителя можно использовать любой символ из основной таблицы кодировки «default GSM alphabet» (см. GSM 03.38). При этом, если в тексте встречаются символы из расширенной таблицы, они будут заменены на нашей стороне на похожие по начертанию символы из основной таблицы.
Некоторые СМС-центры и мобильные телефоны поддерживают не весь диапазон символов GSM кодировки в имени отправителя. Поэтому мы рекомендуем пользоваться символами из набора: "A-Z", "a-z", "0-9", "-", "_", ".".

Надёжность и отказоустойчивость

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

Для SOAP протокола адрес дублирующего сервера прописан в WSDL.

Для SMTP протоколов все запасные сервера прописаны в MX записях соответствующих протоколам доменов. Согласно спецификации SMTP, распределение трафика между MX серверами происходит автоматически и, как правило, производить дополнительные настройки для обеспечения отказоустойчивости не нужно.

HTTP API v2 (JSON + API Key)

В версии HTTP API v2 используется современный формат обмена данными JSON и авторизация по ключу API Key, который передаётся в HTTP-заголовке Authorization: Bearer <API_KEY>. Тело запроса (при наличии) и ответы сервера передаются в формате JSON с кодировкой UTF-8. При отправке запросов методом POST обязательно указание заголовка Content-Type: application/json. Имена параметров в теле запроса чувствительны к регистру.

Токен состоит из двух частей, разделённых прямым слешем (символ «/»). Первая часть — несекретная, её можно сообщить службе технической поддержки в случае вопросов по работе протокола; вторая часть — секретная, её необходимо хранить в тайне. Пример токена — 1837/ptf9Bs9Apk4EgyP4gUCy2ajwfFVchwaR. Несекретная часть — 1837, секретная — ptf…waR.

Каждый токен имеет ограниченную область действия. Если у токена отсутствует разрешение на выполнение действия, сервер вернёт ответ с HTTP-кодом 403. Также у токена есть ограничение по количеству запросов в единицу времени: при его превышении сервер возвращает HTTP-код 429, в ответе может присутствовать заголовок Retry-After с рекомендуемым временем для совершения повторного запроса.

В таблицах с описанием параметров обязательные параметры помечены символом *. Колонка «Тип» содержит тип данных: string — строка; string (RFC 3339) — строка в формате RFC 3339 (раздел 5.6), например 2025-01-01T23:59:59+03:00; number — число; boolean — логическое значение (true/false); object — вложенный JSON-объект; array[x] — массив элементов типа x; enum — перечисление разрешённых значений. Вложенность параметров может описываться через точечную нотацию: запись name.nested.subnested эквивалентна структуре { "name": { "nested": { "subnested": … } } }.

В настоящее время получить API Key и отредактировать список разрешений для конкретного ключа можно по запросу через техническую поддержку.

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

POST api.smstraffic.ru/v2/send

Описание параметров запроса

Параметры объекта SendRequest.Channels.Sms

Параметры объекта SendRequest.Destinations

Параметры объекта SendRequest.Scheduling

POST /v2/send HTTP/1.1
Host: api.smstraffic.ru
Content-Type: application/json
Authorization: Bearer 1837/ptf9Bs9Apk4EgyP4gUCy2ajwfFVchwaR

{
  "channels": {
    "sms": {
      "message": "Hello, [[name]]!",
      "timeout": 86400,
      "transliterate": false,
      "maxParts": 255
    }
  },
  "destinations": [
    {
      "to": 78000000001,
      "params": { "name": "John" },
      "trackingData": "2de9efa4-3ee7-4691-bec0-81d93c5a54cf"
    },
    {
      "to": 78000000002,
      "content": {
        "sms": { "message": "Individual message for 78000000002" }
      }
    }
  ],
  "originator": "Originator",
  "trackingData": "common-tracking-0001",
  "scheduling": {
    "startDateTime": "2025-01-01T10:30:00+03:00",
    "localtime": false
  },
  "batchName": "Batch via API 0001",
  "restrictiveId": "ba52-5ad86d408887"
}

Описание параметров ответа

Параметры объекта SendResponse.Destinations

Параметры объекта Error

HTTP/1.1 200 OK
Content-Type: application/json

{
  "success": true,
  "destinations": [
    {
      "phone": 78000000001,
      "id": "1046379029789147161",
      "trackingData": "2de9efa4-3ee7-4691-bec0-81d93c5a54cf"
    },
    {
      "phone": 78000000002,
      "id": "1046379029789147194",
      "trackingData": "common-tracking-0001",
      "error": {
        "code": 432,
        "message": "blocked phone: 78000000002. No messages has been sent"
      }
    }
  ]
}

HTTP/1.1 200 OK
Content-Type: application/json

{
  "success": false,
  "error": {
    "code": 105,
    "message": "Duplicated request"
  }
}

Запрос статусов отправленных сообщений

POST api.smstraffic.ru/v2/statuses/list

Описание параметров запроса

POST /v2/statuses/list HTTP/1.1
Host: api.smstraffic.ru
Content-Type: application/json
Authorization: Bearer 1837/ptf9Bs9Apk4EgyP4gUCy2ajwfFVchwaR

{
  "ids": [ "1046379029789147161", "1046379029789147162" ],
  "trackingData": [
    "108c3492-98ef-44b4-ab17-ee20c864584a",
    "108c3492-98ef-44b4-ab17-ee20c864584b"
  ],
  "extendedInfo": false
}

Описание параметров ответа

Параметры объекта StatusesListResponse.Data

Параметры объекта StatusesListResponse.StatusExtended

HTTP/1.1 200 OK
Content-Type: application/json

{
  "success": true,
  "data": [
    {
      "smsId": "1046379029789147161",
      "trackingData": "108c3492-98ef-44b4-ab17-ee20c864584a",
      "submissionDate": "2025-11-27T13:56:41.562+03:00",
      "sendDate": "2025-11-27T13:56:41.593+03:00",
      "deliveryDate": "2025-11-27T13:56:42.341+03:00",
      "status": "Delivered",
      "operatorId": 1971,
      "mcc": 250,
      "mnc": 99
    },
    {
      "smsId": "1046379029789147162",
      "submissionDate": "2025-11-27T13:58:12.021+03:00",
      "sendDate": "2025-11-27T13:58:12.593+03:00",
      "deliveryDate": "2025-11-27T13:59:42.341+03:00",
      "status": "Non Delivered",
      "statusExtended": {
        "code": 3,
        "description": "Unknown subscriber"
      }
    }
  ]
}

HTTP/1.1 200 OK
Content-Type: application/json

{
  "success": false,
  "error": {
    "code": 105,
    "message": "Invalid request format"
  }
}

Автоматическое получение статусов в JSON

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

Вашему серверу необходимо отдавать в ответ на запросы HTTP статус-код 200 или 204 (заголовки и тело ответа не имеют значения), в противном случае наша система отправки статусов пометит ваш скрипт как «временно недоступный», и частота отправки статусов будет снижена до момента, пока скрипт снова не начнёт отдавать корректные HTTP статус-коды.

Для включения автоматического получения статусов в JSON формате необходимо обратиться в техническую поддержку.

Описание параметров объектов-элементов массива

POST /status_callback_url HTTP/1.1
User-Agent: StatusSender/2.0 Java/21
Host: example.com
Content-type: application/json

[
  {
    "login": "login:subacc",
    "sms_id": "8049537157380826112",
    "phone_number": "78000000001",
    "status": "Delivered",
    "delivery_date": "2025-12-06 12:31:00",
    "channel": "sms",
    "parts_count": 2,
    "err_code": 0,
    "tracking_data": "2de9efa4-3ee7-4691-bec0-81d93c5a54cf",
    "operatorId": 1971,
    "mcc": 250,
    "mnc": 99
  }
]

HTTP/1.1 200 OK
Content-Type: text/plain

Установка статуса «Проверено»

POST api.smstraffic.ru/v2/statuses/checked

Описание параметров запроса

POST /v2/statuses/checked HTTP/1.1
Host: api.smstraffic.ru
Content-Type: application/json
Authorization: Bearer 1837/ptf9Bs9Apk4EgyP4gUCy2ajwfFVchwaR

[ "1046379029789147161", "1046379029789147162" ]

Описание параметров ответа

Параметры объекта StatusesCheckedResponse.Data

Параметры объекта StatusesCheckedResponse.Data.Failed

HTTP/1.1 200 OK
Content-Type: application/json

{
  "success": true,
  "data": {
    "updated": [ "1046379029789147161" ],
    "failed": [
      {
        "id": "1046379029789147162",
        "error": "no such message or this message does not belong to you 1046379029789147162"
      }
    ]
  }
}

HTTP/1.1 200 OK
Content-Type: application/json

{
  "success": false,
  "error": {
    "code": 403,
    "message": "Access denied"
  }
}

Проверка баланса

GET api.smstraffic.ru/v2/account

Без параметров.

GET /v2/account HTTP/1.1
Host: api.smstraffic.ru
Authorization: Bearer 1837/ptf9Bs9Apk4EgyP4gUCy2ajwfFVchwaR

Описание параметров ответа

HTTP/1.1 200 OK
Content-Type: application/json

{
  "success": true,
  "data": { "account": "12520.35" }
}

Запрос журнала событий

POST api.smstraffic.ru/v2/event-log

Описание параметров запроса

POST /v2/event-log HTTP/1.1
Host: api.smstraffic.ru
Content-Type: application/json
Authorization: Bearer 1837/ptf9Bs9Apk4EgyP4gUCy2ajwfFVchwaR

{
  "from": "2025-01-01T00:00:00+03:00",
  "to": "2025-01-01T23:59:59+03:00",
  "department": "0"
}

Описание параметров ответа

Параметры объекта Events

HTTP/1.1 200 OK
Content-Type: application/json

{
  "count": 1,
  "events": [
    {
      "login": "login",
      "event": "Created batch: 2025-01-01 17:03:45. Start date: 2025-01-01 17:03:45. Phones: 1",
      "ip": "127.0.0.1",
      "event_date": "2025-01-01T17:03:45+03:00"
    }
  ]
}

HTTP/1.1 200 OK
Content-Type: application/json

{
  "code": 105,
  "description": "Department 123 not found"
}

Выгрузка сообщений

Выгрузка списка сообщений осуществляется двумя отдельными вызовами REST API:
1. Создание задания на выгрузку отчёта.
2. Скачивание отчёта.

Создание задания на выгрузку отчёта и скачивание этого отчёта должны выполняться на одном и том же узле — оба запроса должны идти либо на api.smstraffic.ru, либо на api2.smstraffic.ru, поскольку сгенерированные отчёты не синхронизируются между узлами.

Создание задания на выгрузку отчёта

POST api.smstraffic.ru/v2/report

Описание полей fields

POST /v2/report HTTP/1.1
Host: api.smstraffic.ru
Content-Type: application/json
Authorization: Bearer 1837/ptf9Bs9Apk4EgyP4gUCy2ajwfFVchwaR

{
  "from": "2025-01-01T00:00:00+03:00",
  "to": "2025-01-01T23:59:59+03:00",
  "channels": [ "sms" ],
  "fields": [ "id", "submission_date", "message", "status" ]
}

Описание параметров ответа

HTTP/1.1 200 OK
Content-Type: application/json

{
  "code": 0,
  "description": "",
  "reportId": "16e15fec1d27803e18511793b5bf699e"
}

Скачивание отчёта

GET api.smstraffic.ru/v2/report/{report_id}

Вместо {report_id} необходимо подставить идентификатор отчёта, выданный на предыдущем этапе. Если отчёт уже готов, в ответе будет HTTP статус-код 200, а в теле ответа — содержимое самого отчёта.

GET /v2/report/16e15fec1d27803e18511793b5bf699e HTTP/1.1
Host: api.smstraffic.ru
Authorization: Bearer 1837/ptf9Bs9Apk4EgyP4gUCy2ajwfFVchwaR

HTTP/1.1 200 OK
Content-Disposition: attachment; filename="16e15fec1d27803e18511793b5bf699e.csv"
Accept-Ranges: bytes
Content-Type: text/csv
Content-Length: 53

12345;2021-01-01T00:00:00+03:00;hello world;Delivered

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 78

{"count":1,"messages":[["12345","2021-01-01T00:00:00+03:00","hello world","Delivered"]]}

Архитектурно возможно появление в JSON-ответе новых свойств, поэтому при проектировании архитектуры HTTP-клиента необходимо учитывать эту возможность.

Если отчёт ещё не готов, запрос будет заблокирован до момента готовности отчёта (техника long polling). Максимальное время нахождения запроса в блокировке — 5 минут, по истечении которых сервер генерирует ответ с HTTP статус-кодом 204 (отчёт ещё не готов). В этом случае рекомендуется повторять запросы до получения 200, 404 или иного ответа, выдерживая интервал не менее 1 секунды. Готовые отчёты хранятся 7 дней, по истечении которых запрос на скачивание будет возвращать статус-код 404.

HTTP/1.1 204 No Content

HTTP/1.1 404 Not Found
Content-Type: application/json
Content-Length: 76

{"code":1, "description":"Report 16e15fec1d27803e18511793b5bf699e not found"}

UDH-склейка

Для передачи склеенных сообщений (сообщений из нескольких частей) следует использовать UDH-склейку (User Data Header). Это единственно возможный способ передачи длинных сообщений в GSM сетях. UDH является частью тела сообщения (поле short_message из обязательных параметорв). Существует два вида склейки, которые различаются сигнатурой и размером reference number.

Наиболее часто используемый вариант — reference number размером 1 байт (в примере тело сообщения в hex форме):

Другой вариант — reference number размером 2 байта (в примере тело сообщения в hex форме):

При применении 2-х байтовой склейки значительно снижается вероятность неправильной склейки сообщений на телефоне абонента. Под неправильной склейкой подразумевается ситуация, когда, например, первая половина текста передана верно, а вторая - взята из старого, ранее отправленного СМС-сообщения. Такое может проиходить из-за малого количества вариантов reference number.

Для того чтобы указать наличие UDH в теле сообщения, необходимо взвести бит UDHI Indicator (седьмой бит) в esm_class. Например, типичное значение esm_class для склеенных сообщений — 0x40.

Пример СМС из двух частей:

Из-за того, что невозможно заранее предугадать маршрут доставки каждого отдельно взятого сообщения, используется параметр reference number (в примере это AF). Он позволяет принимающему аппарату определить, что поступившие части относятся к одному и тому же склеенному сообщению. Последние два октета позволяют аппарату склеить сообщения в правильном порядке и определить общее количество частей сообщения для корректной индикации о неполном сообщении.

Правила индикации зависят от конкретной модели телефона. Наиболее часто встречаются два алгоритма индикации:

Телефон копит во внутреннем буфере все части сообщения и отображает его на своем экране только после получения всех частей.
Телефон сразу начинает отображать поступившие части, а в списке сообщений неполное сообщение отмечается особым значком.

Из-за того, что UDH является частью сообщения, максимальный размер текста уменьшается на длину UDH. Например, для сообщений в семибитной кодировке, максимальныая длина текста — 153 символа, а для UCS-2 — 67.

При использовании склейки с 2-х байтовым reference number максимальная длина текста уменьшается до 152 символов в семибитной кодировке и до 66 символов в UCS-2.

Метод GetBalance

Метод GetBalance возвращает текущий баланс аккаунта.

<?xml version="1.0" encoding="UTF-8"?>
<env:Envelope xmlns:env="http://www.w3.org/2003/05/soap-envelope"
 . xmlns="http://soap.smstraffic.ru/soap.wsdl">
  <env:Body>
   <BalanceRequest>
    <Login>texample</Login>
    <Password>p@ssw0rd!</Password>
   </BalanceRequest>
  </env:Body>
</env:Envelope>
                                    

<?xml version="1.0" encoding="UTF-8"?>
<env:Envelope xmlns:env="http://www.w3.org/2003/05/soap-envelope"
  xmlns="http://soap.smstraffic.ru/soap.wsdl">
  <env:Body>
   <BalanceResponse>
    <Status>
     <IsSuccess>true</IsSuccess>
     <Code>0</Code>
     <Description></Description>
    </Status>
    <Amount>52782.35</Amount>
   </BalanceResponse>
  </env:Body>
</env:Envelope>
                                    

SMTP протокол (вариант 1)

Для того чтобы отправить СМС на телефон абонента посредством электронной почты, необходимо написать (или ваша программа должна сгенерировать) письмо на адрес: login@corp.smsmail.ru, где login – имя, выданное вам после регистрации. Номер телефона следует указать в теме письма (subject), а само сообщение – в теле письма.

Сообщение можно написать русскими буквами - в этом случае, в зависимости от настроек вашего аккаунта, система либо сама перекодирует его в транслит (эта настройка действует по умолчанию), либо отправит в кодировке UCS-2.
Для изменения этой настройки воспользуйтесь страницей настроек (lk.smstraffic.ru/options.php) в своем аккаунте.

Пример:

From: yourname@yourdomain.ru
To: yourlogin@corp.smsmail.ru
Subject: 79161234567

Vam neobhodimo oplatit’ schet $17.65. Dlya spravok zvonite 1234567.

Телефон абонента можно указать одним из двух способов:

В теме письма - в этом случае почта отправляется на адрес типа login@corp.smsmail.ru, как описано выше.
В адресе - разделяя номер телефона и логин точкой. Например, 79161112233.login@corp.smsmail.ru.

Пример:

From: yourname@yourdomain.ru To: 79161234567.yourlogin@corp.smsmail.ru Subject: ne imeyet znacheniya

Vam neobhodimo oplatit’ schet $17.65. Dlya spravok zvonite 1234567.

Обратите внимание - SMTP v1 не предназначен для массовых рассылок. Для массовых рассылок используйте протоколы SMPP, HTTP(S) или личный кабинет. Рекомендуемое ограничение — не более 100 писем в минуту.

По желанию клиента можно ограничить отсылку таких писем с конкретного SMTP сервера (рекомендуется). Аутентификация осуществляется по заголовкам Received. Для того чтобы установить защиту, необходимо отправить тестовое электронное сообщение на tech.support@smstraffic.ru через тот SMTP сервер, который будет использоваться для отправки рабочих сообщений. В теле письма укажите, для какого аккаунта вы хотите установить защиту.

Также, по желанию клиента можно ограничить список телефонов, на которые возможна отправка. Список можно задать на странице lk.smstraffic.ru/options.php. По умолчанию принимаются сообщения на любые телефоны.

Мы настоятельно рекомендум использовать хотя бы один тип защиты — либо по заголовкам SMTP, либо с помощью ограничения списка получателей. Возможно также полностью запретить прием сообщений через email и пользоваться только протоколами HTTP(S) или SMPP. Установить такой запрет можно на странице lk.smstraffic.ru/options.php. Для всех новых аккаунтов отправка по email описанным выше способом по умолчанию отключена.

При отправке по email невозможно динамически задавать имя или телефон отправителя (поле originator при передаче по HTTP), поэтому в качестве отправителя всегда будет подставлено одно и то же значение, по умолчанию. Это значение можно исправить на странице настроек вашего личного кабинета. Если необходимо динамически изменять отправителя, рекомендуем использовать протоколы HTTP(S), SMPP или SMTP вариант 2.

SMTP протокол (вариант 2)

Существует другой способ отправлять СМС-сообщения через email и при этом пользоваться практически всеми возможностями, которые предоставляет протокол HTTP(S). Отправьте email на адрес multi@smtp2.smsmail.ru. В теле сообщения перечислите поля и их значения (согласно описанию протокола HTTP), разделенные двоеточием. Каждая пара "поле: значение" должна быть на отдельной строке и отделена от соседних пар по крайней мере одной пустой строкой. Тема сообщения не имеет значения.

Пример:

From: yourname@yourdomain.ru
To: multi@smtp2.smsmail.ru
Subject: ne imeyet znacheniya

login: yourlogin
password: yourpass

phones: 79161234567

message: Vam neobhodimo oplatit’ schet $17.65. Dlya spravok zvonite 1234567.

originator: MyCompany

Ограничение: в поле message нельзя использовать два символа перевода строки подряд (такое сочетание символов будет воспринято как разделитель полей). Дополнительно можно использовать специальный параметр reply_to_email со значением 1, как в примере ниже:

From: yourname@yourdomain.ru
To: multi@smtp2.smsmail.ru
Subject: ne imeyet znacheniya

login: yourlogin
password: yourpass

phones: 79161234567

message: Vam neobhodimo oplatit’ schet $17.65. Dlya spravok zvonite 1234567.

originator: MyCompany

reply_to_email: 1

В этом случае на email-адрес отправителя будет выслан ответ, такой же как при использовании протокола HTTP(S).

<?xml version="1.0"?>
<reply>
  <result>OK</result>
  <code>0</code>
  <description>queued 1 messages</description>
  <message_infos>
   <message_info>
    <phone>79161234567</phone>
    <sms_id>1014190631</sms_id>
   </message_info>
  </message_infos>
</reply>
                                    

Обратите внимание - данный метод не предназначен для массовых рассылок. Для массовых рассылок используйте протоколы SMPP, HTTP(S) или личный кабинет. Рекомендуемое ограничение — не более 100 писем в минуту и не более 10000 СМС в одном письме.

Запрос списка входящих сообщений

Для получения списка входящих сообщений вызывается скрипт api.smstraffic.ru/multi.php с параметрами:

login - ваш логин
password - ваш пароль
operation=incoming

Необязательные параметры:

from_date- дата, начиная с которой необходимо получить список. Формат: «ГГГГ-ММ-ДД» или «ГГГГ-ММ-ДД ЧЧ:ММ:СС» . Время московское.
from_phone - телефон, с которого приходили сообщения;
count - максимальное количество сообщений, выдаваемое за один запрос;
want_sms_ids=1 — в ответный XML включается идентификатор СМС (по умолчанию - не включается).

<?xml version="1.0" ?>
<reply>
  <count>125</count>
  <messages>
   <message>
    <from_phone>79031234567</from_phone>
    <text>sms message text</text>
    <send_date>2020-05-09 01:12:59</send_date>
    <delivery_date>2020-05-09 01:13:05</delivery_date>
    <sms_id>5269156759</sms_id>
   </message>
   ...
   <message>
    <from_phone>79037654321</from_phone>
    <text>sms message</text>
    <send_date>2020-05-09 06:02:13</send_date>
    <delivery_date>2020-05-09 06:02:18</delivery_date>
    <sms_id>5269156775</sms_id>
   </message>
  </messages>
</reply>
                                

Срок хранения и выдачи сообщений по данному запросу не должен превышать двух дней. Если для вас важна оперативность получения сообщений, используйте возможность автоматического уведомления по HTTP протоколу, см. раздел Пересылка входящих сообщений на HTTP(S).

Короткий номер

Для получения сообщений, поступивших на ваш короткий номер, необходимо установить на своем веб-сервере скрипт, который будет принимать методом GET или POST следующие параметры:

phone – телефонный номер абонента;
message – текст его запроса (по умолчанию, кодировка Windows-1251);
shortcode – короткий номер;
password – пароль для защиты от несанкционированного использования вашего скрипта;
sms_id – уникальный идентификатор сообщения. В случае повторного поступления запроса с одним и тем же sms_id необходимо дать абоненту точно такой же ответ. Пришлите нам URL вашего скрипта, и мы настроим его вызов после каждого поступления запроса на ваш короткий номер. Скрипт должен обработать запрос и дать ответ, который мы без изменений перешлем абоненту по СМС.

Ответ может содержать, например, запрошенную текстовую информацию, подтверждение принятия запроса или ссылку на wap-сайт, по которой абонент может скачать запрошенный контент. Ответ не должен содержать никакого форматирования. Вы можете самостоятельно редактировать параметры вызова скрипта на странице настроек https://lk.smstraffic.ru/options.php.

Необходимо придерживаться шаблона следующего вида:

Путь_к_вашему_скрипту?message={{message}}&phone={{phone}}&sms_id={{sms_id}}&shortcode={{shortcode}}.

Пример PHP скрипта для обработки сообщений, поступивших на короткий номер, можно найти в папке shortcode.