"Для разработчиков", "Серверные скрипты", "Описание функций", "Интеграции", "TurboSMS", "mIntegrationTurboSMSSend".
Отправить SMS-сообщение на один или несколько номеров. Как правило, сообщения ставятся в очередь в самом сервисе и отправляются получателю мгновенно либо в течение нескольких минут. Их статус можно посмотреть в админке TurboSMS.
Синтаксис
function mIntegrationTurboSMSSend(const sMsg, sRecipients: string; var sJSONResponse: string): integer;
Параметры и возвращаемые значения
Параметр |
Тип |
Значение |
|---|---|---|
sMsg |
string |
текст сообщения, максимум 1521 символ латиницей или 661 символ кириллического текста (10 сегментов); |
sRecipients |
string |
получатели сообщения, номера телефонов в международном формате через запятую, без ведущего "+" и пробелов, например: "380504451213,380671234587"; |
sJSONResponse |
string |
JSON-объект, полный ответ сервиса. |
Результат функции
-2 |
интеграция выключена, её необходимо включить в настройках; |
-5 |
сообщение слишком длинное; |
-6 |
сообщение пустое; |
-7 |
список получателей сообщения пустой; |
800, 801, 802, 803 |
сообщение успешно отправлено, детали смотрите в полном ответе сервиса. |
Пример
Отправка тестового сообщения на один номер телефона:
var
iResult: integer;
sJSONResponse: string;
begin
iResult := mIntegrationTurboSMSSend('Test message from MyChat Server!', '380504452169', sJSONResponse);
mLogScript('Result: ' + IntToStr(iResult), '');
mLogScript(sJSONResponse, '');
end.Результат работы скрипта
[15:04:42] (Log "TurboSMSSend"): Result: 800
[15:04:42] (Log "TurboSMSSend"): {"response_code":800,"response_status":"SUCCESS_MESSAGE_ACCEPTED","response_result":[{"phone":"380504452169","message_id":"5a22ddb8-60a1-b053-dc5a-a5bf4bc6fdfa","response_code":0,"response_status":"OK"}]}
[15:04:42] (Run "TurboSMSSend"): Время выполнения скрипта: 274 мс
[15:04:42] (Run "TurboSMSSend"): Скрипт выполнен успешно.
Ещё посмотреть
Справка сервиса TurboSMS по HTTP API, команды, ответы и возможные ошибки