Notifications

Topics in this document:

• Notifications
  • Create notification
  • Details notification page
  • Update notification
  • Delete notification
  • Notification scopes and actions
• Platforms
  • Firebase configuration
    • Requirements and process outline
    • Firebase configuration for EV Charge
      • Create a new project on Firebase
      • Configure Firebase credentials in EV Charge
      • Create a Firebase mobile app configuration - iOS
      • Create a Firebase mobile app configuration - Android

To access this section in EV Charge, from the Menu, select System configuration, and click Notifications.

Notifications

To access this section, click Notifications. A paginated list of all notifications is shown in a tabular format.

Four actions/subpages can be performed/viewed under this section, namely:

• Create notification
• Details notification page
• Update notification
• Delete notification

Create notification

Under notifications, to create a notification, click Create. Provide a name and code.

Publishers is used to configure what type of notification will be sent: SMS, push notification, URL, Email, and Log. It is also used to configure where the notification will be sent using Receivers.

List of applicable Receiver-value pairs for the publishing type:

• Base: Notification targets plain destination contact data, depending on publisher type (email address, phone number or URL).

• Customer: Notification targets to the destination of customer’s primary contact info, depending on publisher type (email address, phone number, URL, push notification), if action is related to the specific customer. Additionally, as a value, Customer Type group can be selected, meaning that notification will apply only if the customer belongs to the specific customer group.

To create a publisher, under Publishers, click Add publisher. The action and number of retries specify the type of notification that will be sent and how many times to resend in case of a failure—for instance, sending out an email that will resend three times, suppose it fails.

Under each publisher are Receivers. The Receivers refers to where the notification will be sent. It can be a URL or a customer (if it is an email or SMS).

The Scope typifies what will trigger the notification, which can be a change in the charging infrastructure or a change in the charging session.

Once a specific action from the scope occurs, you can add filtering options. To add a filter, under Filters, click Add filter.

Example of a notification

• Scope: Charging sessions
• Action: Battery percentage
• Filter: Battery percentage equals 80% (Reached 80%)

Details notification page

Under notification, to see the full details of a notification, click Details. It contains the following information:

• Name
• Code
• Action
• Scope
• Publishers
• Filters (if any)

Update notification

Under notification, to update a notification, first, click Details; it shows the details of the notification. Then to update, click Update.

Delete notification

Under notification, to delete a notification, click Delete.

Notification scopes and actions

Notification scope defines the triggering event scope of EV charging related notifications.

There are currently two scopes of EV charging related notifications:

• Charging infrastructure: Notification of charging infrastructure related operations. See Table 1 for applicable actions in the scope.
• Charging sessions: Notification of charging session control related operations. See Table 2 for applicable actions in the scope.

Table 1. Charging infrastructure actions/events.

Table 2. Charging session control events/actions.

Platforms

To access this section, click Platforms.

Platforms entail configuring third-party services to enable notifications. It includes Twilio for text messages and Firebase for push notifications.

To enable Firebase for push notifications in EV Charge, see Firebase Configuration.

Firebase configuration

Requirements and process outline

1. A Google account is required in order to set up Firebase.
2. You configure Firebase for EV Charge.
3. Tridens provides either:
   • App - Apple ID
   • App - Android Package Name
4. You configure iOS or Android apps on Firebase.
5. You provide either:
   • GoogleService-Info.plist file (iOS platform)
   • google-services.json file (Android platform)

Firebase configuration for EV Charge

Visit your Firebase portal at https://firebase.google.com/ and click Get started or Go to console.

Figure 1: Firebase portal

Create a new project on Firebase

Create a new project by clicking Create a project.

Figure 2: Create a project

Follow the steps to create a new project.

Figure 3: Create a project - step 1

Figure 4: Create a project - step 2

Figure 5: Create a project - step 3

Configure Firebase credentials in EV Charge

After returning to the Project Dashboard, click Project settings.

Figure 6: Project settings

Go to Service accounts and click Generate new private key.

Figure 7: Generate new private key

After confirming key generation, a JSON file will be downloaded to your computer.

Figure 8: Confirm key generation

The JSON file from the previous step contains your Firebase private key credentials—it can be opened in a text editor.

Figure 9: Private key JSON file contents

Next, visit EV Charge, navigate to System configuration Notifications Platforms. Click Firebase (FCM), then enter the credentials (which are: client ID, client email, project ID, private key ID, and private key) into the form. Finish by clicking Submit.

Figure 10: Firebase configuration on EV Charge

You have successfully configured Firebase for EV Charge.

Create a Firebase mobile app configuration - iOS

Go to the Project Dashboard on Firebase and enter the Project settings.

Figure 11: Project settings

Under the General tab, scroll to Your apps and select the iOS platform.

Figure 12: Add iOS app configuration

In the first step, enter the Apple ID (provided by Tridens) and click Register app.

Figure 13: iOS app configuration - Step 1

In the second step, download the GoogleService-Info.plist config file and provide it to Tridens to include it in your app build, then click Next.

Figure 14: iOS app configuration - Step 2

Click Next on steps 3 and 4, then Continue on step 5. This will return you to the Project Settings page, where your iOS app configuration will be visible. You can also re-download the GoogleServiceInfo.plist file here.

Figure 15: iOS app configuration - finished

Create a Firebase mobile app configuration - Android

Go to the Project Dashboard on Firebase and enter the Project settings.

Figure 16: Project settings

Under the General tab, scroll to Your apps and select the Android platform.

Figure 17: Add Android app configuration

In the first step, enter the Android package name (provided by Tridens) and click Register app.

Figure 18: Android app configuration - Step 1

In the second step, download the google-services.json config file and provide it to Tridens to include it in your app build, then click Next.

Figure 19: Android app configuration - Step 2

Click Next on step 3 and Continue on step 4. This will return you to the Project Settings page, where your Android app configuration will be visible. You can also re-download the googleservices.json file here.

Figure 20: Android app configuration - finished