Twilio
Расширение ThingWorx Twilio обеспечивает возможность отправлять текстовые SMS и голосовые сообщения из ThingWorx через платформу связи Twilio. Это позволяет создавать в ThingWorx вещь Twilio, сохраняющую информацию о конфигурации для учетной записи Twilio, которая будет использоваться для отправки сообщений.
Сервисы, предоставленные расширением Twilio, могут использоваться непосредственно или в сочетании с компонентом
ThingWorx Notifications. Расширение ThingWorx Twilio доступно на сайте
support.ptc.com.
Конфигурация
Необходимо
импортировать расширение Twilio в ThingWorx. После импорта расширения Twilio Шаблон вещи с именем Twilio появляется в списке Шаблоны вещей.
Чтобы создать и настроить новую вещь Twilio, выполните следующее:
1. В ThingWorx создайте новую вещь и назначьте шаблон Twilio.
2. Щелкните вид Конфигурация и введите следующие подробные сведения в учетную запись Twilio, из которой будут отправляться сообщения:
|
Общие настройки
|
Описание
|
|
authToken
|
Введите маркер аутентификации, связанный с учетной записью Twilio.
|
|
callerID
|
Введите действительный номер телефона, связанный с учетной записью Twilio. Это будет номер, с которого будут создаваться сообщения.
|
|
accountSID
|
Введите параметр accountSID, связанный с учетной записью Twilio.
|
3. После ввода информации щелкните Сохранить.
В области Сервисы доступны следующие сервисы.
• GetNotificationHandlers - используется компонентом
ThingWorx Notifications и, как правило, не является полезным.
• SendSMSMessage - требует номер телефона получателя и текст для отправки.
• SendVoiceMessage - требует номер телефона получателя и текст для отправки, голос сообщения (мужской или женский), возможность цикла и язык голоса.
Если новые сервисы создаются в вещи Twilio, они могут вызываться в пользовательском сервисе из области редактора сервиса Мои сущности.
Использование
Расширение Twilio может путем вызова использоваться одним из следующих сервисов:
• SendSMSMessage
Шаблон вещи Twilio включает сервис для отправки SMS-сообщений. SendSMSMessage принимает номер телефона получателя и сообщение как входные данные. Например, для массовой рассылки текста всем сотрудникам можно создать сервис, содержащий следующий код:
var employeeList = Groups[employees].GetGroupMembers();
for (var x = 0; x < employeesList.getRowCount(); x++) {
var employee = employeesList.getRow(x);
var params = {
to: employee.smsAddress,
text: "Hey, " + employee.firstName + "." + message
};
me.SendSMSMessage(params);
}
for (var x = 0; x < employeesList.getRowCount(); x++) {
var employee = employeesList.getRow(x);
var params = {
to: employee.smsAddress,
text: "Hey, " + employee.firstName + "." + message
};
me.SendSMSMessage(params);
}
• SendVoiceMessage
Шаблон вещи Twilio также включает сервис для выполнения телефонных звонков. SendVoiceMessage принимает номер телефона получателя и сообщение как входные данные в дополнение к необязательным голосовым, языковым и циклическим данным. Например, чтобы автоматизировать сервис будильника, можно создать сервис, содержащий следующий код:
var date = new Date();
var hour = date.getHours();
if (hour == 5) {
var params = {
to: "(555) 555-5555",
text: "Rise and shine!"
};
me.SendVoiceMessage(params);
}
var hour = date.getHours();
if (hour == 5) {
var params = {
to: "(555) 555-5555",
text: "Rise and shine!"
};
me.SendVoiceMessage(params);
}
Теперь вы готовы отправлять SMS-сообщения и делать телефонные звонки.