How do I set up a callback function in CRM to add Zoho Sign document details?
Scenario: I have set up an automation in ZohoCRM to send documents to Zoho Sign. Each time I want to view the documents, I need to view them at Zoho Sign. It is difficult to view the document status this way. Can I set up a callback function in CRM to add Zoho Sign document details?
- When documents are sent for signature from CRM using Zoho Sign's extension, the documents will be updated in CRM. However, in other instances such as automation and workflow, this will not be done.
- You need to create a custom callback function, which can be done by following these steps.
Paste the following code:
- crmAPIRequestMap = crmAPIRequest.toMap();
- request_body = crmAPIRequestMap.get("body");
- info request_body;
- requestMap = request_body.toMap();
- response = Map();
- response.put("status_code",200);
- response.put("Content-Type","application/json");
- hasRequests = requestMap.containKey("requests");
- if(requestMap.containKey("requests") && requestMap.containKey("notifications"))
- {
- notificationMap = requestMap.get("notifications").toMap();
- requestStr = requestMap.get("requests");
- requestObj = requestStr.toMap();
- response.put("body",{"what we got":requestObj,"notification":notificationMap});
- if(requestObj.containKey("request_status") && notificationMap.containKey("operation_type"))
- {
- operationType = notificationMap.get("operation_type");
- //if(requestObj.get("request_status").equals("completed"))
- if(operationType.equals("RequestCompleted") || operationType.equals("RequestSigningSuccess") || operationType.equals("RequestRecalled") || operationType.equals("RequestRejected") || operationType.equals("RequestExpired"))
- {
- requestStatus = "Out for Signature";
- if(operationType.equals("RequestCompleted"))
- {
- requestStatus = "Signed";
- }
- else if(operationType.equals("RequestRecalled"))
- {
- requestStatus = "Recalled";
- }
- else if(operationType.equals("RequestRejected"))
- {
- requestStatus = "Declined";
- }
- else if(operationType.equals("RequestExpired"))
- {
- requestStatus = "Expired";
- }
- requestId = requestObj.get("request_id");
- //Check if already exists
- zsignrecord = zoho.crm.searchRecords("zohosign__ZohoSign_Documents","(zohosign__ZohoSign_Document_ID:equals:" + requestId + ")");
- if(zsignrecord.size() > 0 && zsignrecord.get(0).containKey("zohosign__DeleteEdit_Preview_or_Position_Signature_Fields"))
- {
- info "Record already present";
- response.put("body",{"message":"Record already present, updating"});
- if(zsignrecord.get(0).get("zohosign__DeleteEdit_Preview_or_Position_Signature_Fields") == false)
- {
- //Needs to be updated
- zsrecordId = zsignrecord.get(0).get("id");
- recordInfo = {"zohosign__Document_Status":requestStatus};
- resp = zoho.crm.createRecord("zohosign__ZohoSign_Documents",zsrecordId,recordInfo);
- if(resp.containKey("id"))
- {
- response.put("body",{"message":"Updated record"});
- }
- }
- else
- {
- return {"crmAPIResponse":response};
- }
- }
- else
- {
- response.put("body",{"request_id":requestId});
- associatedModule = "Contacts";
- associatedModuleKey = "zohosign__Contact";
- actions = requestObj.get("actions");
- email = actions.get(0).get("recipient_email");
- records = zoho.crm.searchRecords("Contacts","(Email:equals:" + email + ")");
- if(records.size() <= 0)
- {
- records = zoho.crm.searchRecords("Leads","(Email:equals:" + email + ")");
- if(records.size() > 0)
- {
- associatedModule = "Leads";
- associatedModuleKey = "zohosign__Lead";
- }
- }
- if(records.size() > 0)
- {
- info "Record found";
- leadid = records.get(0).get("id");
- recordInfo = {"Name":requestObj.get("request_name"),associatedModuleKey:leadid,"zohosign__Document_Status":requestStatus,"zohosign__ZohoSign_Document_ID":requestId,"zohosign__Date_Completed":today,"zohosign__Module_Name":associatedModule,"zohosign__Module_Record_ID":leadid};
- //Create ZohoSign Record in CRM
- resp = zoho.crm.createRecord("zohosign__ZohoSign_Documents",recordInfo);
- if(resp.containKey("id"))
- {
- zsDocId = resp.get("id");
- respDoc = zoho.sign.downloadDocument(requestId);
- zoho.crm.attachFile("zohosign__ZohoSign_Documents",zsDocId,respDoc);
- response.put("body",{"attached to record":zsDocId});
- //Create zoho sign recipients record for all recipients
- for each action in actions
- {
- recpStatus = "Waiting for Signature";
- if(action.get("action_status").equals("SIGNED"))
- {
- recpStatus = "Signed";
- }
- else if(action.get("action_status").equals("DECLINED"))
- {
- recpStatus = "Cancelled";
- }
- recpRecordInfo = {"Name":action.get("recipient_name"),"zohosign__Email":action.get("recipient_email"),"zohosign__ZohoSign_Document":zsDocId,"zohosign__Recipient_Order":action.get("signing_order"),"zohosign__Recipient_Type":action.get("action_type"),"zohosign__Recipient_Status":recpStatus};
- zoho.crm.createRecord("zohosign__ZohoSign_Recipients",recpRecordInfo);
- }
- }
- else
- {
- response.put("body",{"error":resp});
- }
- }
- }
- }
- else
- {
- response.put("body",{"not completed":requestObj});
- }
- }
- else
- {
- response.put("body",{"no request status":requestObj});
- }
- }
- else
- {
- info "Error";
- response.put("body",{"error":"No requests key"});
- }
- return {"crmAPIResponse":response}
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:
Zoho FSM Video Tutorials
Centralize Knowledge. Transform Learning.
All-in-one knowledge management and training platform for your employees and customers.
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 CPaaS?
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 set up a callback function in CRM to add Zoho Sign document details that is triggered by the Zoho Sign webhook?
Scenario: Within a Custom module in ZohoCRM, I have set up an automation to send documents to Zoho Sign. Each time I want to view the documents, I need to view them at Zoho Sign. Can I set up a callback function in CRM to add Zoho Sign document ...Zoho Sign credits
What are Zoho Sign credits and what are they used for? Zoho Sign credits are a prepaid add-on that requires an additional purchase on top of the subscription cost of the Zoho Sign general licensing plans. Zoho Sign credits are consumed when users in ...Zoho Sign's integration with n8n
Available in all data centers except Saudi Arabia Zoho Sign can be integrated with n8n, an open-source workflow automation platform, allowing you to connect your signing workflows with hundreds of other applications. With this integration, you can ...Integrating Zoho Sign with Zoho People
Available in all Data Centers. From onboarding documents to exit letters, the HR department handles tons of employee and company information. Most of these documents will require signatures from the employees, after which they need to be returned and ...Document visibility in Zoho Sign
Availability: Enterprise edition Zoho Sign's document visibility feature allows senders to control which documents within an envelope are visible to each recipient. In scenarios involving multiple agreements with an envelope, this feature ensures ...
New to Zoho LandingPage?
Zoho LandingPage Resources