To add a new notification (also called an alert) to your iOn account, you have two options: duplicating (and modifying) an existing alert or creating a new one from scratch. Both methods are covered below, in separate sections. Skip down to "Duplicating a Notification" if you are copying an existing alert.


Note: If you need the notification to be triggered and sent only during a certain portion of the day (for example, if you want to be notified about excessive idling only during the workday), it will need to have a schedule. Make sure to create that schedule before adding your new alert, if it doesn't already exist, following the steps in Adding a Schedule. You can also be alerted when activity occurs outside of the hours in the applied schedule.
 

For more information about notifications, go to Viewing Your Notification Configurations.


Creating a New Notification from Scratch


To build a completely new alert from the ground up, follow these steps:


  1. In the sidebar menu on the left, click .
     
  2. Click Notifications on the flyout menu that appears.
     
    The Admin - Notifications screen will appear.
      
  3. Click Add New at the top right of the screen.
     
    The Add Notification dialog box will appear.
       
  4. Type the name to use for the alert in the Notification Name field.
    Note: For example, you might create a notification called Restricted Zone Alert, which will inform you if one of your operators is driving an asset through a map area you have designated as off-limits (perhaps due to hazardous road conditions).
    By default, the group you currently have selected in the Group Chooser will be set for the group to add the alert to.
     
  5. If you would like to place it in a different group, click the Group drop-down arrow and select the group from the list.
    Note: Only assets in the group you choose will trigger the notification you configure, plus its subgroups if you make the alert inheritable.
     
    Assets in groups that are higher up in your organization's hierarchy (such as the specified group's parent group) will NOT trigger the notification.
     
    If you want the new notification to be activated by all your assets, place it in your top-level group (and leave Inheritable selected).

  6. Click the Notification Type drop-down arrow and select its type, depending on what you want the alert to be triggered by:
     
    • iOn Associated Tag Found Alert: An alert is sent out if an asset in the group previously had a missing associated iOn Tag (see Employing iOn Tags) that has now been found — that is, it is again close to the asset's LMU.
       
    • iOn Associated Tag Missing Alert: An alert is sent out if an asset in the group has an associated iOn Tag (see Employing iOn Tags) that is no longer in proximity to the asset's LMU.
       
    • iOn DTC Alert [OBD]: If a diagnostic trouble code (DTC), or fault code, is sent to iOn from an OBDII asset in the specified group, it will set off this notification.
       
    • iOn Device Input X Alert: A notification will be triggered when the specified input is activated (given choices Input 1, Input 2, and so on).
       
    • iOn Door Status Alert: This alert type appears in the list only for customers with door sensors. The notification will be sent when the door is in the state you select (open or closed).
       
    • iOn EV State of Charge: An alert will be sent out when the state of charge of an asset in the assigned group (or optionally, a single asset that you choose) falls to the specified percentage threshold.
       
    • iOn Event: The event you specify will activate the alert for all assets in the assigned group.
       
    • iOn Event Label: As with the iOn Event notification type, the event you specify will activate the alert for all assets in the assigned group, but this differs in that you can specify nonstandard events.
       
    • iOn Event by Asset: The event you specify will activate the notification for only the asset you choose.
      Note: In order to use an alert to monitor one particular asset in this way, you must select the same group in step 5 that the asset is assigned to.
    • iOn Event v2: As with iOn Event, the event you specify will activate the alert for all assets in the assigned group, but this also allows you to narrow the triggering event by asset type, category, name, and route.
       
    • iOn Geofence Event: The notification will be triggered if any asset in the assigned group enters or exits one of the group's geofences. You can also select a single geofence to monitor.
       
    • iOn Geofence Event by Asset: The notification will be triggered if the particular asset you indicate enters or exits one of the assigned group's geofences. You can also select a single geofence to monitor.
      Note: As with iOn Event by Asset, this alert type requires you to select the same group in step 5 that the asset is assigned to.
    • iOn Geofence Event v2: As with iOn Geofence Event, the notification will be triggered if any asset in the assigned group enters or exits one of the group's geofences (or a single, selected geofence), but this also allows you to narrow the activation by asset type, category, name, and route, plus geofence category. You can choose to monitor just arrivals or departures or both.
       
    • iOn Geofence URLPOST Event: An HTTP POST request will be made to a third-party web application/service when any asset in the assigned group enters or exits one of the group's geofences; the request will contain detailed information about the geofence event.
      Note: This requires prior integration with the third-party web application/service.
    • iOn Hub Temperature Excursion: This alert type appears in the list only for customers with tire temperature sensors. The notification will be sent when a tire temperature value exceeds the specified threshold.
       
    • iOn Long Drive: A notification will be sent out when an asset's drive time exceeds a maximum threshold you set without an interruption of at least the specified minimum break time.
       
    • iOn Long Idle: A notification will be sent out when an asset's idling time exceeds a threshold you set.
       
    • iOn Long Stop: A notification will be sent out when an asset's stop time exceeds the chosen threshold.
       
    • iOn MIL Status Alert [JBUS]: If the malfunction indicator lamp (Check Engine light) code is sent to iOn from a JBUS asset in the specified group, it will set off this alert.
       
    • iOn MIL Status Alert [OBD]: If the malfunction indicator lamp (Check Engine light) code is sent to iOn from an OBDII asset in the specified group, it will set off this alert.
       
    • iOn Maintenance Alert: You can set this notification to be triggered both when an asset's service reminder time frame starts and on the day (or mile, or hour) it is due for repairs.
      Note: This and the following notification type require service schedules to be set up and assigned to your assets. (See The Process of Creating a Service Schedule and Adding a Service Schedule for details.)
    • iOn Maintenance Due Alert: This notification is sent out when an asset in the chosen group comes due for repairs.
       
    • iOn Missing Tag Alert: A notification is sent out if any iOn Tag (see Employing iOn Tags) in the group is no longer in proximity to an asset's LMU.
       
    • iOn Speed Alert: This is triggered if a vehicle in the assigned group travels at the speed you specify.
       
    • iOn Speed Alert [PSL]: This is triggered if a vehicle in the assigned group travels the amount you specify over the posted speed limit.
       
    • iOn Tag Found Alert: A notification is sent out if any previously missing iOn Tag (see Employing iOn Tags) in the group has been found — that is, it is again close to an asset's LMU.
       
  7. If the alert should be triggered and sent only during a certain portion of the day, click the Schedule drop-down arrow and select the name of the schedule.
    Note: You will only be able to apply schedules in the same group as the notification (or a schedule from a parent group that is inheritable).

    As mentioned earlier, you should create the schedule before you add the alert. See Adding a Schedule for details.
    After you select a schedule, a new field will appear to its right, Schedule Reference.
      
  8. Normally, you will leave Inside Schedule selected (or if necessary, click the Schedule Reference drop-down arrow and choose that), which means that the alert is sent out during the hours set by the schedule.
     
    If the notification should be triggered and sent during the exact opposite segment of the day from the schedule, click the Schedule Reference drop-down arrow and select Outside Schedule instead.
    Note: Outside Schedule was designed primarily for customers who wanted to make sure that their drivers weren't operating their vehicles outside of their authorized work hours. You could set up such a notification by following the steps in Adding an Unauthorized Usage Notification.
  9. Type an explanation of what the notification is designed to inform the user about in the Description field (such as "Vehicle driving in restricted zone").
     
  10. Click the Severity drop-down arrow and select the priority level of the alert: Low, Medium, High, or Urgent (formerly Critical).
     
  11. Leave the Notification Status field at its default value of Enabled.
    Note: If the notification is set to Disabled or Suspended, its triggering event won't be looked for, and the alert won't be reported to iOn. But this won't likely be what you want when you are adding a new notification.
  12. If you want the alert to be triggered by assets in subgroups of the group it is assigned to (so the subgroups, or child groups, inherit the notification from the parent group), leave Inheritable selected.
     
    If you want it to be sent out only for that single group's assets, deselect Inheritable.
     
  13.  Set the triggering event as follows, depending on the type of notification you selected:
     
    • All notifications not included in the list below: No triggers need to be set for any of the alerts not described here, as any asset in the specified group will generate the notification.
       
    • iOn Device Input X Alert: Type a name for the input that will be meaningful when the notification is received (so instead of just "Input 1," it will say, "Snow Plow," for example).
        
    • iOn Door Status Alert: Click the Door Status drop-down arrow and select Door Open or Door Closed, depending on which state you want to set off the alert.
        
    • iOn EV State of Charge: In the Charge Threshold (Percentage) field, type the percentage value that will activate the alert if assets in the assigned group fall to that level of charge. (For example, if you enter 15, the notification will be sent when a vehicle's charge value falls from 16% to 15%.) You can narrow the alert activation further by filling in the other fields. If applicable, click the Asset Type, Asset Category, and Asset Name drop-down arrows and select in each what you want to trigger the notification.
        
    • iOn Event: Click the Event drop-down arrow and select the name of the event to activate the notification.
        
    • iOn Event Label: Type the name of the event to activate the alert.
        
    • iOn Event by Asset: Search for the individual asset you want to set off the alert by typing part of its name in the Asset Name field and select it from the results.
       
      Then click the Event drop-down arrow and select the name of the event to activate the alert.
       

      Note: The Asset Name search will return results only for assets in the same group as the notification.
    • iOn Event v2: Click the Event drop-down arrow and select the name of the event to activate the alert; this is the only required attribute. But you can narrow the notification activation further by filling in the other fields. If applicable, click the Asset Type, Asset Category, Asset Name, and Route drop-down arrows and select in each what you want to trigger the alert.
        
    • iOn Geofence Event: If you want the alert to be triggered by a single geofence, you can click the Geofence Name drop-down arrow and select its name. (You can begin to type the geofence name, and your selection will move down to matching names.) If you leave this field empty, all geofences in the assigned group will activate the alert if the group's assets enter or exit their boundaries.
       
      Caution: If you chose a different group in which to place the alert than the one you have selected in the Group Chooser, you may need to wait a minute for the geofences assigned to that group to appear in the list. You can only select geofences that are in the same group.
    • iOn Geofence Event by Asset: Search for the individual asset you want to set off the notification by typing part of its name in the Asset Name field and select it from the results.
       
      Then, optionally, you can click the Geofence Name drop-down arrow and select the name of an individual geofence that will activate the alert if that particular asset enters or exits its boundary. (You can begin to type the geofence name, and your selection will move down to matching names.) If you don't specify a certain geofence, the notification will be sent for all the geofences in the assigned group.
       
      Note: The Asset Name search will return results only for assets in the same group as the alert.
    • iOn Geofence Event v2: You can choose multiple factors to set off the alert if assets in the assigned group enter and/or exit one of its geofence's boundaries. You can narrow the alert activation to a single geofence by clicking the Geofence Name drop-down arrow and selecting its name. If applicable, you also can click the Asset Type, Asset Category, Asset Name, Route, Geo Event Type, and Geofence Category drop-down arrows and select in each what you want to trigger the notification.
        
    • iOn Hub Temperature Excursion: In the Temperature Threshold (°F)/(°C) field, type the temperature value that will activate the alert if the tire temperature of an asset in the assigned group rises above that. (For example, if you enter 158, the notification will be sent when the hub temperature increases from 158 °F to 159 °F.)
        
    • iOn Long Drive: Type the maximum time in minutes an asset in the specified group can travel without an interruption in the Max Drive Time field. Type the minimum amount of break time that must be reached before resuming driving in the Min Break Time field.
        
    • iOn Long Idle: Type the maximum time in minutes an asset in the chosen group can let its engine idle in the Device Idle Duration field.
        
    • iOn Long Stop: Type the maximum time in minutes an asset's stop is expected to be in the Long Stop Duration field.
        
    • iOn Maintenance Alert: Select the Next Service Reminder Flag check box to have the notification sent out when an asset's service reminder period begins; you can also select the Next Service Due Flag check box to send a second notification on the day, mile, or hour the service is due. You can ignore the Next Service Days Overdue, Next Service Odometer Overdue, and Next Service Engine Hours Overdue fields.
        
    • iOn Maintenance Due Alert: Select the Next Service Due Flag check box if you want a notification to be sent out when an asset in the chosen group comes due for repairs.
        
    • iOn Speed Alert: In the Speed field, type the speed at which you want to set off the notification (such as 65 to trigger the alert if an asset in the group travels 65 mph or over).
        
    • iOn Speed Alert [PSL]: On the Amount Over Posted Speed Limit line, type the value over the speed limit you want to set off the alert (such as 10 to trigger the alert at a speed of 65 mph in a 55 mph zone).
        
  14. Scroll down to the Notification Actions section.
      
  15. Select the Email and/or SMS On/Off toggle ( means selected, and deselected) to have the notification sent to the concerned parties (such as one of your organization's iOn administrators, a driver supervisor, or yourself) by email or text and then follow step 16 and/or 17, respectively.
    Note: Specifying at least one email or mobile number is required before you can save the alert.
  16. For Email, follow these steps:
      
    1. Type (or copy and paste) the first recipient's email address on the Primary Recipients line.
       
    2. If you want the notification to be sent to multiple people, type a comma after the first address and then enter the next recipient's email address (and so on).
      Note: You can now include a space after the comma. (Previously, this caused an error, but now, it's acceptable to either space the email addresses out or leave no space between them.)
    3. To add carbon copy (CC) recipients, click Add Secondary Recipients and enter their email addresses where "CC: Enter email(s)" appears.
        
    4. On the Email Subject line, type the email subject text (perhaps just the name or description of the alert).
         
  17. For SMS, type the cell phone number of the person you want to receive the text on its Enter Number line, using the format +13175551234.
      
    To add multiple people, place a comma after the preceding phone number and then type the next one.
    Note: You can now include a space after the comma. (Previously, this caused an error, but now, it's acceptable to either space the phone numbers out or leave no space between them.)
  18. Click Done.
       
    If the group you placed the alert in is the one you have selected in the Group Chooser (or is a child of it and you have View Subgroups selected), your new alert will appear in the Admin - Notifications list.

       
    Also, a success message will appear at the bottom of the screen.
      
  19. Click OK to dismiss it. (Or you can wait a few seconds, and it will automatically close.)


Duplicating a Notification


First, find an alert with similar settings to those of the new one you need to add. Then follow these steps:


  1. In the sidebar menu on the left, click .
     
  2. Click Notifications on the flyout menu that appears.
     
    The Admin - Notifications screen will appear.
      
  3. If the notification you want to copy is in a subgroup of the one you have selected in the Group Chooser, make sure that View Subgroups is chosen at the bottom of the screen.
     
  4. In the row of the alert, click at the far right. (To find it, you can sort or filter the Name column, if needed, as shown in Sorting and Filtering Column Data.)
      
  5. Click Clone Notification.
     
    The Clone Notification dialog box will appear.
      
  6. Type the name to use for the alert in the Notification Name field.
     
  7. If you would like to place the notification in a different group, click the Group drop-down arrow and select the group from the list.
    Note: Only assets in the group you choose will trigger the notification you configure, plus its subgroups if you make the alert inheritable.
     
    Assets in groups that are higher up in your organization's hierarchy (such as the specified group's parent group) will NOT trigger the notification.
     
    If you want the new notification to be activated by all your assets, place it in your top-level group (and leave Inheritable selected).

  8. To choose a different type of notification, click the Notification Type drop-down arrow and select the new one, depending on what you want the alert to be triggered by.
    Note: For a description of the alert types, see step 6 in the preceding section, "Creating a New Notification from Scratch."
  9. If the alert should be triggered and sent only during a certain portion of the day, click the Schedule drop-down arrow and select the name of the schedule.
    Note: You will only be able to apply schedules in the same group as the notification (or a schedule from a parent group that is inheritable).

    As mentioned earlier, you should create the schedule before applying it to the notification. See Adding a Schedule for details.
    You can remove a currently assigned schedule by selecting None from the Schedule drop-down list.
     
    After you select a schedule, a new field will appear to its right, Schedule Reference.
      
  10. Normally, you will click the Schedule Reference drop-down arrow and select Inside Schedule (or leave it chosen), which means that the alert is sent out during the hours set by the schedule.
     
    If the notification should be triggered and sent during the exact opposite segment of the day from the schedule, click the Schedule Reference drop-down arrow and select Outside Schedule instead.
    Note: Outside Schedule was designed primarily for customers who wanted to make sure that their drivers weren't operating their vehicles outside of their authorized work hours. You could set up such a notification by following the steps in Adding an Unauthorized Usage Notification.
  11. To clarify what the notification is designed to inform the user about, select the text in the Description field and type your new explanation.
     
  12. To change the priority level of the alert, click the Severity drop-down arrow and select Low, Medium, High, or Urgent (formerly Critical).
     
  13. Normally, you will leave the Status field set to Enabled.
    Note: If the notification is set to Disabled or Suspended, its triggering event won't be looked for, and the alert won't be reported to iOn. But this won't likely be what you want when you are adding a new notification.
  14. If you want the alert to be triggered by assets in subgroups of the group it is assigned to (so the subgroups, or child groups, inherit the notification from the parent group), make sure that Inheritable is selected.
     
    If you want it to be sent out only for that single group's assets, deselect Inheritable.
     
  15. Set the triggering event according to the type of notification you selected.
    Note: For guidance on the trigger values to choose, see step 13 in the preceding section, "Creating a New Notification from Scratch."
  16. Scroll down to the Notification Actions section.
      
  17. To change or add recipients, select or deselect the Email and/or SMS On/Off toggle ( means selected, and  deselected); these options have the notification sent to the concerned parties (such as one of your organization's iOn administrators, a driver supervisor, or yourself) by email or text.
     
    Then follow step 18 and/or 19, respectively.
    Note: You'll have to have at least one email or mobile number set up to receive the alert in order to save its changes.
  18. For Email, follow these steps:
     
    1. Type (or copy and paste) the first recipient's email address on the Primary Recipients line.
       
      You can remove a previous recipient by selecting their address and deleting it.
       
    2. If you want the notification to be sent to multiple people, type a comma after the first address and then enter the next recipient's email address (and so on).
      Note: You can now include a space after the comma. (Previously, this caused an error, but now, it's acceptable to either space the email addresses out or leave no space between them.)
    3. To add carbon copy (CC) recipients, click Add Secondary Recipients and enter their email addresses where "CC: Enter email(s)" appears.
        
    4. On the Email Subject line, you can update the email subject text by selecting it and typing a new one (perhaps just the name or description of the alert).
         
  19. For SMS, type the cell phone number of the person you want to receive the text on its Enter Number line, using the format +13175551234.
     
    You can remove a previous recipient by selecting their number and deleting it.
      
    To add multiple people, place a comma after the preceding phone number and then type the next one.
    Note: You can now include a space after the comma. (Previously, this caused an error, but now, it's acceptable to either space the phone numbers out or leave no space between them.)
  20. Click Done.
       
    If the group you placed the alert in is the one you have selected in the Group Chooser (or is a child of it and you have View Subgroups selected), your new alert will appear in the Admin - Notifications list.
       
    Also, a success message will appear at the bottom of the screen.
      
  21. Click OK to dismiss it. (Or you can wait a few seconds, and it will automatically close.)