Scenario   

Prerequisites 

Accounts and Access

1. Active Zoho Creator and Zoho IoT accounts with valid licenses.
   
2. Necessary permissions to access, create, or modify applications in both platforms.
   

Zoho Creator – Zylker Sales Manager

1. A Zoho Creator application named Zylker Sales Manager is available.
   
2. The app includes a Sales Form to record generator sales, capturing details such as:
   
3. Generator model and serial number
   
1. Buyer name and email
   
2. Assigned service engineer name and email
   
3. Sale or installation date
   

Zoho IoT – Zylker Generator Monitor

1. A Zoho IoT application named Zylker Generator Monitor is created.
   
2. A Diesel Generator device model exists with key telemetry datapoints such as:
   
1. Fuel Level
   
2. Temperature
   
3. Voltage
   
4. and other parameters relevant to generator performance monitoring.
   

1. The device model includes custom fields for storing:
   
1. Buyer Email ID
   
2. Service Engineer Email ID
   
   
2. Alarm rule(s) configured to send email notifications to buyer when fuel level (or other datapoints) reach critical thresholds.
   

Implementation    

1. Configure Connections - To run API calls inside a custom function, a connection in  Zylker Sales Manager is required to authenticate the respective APIs.
   
2. Configure Workflow - To send the captured details to Zylker Generator Monitor via a Custom Function, authenticated through a Zoho IoT connection.   
   

Procedure  

Step 1: Configure Connections  

1. Access Zylker Sales Manager (Creator application).
   
2. Select MIcroservices under DEVELOP in the left menu.
   
3. Select the Connections tab, and click Create New or Add Connection.
   
   
   
   
4. In the Add Connection screen, select Zoho IOT service.
   
   
   
   
5. Provide the Connection details, and click the Create and Authorize button. (You can also select Only Specific Action radio button to select required options.)
   
   
   
   If the required action/scope is not available under the selected Zoho IoT connection, you can create a custom service and create a connection for this service. Please refer to the deluge custom service document for more details. 
   
   
6. Provide your application name as the subdomain, and click Authorize. For example if your application url is "dgmonitoring.zylker.com", provide "dgmonitoring" as your subdomain.
   
   
   
   
7. Verify the access permission list, select the "I allow Zoho Creator - Zoho IOT Integration to access the above data from my Zoho account" check box, and click Accept.
   
   
   
   
8. The connection is created and displayed in the Connections home page.
   
   
   
   
9. Click on the Connection to view the details. You can copy the connection name (link name) from this screen. 
   
   
   
   
   
   
   
   

Step 2: Create Workflow  

1. Select the Workflow tab on top, and select Create Workflow to create a new workflow.
   
   
   
   
2. Provide the form and action detail in the workflow
   
   
   
   Image: Sample creator workflow configuration
   
   
3. In the workflow action, call a custom function (Deluge Script).
   
   
   
   
4. In the custom function script, include the following:
   
1. Use the Zoho IoT POST API.
   
2. Use the Zoho IoT connection created in Zylker Sales Manager (Creator).
   
3. Send the captured generator details to Zoho IoT for device creation.
   

Step 3: Write Custom Function Script

Conclusion