Use SMS, Email, and HTTP Notifications

Oracle IoT Production Monitoring Cloud Service integrates with the Twilio SMS service to help provide seamless SMS notifications. You can also use the default SMTP account, or your own SMTP server, for sending out email notifications. HTTP endpoint notifications are also supported for external applications.

You can configure Oracle IoT Production Monitoring Cloud Service to send SMS notifications for incidents, warnings, and alerts. When an associated rule triggers an incident, warning, or alert, SMS notifications are sent out to all configured subscribers on their mobile devices.

You can also send email notifications for incidents, warnings, and alerts. When an associated rule triggers an incident, warning, or alert, email notifications are sent to all configured subscribers. The email notifications also contain a link to the corresponding incident making it easy to navigate to the incident details in the application.

HTTP endpoint notifications are also supported for external applications. For example, an application, such as Oracle Transportation Management (OTM) or Oracle Intelligent Track and Trace can receive alerts and incident notifications from the connected IoT application.

SMS, email, and HTTP notifications eliminate the need to monitor the Oracle IoT Production Monitoring Cloud Service application continuously. All subscribers are actively informed about the incidents, warnings, or alerts that need attention. You can then use the Oracle IoT Production Monitoring Cloud Service mobile application or Web interface to look at, and address, the issues.

To use the SMS notification service, you must have a Twilio account subscription. Add your Twilio account information to Oracle IoT Production Monitoring Cloud Service to start using the notification service. After adding your account, you can add subscribers that need to receive these notifications, and select the rules that should send the notifications.

To use email notifications, you can use the built-in, default SMTP account. The default account has a usage limit of 100,000 messages. Alternatively, you can use your own SMTP server to channel Oracle IoT Production Monitoring Cloud Service email notifications. After choosing your SMTP account, you can add subscribers that need to receive these notifications, and select the rules that should send the notifications.

Add Your SMS Notification Account Details

To start using the notification feature, add your notification account details in Oracle IoT Production Monitoring Cloud Service. For SMS notifications, add your Twilio account details.

Make sure that the IoT administrator has already added the Twilio domain as a trusted CN in the Oracle Internet of Things Intelligent Applications Cloud management console. To do this, the administrator adds *.twilio.com under Trusted CN in the Settings page.
To add the notification account details in Oracle IoT Production Monitoring Cloud Service:
  1. In the Operations Center, click Menu (Menu icon), and then click Settings.
    If you are in the Design Center, you need to click Previous (Previous icon) before you see the Settings option in the menu.
  2. Click Notification Accounts.
  3. Click Create Notification Account (Add icon).
  4. Select your Provider.
    Oracle integrates with Twilio, as the third-party notification service provider.
  5. Enter a Name for your notification account.
    For example, My Twilio Account.
  6. Enter the SID for your Twilio account.
    This is your Twilio account SID that you can get from your Twilio console.
  7. Enter the Authorization Token associated with your Twilio account.
    You can get the authorization token from your Twilio console.
  8. Enter the Sender Phone No for notification messages.
    The sender phone number is provided by Twilio, and can be generated in your Twilio account.
  9. Click Create to add the notification account.
You can next add subscribers or recipients for the SMS notifications.

Add Your Email Notification Account Details

To start using the email notification feature, you can use the built-in, default SMTP service in Oracle IoT Production Monitoring Cloud Service. Alternatively, you can add your own SMTP server to send unlimited email notifications.

The default SMTP service in Oracle IoT Production Monitoring Cloud Service lets you send limited email notifications. The usage limit is 100,000 messages per cycle. If your usage needs are different, you can add your own SMTP notification account.

Make sure that the IoT administrator has already added the SMTP domain as a trusted CN in the Oracle Internet of Things Intelligent Applications Cloud management console. To do this, the administrator adds *.yourSMTPdomain.com under Trusted CN in the Settings page.

