Notification Profile Custom Function
In Zoho IoT, notification profiles are configurations that determine how and when notification related actions should be executed in response to alarms - either when a new alarm is created or when its status changes (severity, acknowledgement, resolution, etc.). A custom function linked to a notification profile enables you to implement tailored business logic or integrations whenever those alarm events occur.
This document explains how to create a notification profile custom function, how to associate it with a notification profile, and provides an example code demonstrating its use.
Creating a notification profile custom function
To create a notification profile custom function,
- Access the custom functions list view page.
- Click Add Custom Function.
- Select Notification Profiles in the Category field.
- Provide the required details in the appropriate fields.
Example -
Language : Deluge
Model/Module: All Device Models (Select the model on which the device, asset, or location is based on)
Display Name: Create Device Disconnect Work Order (Provide a name of your choice)
Function Name: create_disconnect_work_order (Provide a name of your choice)
Description: A custom function to create a work order every time a gateway device is disconnected from the application.
- Click Save. This will open the Code Editor.
- Provide the required code.
- Click Save and Close.
Notification Profile Custom function sample code
Below is an example of how notification-profile custom functions can be used to automate actions when alarm-related events occur. In this scenario, the notification profile includes two custom functions: one that creates a new record whenever a gateway device is disconnected, and another that escalates a specific field value from High to Urgent when the alarm’s severity changes. Because the notification profile is triggered by these alarm events, both custom functions run automatically, ensuring timely record creation and proper escalation without requiring manual intervention.
This custom function creates a work order every time a gateway device disconnects. This is configured as the notification action.
json_string = {"workorder":{"Name":"Reconnect " + gateway_name,"Gateway_Name":gateway_name,"Gateway_Location":gateway_location,"Order_Status":"High","Alarm_ID":alarm_id},"Gateway_ID":gateway_id};response = invokeurl[url :"https://app12345akyrw.zohoiot.com/iot/v1/workorder"type :POSTparameters:json_string + ""connection:"iot-connection"];info response;
This custom function updates work order status to Urgent if the issue isn't fixed within the define limit. This is configured as the escalation action.
filter = {"condition_text":"1","conditions":{"1":{"field":{"api_name":"Alarm_ID"},"comparator":"equal", "value":alarm_id}}};appUrl = "https://app12345akyrw.zohoiot.com/";get_url = appUrl + "/iot/v1/workorder?filter=" + encodeUrl(filter);response = invokeurl[url :get_urltype :GETconnection:"iot"];workorder_id = response.get("workorder").get(0).get("id");status_response = response.get("workorder").get(0).get("Order_Status").get("display_value");if(status_response == "High"){json_string = {"workorder":{{"id":workorder_id,"Order_Status":{"display_value":"Urgent"}}}};response_put = invokeurl[type :PUTparameters:json_string + ""connection:"iot"];info "RESPONSE:: " + response_put;}
Associating to a notification profile
Once the custom function is created, it becomes available for selection when configuring a notification profile. You can associate the custom function in the Choose Actions field while creating or editing a notification profile.
While adding/editing a notification profile,
- Click Choose Action. This opens the Notification, Escalation, or Resolution action panel, depending on the action you want to configure.
- Click Add Action.
- Select Custom Function in the context menu.
- Select the required custom function and click Associate.
- Click Save in the action panel.
- Click Save in the notification profiles form.
The custom function will now be executed each time the notification profiles conditions are met.
Access your files securely from anywhere
Zoho CRM Training Programs
Learn how to use the best tools for sales force automation and better customer engagement from Zoho's implementation specialists.
Zoho DataPrep Personalized Demo
If you'd like a personalized walk-through of our data preparation tool, please request a demo and we'll be happy to show you how to get the best out of Zoho DataPrep.
- Zoho Workerly Home
- Forums
- Connect With Us:
- Zoho Recruit Home
- Forums
- Connect With Us:
New to Zoho Writer?
Create. Review. Publish.
New to Zoho CRM Plus?
Deliver unforgettable customer experiences
New to Zoho CRM Plus?
Deliver unforgettable customer experiences
New to Zoho Marketing Plus?
Everything you need to run your marketing
New to Zoho Marketing Plus?
Everything you need to run your marketing
You are currently viewing the help pages of Qntrl’s earlier version. Click here to view our latest version—Qntrl 3.0's help articles.
New to Zoho Survey?
Zoho Sheet Resources
Zoho Forms Resources
New to Zoho Sign?
Zoho Sign Resources
Sign, Paperless!
New to Zoho TeamInbox?
Zoho TeamInbox Resources
New to Zoho ZeptoMail?
Design. Discuss. Deliver.
New to Zoho Workerly?
New to Zoho Recruit?
New to Zoho CRM?
New to Zoho Projects?
New to Zoho Sprints?
New to Zoho Assist?
New to Bigin?
Related Articles
Working with Notification Profiles
Notification Profile actions can be triggered based on various conditions. This document provides steps to create and automate notification profile actions under the Notification, Escalation, and Resolution action sections. Refer to the Understanding ...Understanding Custom Functions
Custom functions in Zoho IoT allow you to extend the platform's capabilities. These functions are written using various programming languages and are easy to construct. With custom functions, users can move beyond the default offerings of the ...Adding and managing custom functions
Adding Custom Functions A custom function can be added for one of the below listed categories, each corresponding to a specific feature in the application. Once created, the custom function becomes available for the feature in the selected ...Alarm Rule Custom Function
When an Alarm Rule is configured in Zoho IoT, you define the condition under which the alarm should be raised. As part of this configuration, you can specify a custom function to run as the end action. Each time the alarm is triggered, the associated ...Configuring Push Notification
Note: The Push Notification feature is currently in its beta stage with further enhancements planned in the product roadmap. Contact support@zohoiot.com for more details. Push notifications are the preferred action for delivering real-time alerts ...
New to Zoho LandingPage?
Zoho LandingPage Resources