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}
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:
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?
Zoho DataPrep Resources
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 integration with Pipedrive
Available only in Enterprise edition and in US data center Zoho Sign now integrates with Pipedrive, customer relationship management software that helps small and medium businesses to manage their sales pipeline. This integration can help sales team ...Accessing Zoho Sign from Zoho PeoplePlus
This page lists the actions supported via Zoho Sign in the Zoho PeoplePlus bundle. This includes both the actions supported via native integrations between Zoho Sign and the products in the bundle and the actions accessible directly from the Zoho ...Integrating Zoho Sign with Zoho CRM
Zoho Sign can be integrated with Zoho CRM, our company's flagship customer relationship management software. Zoho CRM helps thousands of small and medium-sized enterprises across the globe streamline their sales processes. With the Zoho Sign ...
New to Zoho LandingPage?
Zoho LandingPage Resources