To add the SMTP notification account details in Oracle IoT Production Monitoring Cloud Service:
  1. In the Operations Center, click Menu (Menu icon), and then click Settings.
    If you are in the Design Center, you need to click Previous (Previous icon) before you see the Settings option in the menu.
  2. Click Notification Accounts.
    Notice that the Notification Accounts section already includes the default SMTP account.
  3. To add your own SMTP account, click Create Notification Account (Add icon).
  4. Under Provider, select SMTP.
  5. Enter a Name for your notification account.
    For example, My SMTP Account.
  6. Enter the User Name and Password for your SMTP account.
  7. Enter the SMTP Host server name.
  8. Enter the SMTP Port.
    The default port number is 465.
  9. Under From, enter the sender email ID to be used for sending email notifications.
  10. Optionally select Use TLS (Transport Layer Security) to secure SMTP with an encryption protocol.
  11. Click Create to create the notification account.
You can next add subscribers or recipients for the email notifications.

Add Your HTTP Notification Account Details

To start using the notification feature, add your notification account details in Oracle IoT Production Monitoring Cloud Service. For HTTP notifications, add your external application HTTP endpoint URL.

To add the notification account details in Oracle IoT Production Monitoring Cloud Service:
  1. In the Operations Center, click Menu (Menu icon), and then click Settings.
    If you are in the Design Center, you need to click Previous (Previous icon) before you see the Settings option in the menu.
  2. Click Notification Accounts.
  3. Click Create Notification Account (Add icon).
  4. Under Provider, select HTTP.
  5. Enter a Name for your notification account.
    For example, External HTTP Account.
  6. Enter the endpoint URL for your external HTTP application.
  7. Select the Authentication Type.
    The password-based Basic authentication type is currently supported for HTTP notifications.
  8. Enter the User Name and Password credentials for your external HTTP endpoint.
  9. Click Create to add the notification account.
You can next add subscribers or recipients for the HTTP notifications.

Add Subscribers for the Notifications

You can add one or more subscribers for a notification. You can also create different subscriber groups and add them to rules, as desired.

  1. In the Operations Center, click Menu (Menu icon), and then click Settings.
    If you are in the Design Center, you need to click Previous (Previous icon) before you see the Settings option in the menu.
  2. Click IoT Organizations.
  3. Click the name of your organization.
  4. Click Subscribers to open the subscribers page for your organization.
  5. Click Create Subscriber (Create Subscriber icon to add a new subscriber or group or subscribers.
  6. Select your Notification Account.
    See Add Your SMS Notification Account Details, Add Your Email Notification Account Details, and Add Your HTTP Notification Account Details for more information on adding SMS, email, and HTTP notification accounts.
  7. Enter a Name for the subscriber or group of subscribers that you are creating.
    For example, Production Team.

    You may want to create different subscriber groups based on the factories or machines managed by each group.

  8. (Optional) Select pre-existing Rules to subscribe to events from the selected rules.
    Note that you can also add notification subscribers to an individual rule by editing the rule, or when creating a new rule.
  9. For SMS and email notification accounts, select the Contact Method.
    • Subscribers: Select to add existing user names as subscribers.
    • Emails: For email notification accounts, select to add subscribers using their email addresses.
    • Phone Numbers: For SMS notification accounts, select to add subscribers using their phone numbers.
    • Subscribers and Emails: For email notification accounts, select if you wish to add some subscribers using their user names and others using their email addresses.
    • Subscribers and Phone Numbers: For SMS notification accounts, select if you wish to add some subscribers using their user names and others using their phone numbers.
    1. If you chose Subscribers, select existing users to add them as subscribers.
      Depending on whether you have chosen an SMS or email notification account, the phone numbers or emails of the users are added to the subscriber group.
    2. If you are configuring an SMS subscriber group, you can individually enter the subscriber Phone Numbers.
      Precede the phone numbers with the country codes. Press enter after entering each phone number.
    3. If you are configuring an email subscriber group, you can individually enter the subscriber Emails.
      Press enter after entering each email address.
  10. Click Create to finish creating the subscriber group.