"Для разработчиков", "Серверные скрипты", "Описание функций", "Интеграции", "TurboSMS", "mIntegrationTurboSMSViberSend".
Отправить сообщение на один или несколько номеров Viber. Как правило, сообщения ставятся в очередь в самом сервисе и отправляются получателю мгновенно либо в течение нескольких минут.
Их статус можно посмотреть в админке TurboSMS. Сообщения отправляются от имени зарегистрированного отправителя. Имя вам должен разрешить сервис TurboSMS, именно его нужно указать в настройках интеграции.
Синтаксис
function mIntegrationTurboSMSViberSend(const sMsg, sRecipients: string; var sJSONResponse: string): integer;
Параметры и возвращаемые значения
Параметр |
Тип |
Значение |
|---|---|---|
sMsg |
string |
текст сообщения, максимум 1000 символов в кодировке UNICODE; |
sRecipients |
string |
получатели сообщения, номера телефонов в международном формате через запятую, без ведущего "+" и пробелов, например: "380504451213,380671234587"; |
sJSONResponse |
string |
JSON-объект, полный ответ сервиса. |
Результат функции
-2 |
интеграция выключена, её необходимо включить в настройках; |
-5 |
сообщение слишком длинное; |
-6 |
сообщение пустое; |
-7 |
список получателей сообщения пустой; |
800, 801, 802, 803 |
сообщение успешно отправлено, детали смотрите в полном ответе сервиса. |
Пример
Отправка тестового Viber-сообщения на один номер телефона, используется стандартный тестовый отправитель в настройках ("Mobibon"), вы должны зарегистрировать своё имя отправителя.
var
iResult: integer;
sJSONResponse: string;
begin
iResult := mIntegrationTurboSMSViberSend('Viber test message from MyChat ' + FormatDateTime('yyyy-mm-dd hh:nn:ss', Now),
'380504452169',
sJSONResponse);
mLogScript('Result: ' + IntToStr(iResult), '');
mLogScript(sJSONResponse, '');
end.Результат работы скрипта
[16:22:51] (Log "TurboSMSViberSend"): Result: 800
[16:22:51] (Log "TurboSMSViberSend"): {"response_code":800,"response_status":"SUCCESS_MESSAGE_ACCEPTED","response_result":[{"phone":"380504452169","message_id":"aae54518-60a1-494e-aa0e-d0b23063bae2","response_code":0,"response_status":"OK"}]}
[16:22:51] (Run "TurboSMSViberSend"): Время выполнения скрипта: 318 мс
[16:22:51] (Run "TurboSMSViberSend"): Скрипт выполнен успешно.
Ещё посмотреть
Справка сервиса TurboSMS по HTTP API, команды, ответы и возможные ошибки