Setting up Functions

How Can I...

Note

All functions programmed by your developers are listed on the Functions page. By this way, programmers can focus on developing Deluge Scripts whereas CRM Administrators can deploy the thoroughly tested functions as per their requirement.

Set Up Functions

You can set up functions in 6 places:

  • Create a standalone function.
  • Associate function to a workflow rule.
  • Use functions later by including them in Schedules.
  • Set the function to get executed upon the click of a Custom Button.
  • Associate a function to a Related List.
  • Associate a function to CRM Fundamentals (Validation rules).

To create a function

  1. Go to Setup > Developer Space > Functions.
  2. In the Functions page, click + Create New Function.
  3. Choose the place where the function is meant to be added.
  4. Click Next.
  5. In the Create Function page, do the following:
    • Give a Name and description(optional) for the function.
    • Click Edit Arguments.
    • Set the arguments to be used in the script, with field name or custom value in CRM module.
    • Write your required function in the Deluge Script Editor.
    • Click Save & Execute Script to validate your code.
    • Click Save.
  6. Click Save.
    The function will be listed in the List View of the Functions page.
    Please note that the functions specified to be used at a particular location cannot be used elsewhere. For example: a function configured for Workflow Rules cannot be used in Schedules.

Calling Functions using REST APIs

A function lets you have additional functionalities and features in your CRM apart from the conventional features. Functions needs a trigger to call it. The trigger could be in the form of a workflow, blueprint, related list or through the click of a button.

If the function needs to be triggered without employing these methods or from external sources, you can create standalone functions and make them available as API calls. Triggering functions through REST APIs which gives the flexibility to trigger it from anywhere inside Zoho CRM or from any third party application.

Sample function as an API call:

A form which automatically generates a lead in your CRM with the information given as input in the form.

Step 1:

Create a standalone function with the following code.

Note:

  • The arguments to be passed for the above function are "FirstName", "LastName", "Company" and "Mobile". Datatype for the arguments is STRING.

Step 2:

To make function available as an API

  1. Go to Setup > Developer Space > Functions.
  2. Click the Settings icon for the corresponding function which needs to be made an API.
  3. Click REST API.
  4. The API Name field displays the API name of the function which you must use to invoke it. This API name is system-generated; you cannot modify it.

  5. Enable OAuth2.0 and the API key sliders.
  6. Click Save.

Note:

  • Select OAuth2.0 for sharing the function as an API within your organization.
  • Select API Key for sharing the function with any third party and enable it to be used by anyone. This API key is static, and does not expire unless revoked. You can regenerate the API key any time by clicking the Regenerate API key button. When you regenerate your API key, the old key becomes invalid and any requests made using the old key will be rejected. This can be beneficial in case your API key is compromised or you need to revoke access for any reason. Please be aware that the API key is common for all the functions, and that regenerating the key will reflect in all the functions. After regenerating the key, make sure to update any applications that use the old key with the new key to ensure that they continue to function properly.
  • Note that only admin users have access to the Regenerate API Key option.

Step 3:

The sample here is shown as a form created using Zoho Creator. Create the form such that it has the fields "FirstName", "LastName", "Company" and "Mobile". You can program the function to get executed upon the click of Submit button.

Result:

Once the Submit button is clicked, the function gets executed and the Lead is created in your CRM. The lead has the details which was given within the form.

Functions in Postman:

Functions which are given as API calls can be tested using POSTMAN application. However, there are a few things that you need to keep in mind when executing a function in that app.

  • The current supported methods for using a function as an API are GET and POST.
  • In a POST request, under the "Body" section, select "form-data".
  • Create a Key named "arguments" and the Value as the Input JSON object.
  • The arguments can also be given in the URL as arguments={encoded_arguments}
  • POST request - Arguments Limit
    • In request URL - 5000 characters
    • In body - 95000 characters (as JSON object)

Sample arguments in "Body":

{
  "First_Name":"Art",
  "Last_Name":"Clayton",
  "Company":"Zylker",
  "Mobile":"555-876-4367"
}

Deploying Functions in Workflow Rules

To associate function to a workflow rule

  1. Go to Setup > Automation > Workflow Rules.
  2. On the Workflow Rules page, click + Create Rule.
  3. In the Create New Rule tab, specify workflow rule parameters.
  4. Under Instant Actions, select Function.
  5. In the Configure Function page, select a function from the Gallery, Functions (Created by users in your organization) or Write your Own using Deluge script.
  6. Click Functions (Created by users in your organization).
  7. Select the function to be triggered and click Configure.
  8. In the Configure Custom Function page, complete the following steps:
    • Select the module to be associated.
    • Under Argument Mapping section, map the argument with field name in CRM module.
      • Click Save.
  9. Click Save on the Workflow rule page.
    Now, your function is associated with the workflow rule. When the workflow rule is triggered, the function will be automatically executed.

See Also - Integrate a function to a Schedule, Custom Button, Validation Rule, and Related List.

To test the function integration

  1. Add test data in Zoho CRM according to your workflow rule criteria.
  2. Check for the data received from Zoho CRM via function, in your application.
  3. Modify your function code in Zoho CRM, if data is not received or if there is a data mismatch.
  4. Continue this test until you obtain the required data from Zoho CRM to your Application.

Important Notes

  • You can associate up to 6 (1 Instant Action and 5 Time-Based Actions) functions per workflow rule.
  • You can execute only 5000 lines (Statements) in a single function call.
  • You can transfer data for a maximum of 10 CRM fields from Zoho CRM to third-party applications using function.
  • You can retrieve data from other Apps to Zoho CRM using function.
  • You must update the API ticket regularly according to limits in third-party applications.
  • You will not receive any email notification, if the function integration stopped functioning due to any issue in a third-party API.
  • If there is any failure while connecting to Zoho Creator service, function will send the second notification after 15 min. Thereafter, the system will not send any notifications for that particular workflow trigger. Errors returned from Zoho Creator are shown under Reason for Failures section.
  • If you exceed the maximum count per day, the system will not send remaining function notifications to third-party applications and will notify the failure to Administrator.
  • Zoho CRM will the send the data in following standard format for Date and Date Time fields to third-party applications:
    • Date: yyyy-MM-dd
    • Date Time: yyyy-MM-dd hh:mm
  • Limits for Custom Functions:
    • Calls per Day - 10000 calls/day or 200 calls per user license for the org. (whichever is lower)
    • Integration Tasks - 25000 Zoho API calls/day using deluge.
    • Get Data & Post Data - 25000 calls/day (totally) 
    • Send Email - 1000 emails/day

Refer Error Codes

When the execution of function fails, one of the following error messages will be displayed in Zoho CRM:

HTTP Status Codes

  • 400 Bad Request - Often missing a required parameter.
  • 401 Unauthorized - No valid API key provided.
  • 402 Request Failed - Parameters were valid but request failed.
  • 404 Not Found - The requested item doesn't exist.
  • 500, 502, 503, 504 Server errors - Error in the third-party application.
  • Error Code 1 - Temporarily not able to connect to the API server. Check API server logs, firewalls settings for requests sent from CRM.

Custom Errors

  • Internal process failure - When the function is not executed due to errors in processing of the script.
  • Day limit reached - When the company has reached the maximum limit for the day.
  • Deluge Script - When the execution of workflow triggers fail due to errors in Deluge Script.