How to Set Up Custom Workflows with Deluge Script in Zoho Writer?
Overview
Custom Functions in Zoho Writer allow you to add automation, logic, and integrations to document workflows. Using Deluge scripts, you can program actions to occur immediately after a document is merged, filled, signed, PDF combined or when a workflow is completed.
Where can custom functions be used in automation?
You can execute a custom function in Zoho Writer at various stages of a document workflow:
- After the merge is complete
- After the merged document is stored
- After a user submits a fillable document
- Once the document signing process is complete
These trigger points allow you to automate follow-up actions such as storing files, updating records, notifying stakeholders, or integrating with other apps and services.
Prerequisites (while using API)
Before using Merge and Email, Merge and Sign, Sign, or Combine and Store APIs, ensure you access the 'Automate' panel from the Writer UI at least once before sending the API request.
Steps to Configure Custom Actions
Step 1: Open Deluge Editor
- For Merge Templates: Choose the required Merge Output Option > Select Configure Execute Function to open the Deluge editor.
- For Fillable Templates: Under "On Submission", choose Trigger Webhook and Custom Function.
- For Sign Templates: Select Send for Sign > Enable Execute Custom Function > Configure.
Step 2: Choose or Create a Function
- Create a new custom function using Deluge scripting.
- Or, use a prebuilt function from the gallery
Step 3: Create a Connection
Connections are used to authenticate requests sent to external services and can be integrated into Custom Functions in Zoho Writer. They enable you to retrieve data from other services directly into your document workflows.
To use a connection in a custom function:
- You must create the connection that links Zoho Writer with the external service.
- Then, write a custom function that uses this connection to fetch or send data as needed.
To know how to create a connection, refer to this help link.
Step 4: Save & Link the Function
- After writing the Deluge script, click Save & Link to associate the function with the relevant output event (e.g., After Merge).
Limitations of Deluge Custom Functions
Limitation | Description |
Execution Timeout | Max 5 minutes per function execution. Max 40 seconds per invoke url task. |
File handling size | Max upto 20MB |
Recursive Calls | Recursion is not supported. |
No Multi-threading | Scripts run sequentially; parallel execution isn't allowed. |
Frequently Asked Queries
1. Can I execute Custom Functions on templates/documents shared with me?
Yes. The function executes using the creator's authorization and access rights.
Yes. The function executes using the creator's authorization and access rights.
2. How to create a dynamic table and pull subform records using Deluge?
Refer to this article for details on handling subform data.
Refer to this article for details on handling subform data.
3. Can I trigger a Deluge function after an approval workflow is completed?
Yes. In your merge template, choose Merge > Send for Approval, enable Execute Custom Function, and configure it to move the document to Zoho Contracts.
Yes. In your merge template, choose Merge > Send for Approval, enable Execute Custom Function, and configure it to move the document to Zoho Contracts.
4. How can I attach a merged document to a CRM record?
Use Merge & Store > After Merge > Execute Custom Function and configure using the Attach to CRM Record gallery function.
Use Merge & Store > After Merge > Execute Custom Function and configure using the Attach to CRM Record gallery function.
Troubleshooting
Error/Symptom | Possible Cause | Recommended Solution |
Error R6000 during merge | Syntax error in Deluge script | Use colon instead of comma when mapping merge_data. Example: merge_values.put("merge_data", {"data": mp}); Refer to this article for error details. |
Images from Inventory not showing | Inventory image URL not accessible | Upload image to WorkDrive via Deluge, get public URL, and use that in merge field. Refer to this article for more details. |
Error R3000 when merging and saving to WorkDrive | Missing scope | Include WorkDrive.files.ALL for WorkDrive folders in OAuth scopes |
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
How to Configure Document Workflows in Zoho Writer
Overview Zoho Writer’s Document Workflows streamline how documents are reviewed and approved within your team. Workflow Types: Review Workflow – Collect peer feedback. Approval Workflow – Obtain formal sign-off. Review + Approval Workflow – ...How to Create a Connection via Deluge in Zoho Writer?
Overview Deluge connections in Zoho Writer allow you to securely integrate external services using authentication protocols. These connections can be leveraged in custom functions to retrieve or send data across platforms, enabling powerful ...Configure workflow in Zoho Projects with Writer's mail merge
Zoho Writer and Zoho Projects' integration allows collaboration and document management for project teams. Project managers can automate the creation of critical documents using Zoho Writer's custom functions and workflow rules. The integration also ...How to run custom workflows after merging a document
Overview Zoho Writer allows you to automate post-merge tasks by executing custom Deluge functions immediately after a document merge is completed. This is useful for triggering workflows such as sending notifications, updating CRM records, or storing ...Configure workflow in Zoho Books with Writer's mail merge
With the Zoho Books and Zoho Writer merge integration, you can easily generate customized documents, like shipping labels or invoices, directly from your Zoho Books data. For instance, if you need to create labels for customer orders that include ...
New to Zoho LandingPage?
Zoho LandingPage Resources