"Для разработчиков", "Серверные скрипты", "Описание функций", "Интеграции", "TurboSMS", "mIntegrationTurboSMSSendExt".

 

Отправить SMS-сообщение на один или несколько номеров. Как правило, сообщения ставятся в очередь в самом сервисе и отправляются получателю мгновенно либо в течение нескольких минут.

Их статус можно посмотреть в админке TurboSMS.

 

Можно указать flash-статус а также время для отложенной отправки.

 

Синтаксис

function mIntegrationTurboSMSSendExt(const sMsg, sRecipients: string; const dtStart: double; const bFlash: boolean; var sJSONResponse: string): integer;

 

Параметры и возвращаемые значения

Параметр

Тип

Значение

sMsg

string

текст сообщения, максимум 1521 символ латиницей или 661 символ кириллического текста (10 сегментов);

sRecipients

string

получатели сообщения, номера телефонов в международном формате через запятую, без ведущего "+" и пробелов, например: "380504451213,380671234587";

dtStart

double

дата и время, когда сообщение следует отправить (не больше 14 дней от текущего времени), либо NoDate, если сообщение надо отправить прямо сейчас;

bFlash

boolean

true, если нужно отправить "Flash-SMS", которая мгновенно показывается на экране и не сохраняется в памяти телефона;

sJSONResponse

string

JSON-объект, полный ответ сервиса.

 

Результат функции

-2

интеграция выключена, её необходимо включить в настройках;

-5

сообщение слишком длинное;

-6

сообщение пустое;

-7

список получателей сообщения пустой;

-8

дата отложенной отправки меньше текущей даты или больше 14 дней от текущего времени;

800, 801, 802, 803

сообщение успешно отправлено, детали смотрите в полном ответе сервиса.

 

Пример

Отправка тестового Flash-сообщения на один номер телефона (современные смартфоны, как правило, игнорируют этот флаг и показывают сообщения, как обычные SMS + сохраняют их в истории принятых сообщений) :

var
  iResult: integer;
  sJSONResponse: string;
begin
  iResult := mIntegrationTurboSMSSendExt('Test FLASH message from MyChat Server!', '380504452169', NoDate, true, sJSONResponse);
  
  mLogScript('Result: ' + IntToStr(iResult), '');
  mLogScript(sJSONResponse, '');
end.

Результат работы скрипта

[16:05:44] (Log "TurboSMSSendExt"): Result: 800

[16:05:44] (Log "TurboSMSSendExt"): {"response_code":800,"response_status":"SUCCESS_MESSAGE_ACCEPTED","response_result":[{"phone":"380504452169","message_id":"a7ccfba4-60a1-12f0-1c90-382232dfae71","response_code":0,"response_status":"OK"}]}

[16:05:44] (Run "TurboSMSSendExt"): Время выполнения скрипта: 766 мс

[16:05:44] (Run "TurboSMSSendExt"): Скрипт выполнен успешно.
 

Ещё посмотреть

Справка сервиса TurboSMS по HTTP API, команды, ответы и возможные ошибки

IntToStr

mLogScript