Scenario 

1. The manufacturer uses a Zoho Creator form to capture generator, buyer, and service personnel details.
   
2. Each submitted generator record is sent to Zoho IoT for processing.
   
3. In Zoho IoT, the generator is created as a device with datapoints for monitoring.
   
4. Buyer must be able to monitor the generator parameters in the Zoho IoT application after purchase.
   
5. Critical events must generate alarm rules in Zoho IoT, and send email alerts to buyers and service personnel.
   
   

Prerequisites   

1. Have valid accounts with the required licenses in Zoho Creator and Zoho IoT.
   
2. In Zoho Creator, create a form to capture generator details, buyer information, and service contacts (use separate forms if needed).
   
3. Configure a Workflow in Zoho Creator to send the captured details to Zoho IoT via a POST API call in a Custom Function, authenticated through a Zoho IoT connection.
   

1. A Zoho IoT application must be set up to monitor the generator's key parameters such as fuel level, temperature, and voltage in real time.
   
2. Create the Device Model for Generator with the required Datapoints.
   
3. Create Custom Fields in the model to store the buyer and service personnel email ID.
   

Implementation    

1. Create Device Model with Custom Fields (in Zoho IoT) - To receive the Diesel Generator details and store the device, buyer, and service personnel details sent from Zoho Creator.
   
2. Configure Connections (in Creator) - To execute the APIs call inside the custom function, we need to have connections as authentication for respective APIs at Zoho Creator.
   
3. Create Form (in Creator) - To input the generator details, buyer information, and service contacts (use separate forms if needed).
   
4. Create Workflow (in Creator) - To send the captured details to Zoho IoT via a POST API call in a Custom Function, authenticated through a Zoho IoT connection.  
   
5. Set Up Monitoring with Alarm Rules (in Zoho IoT) -  Configure alarm rule that will be  triggered based on real time data. Here, you can send mails to the buyer and service person on any malfunction based on criteria.
   

Procedure 

Step 1: Create Device Model with Custom Fields in Zoho IoT
 

1. Create the device model Diesel Generator, and add the required datapoints (fuel level, temperature, voltage in the IoT application.)
   

Note: You can also create Endpoint devices in Zoho IoT to receive data from third-party applications. When creating the end point device, you must provide the endpoint URL and authentication details.

2. Create Custom Fields to store the buyer and service personnel email ID.

Image: Custom Field creation for storing email IDs.

On completing the above device creation procedure, the received Diesel Generator data can be stored as a new device record for monitoring.

Image: Device List View after adding the "Blue Star Generator".

Note: The generator must have the intelligence to send real-time reading of fuel/ temperature/ voltage readings to the Zoho IoT Application for it to monitor the device.

Step 2: Configure Connections 

1. Access your Zoho 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 Connect button. (You can also select only the specific actions radio button to select required options.)
   
   
   
   
6. Provide your application name as the subdomain. For example if your application url is "energymonitoring.zoho.com", provide "energymonitoring" as your subdomain.
   
   
   
   
7. Click Accept in the resultant screen.
   

The connection is created and displayed in the Connections home page.

Step 3: Create Form 

1. Create a Form in Zoho Creator to get the Generator, Buyer email ID, and Support person email ID details.  
   
   
   
   Image: Sample creator form with generator, buyer, and service person details. 

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 Zoho Creator.
   
3. Send the captured generator details to Zoho IoT for device creation.
   

Step 5: Set Up Monitoring and Alarm Rules in Zoho IoT
 

1. Configure Alarm Rules in Zoho IoT to detect abnormal or critical events (e.g., excessive temperature, voltage, etc.) for the generator.
   
   
   
   
2. Trigger an Email Notification (or Notification Profile)
   
   
3. Configure a Email Notification in Alarm Rule to automatically sends an email alert to the buyer or service personnel.
   
4. The email includes relevant details about the alarm and service requirements.
   
   
   
   

Conclusion