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:
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 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 ...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 creation in Zoho Sign
Available in all plans and in all data centres Document creation in Zoho Sign allows users to draft or generate documents using AI without having to switch between applications. Let us assume you are a sales executive who wants a customised proposal ...PDF editing in Zoho Sign
Available in the Enterprise edition and in all data centres PDF editing in Zoho Sign allows users to make last-minute adjustments to documents while they configure the signing workflow. This eliminates the need to switch back to a word processor, ...
New to Zoho LandingPage?
Zoho LandingPage Resources