Creating custom functions

Generating deluge scripts using Zia

Zia Assistant can generate Deluge scripts for custom functions based on the prompt. Instead of writing code from scratch, users can simply explain what they need and Zia will generate an appropriate script. Earlier, building custom functions meant having hands-on experience with Deluge, writing the code, testing it, and validating everything before deployment. With Zia’s integration, that technical barrier is reduced, making automation creation faster and more accessible.

For example, if you want the customer’s email description to be extracted and auto-populated as the ticket description. Instead of manually writing a Deluge script, you can provide the following prompt to Zia Assistant which will generate a ready-to-use script: "Whenever a ticket is created from email channel, fetch the email body and the latest email thread content and update it in the ticket description field." Based on this requirement, Zia Assistant Bot generates a structured Deluge script that retrieves the most recent email thread and updates the ticket description automatically such as:

Enabling deluge assistant bot

Support administrators can enable Zia Deluge Assistant bot based on their requirements. Zia Deluge Assistant bot is disabled by default and must be enabled manually before it becomes available in Custom Functions.

Note:

1. This setting is organization-specific. Enabling it will make the Deluge Assistant available only for the current organization.
2. Zia Deluge Assistant is available only for custom functions within workflows.
   

To enable Zia deluge assistant bot

1. Navigate to Setup > Zia > Generative AI.
2. Under Feature Preferences, enable Zia Deluge Assistant.
3. In the Data usage of disclosure for AI alert click Accept.

1. Navigate to Setup ( ) > Automations > Workflows > Custom functions.
   
2. Click New Functions.
   
3. Under Basic Information:
1. Enter a Name and Description for the function.
2. Select the Module in which the function needs to be triggered.
4. Under Argument Mapping, do the following:
1. Provide the Method Name.
2. To map the function to a custom value, enter the Argument Name and select the corresponding value.
3. Click the Add ( )  icon to add more arguments, and repeat the same steps as required.
5. Write the required logic in the Deluge Script Editor.
6. Deluge script can be written manually or generate it using the Zia Deluge Assistant Bot.
1. Click the Zia icon at the bottom-right corner of the Deluge Script Editor.
2. Enter your requirement as a prompt and click the Send icon.
3. Once satisfied with the generated script, click the Copy icon at the top-right corner of the script window.
4. Paste the copied script into the Deluge Script Editor.
   
   
7. Click Save to edit or execute the script later.
8. Click Save & Execute Script to validate and run the code.
   

Limitations

1. Function Executions - 50000 calls/day
   
2. Statements - 200000 statements/function
   
3. Integration Tasks - 500000 API calls/month
   
4. Invoke URL - Unlimited calls
   
5. Send Email - 2500 emails/day
   
6. Custom function execution is limited to two iterations to maintain system performance, prevent unnecessary API calls, and avoid potential data issues.
   

Error messages and details

Here is the list of failure messages you might encounter while using custom functions:

1. Error executing email task - A 'send mail' task could not be executed.
2. Error evaluating invoke api task : {0} - API calls could not be executed.
3. Wrong DataType specified. The Template Variable {0} should be of type {1} - You had mentioned a data type as string but had provided an integer value in the 'set variable' task.
4. Error in executing {0} task - An integration task could not be called under the 'call function'.
5. Unable to update template variable {0} - An expression could not be executed.
6. Error evaluating INVOKE URL Function - Either the configured parameters are wrong or there is no proper response from the URL.
   

Deploying custom functions in workflow rules

Custom functions can be deployed within workflow rules after they are tested and validated. For example, a function can be created to automatically set ticket priority based on customer type. Once the function is tested, it can be attached to a workflow rule so that whenever a ticket is created for a premium customer, the function runs and updates the priority to high automatically.

To associate a function to a workflow rule

1. Navigate to Setup > Automation > Workflows.
2. Click Create Rule on the Workflow Rules page.
3. Enter the basic information about the workflow and click Next.
4. In the following page, specify the action for execution and rule criteria.
5. Under Actions, click the Add icon  ( ) .
6. Select an existing custom function.
7. Click Save.