Extension APIs

Extension APIs

These APIs fetch or set information related to the extension.

Get extension config variable: Fetch the installation parameters of the extension. In production mode, only those parameters that have the value of the secure key set to false are returned. In development mode, all parameters are returned, irrespective of the value of the secure key.

Request:
  1. ZOHODESK.get("extension.config").then(function(response){
  2. // response returns the installation parameters of the extension
  3. }).catch(function(err){
  4. // error handling
  5. })

Response:
  1. {
  2. "extension.config": [
  3.     {
  4.       "name": "apikey",
  5.       "mandatory": true,
  6.       "type": "text",
  7.       "value": "apikey",
  8.       "userdefined": true,
  9.       "secure": true,
  10.       "default": "TestData"
  11.     }
  12.   ],
  13.   "status": "success"
  14. }


Set value for extension config variable: Dynamically sets the value for a config variable defined in the plugin manifest file. New config variables cannot be defined using this API. 

Request:
  1. ZOHODESK.set('extension.config', {name : 'test', value : "value"}).then(function(res){
  2. //response returns the value saved
  3. }).catch(function(err){
  4. })

Response:
  1. {
  2.   extension.config: {
  3.     "data": [
  4.       {
  5.         "userDefined": false,
  6.         "name": "test",
  7.         "options": "[]",
  8.         "secure": false,
  9.         "mandatory": false,
  10.         "value": "value",
  11.         "varId": "12345678901234567"
  12.       }
  13.     ]
  14.   },
  15.   status: "success"
  16. }


Get extension configured departments: This API fetches the departments configured for the extension on installation.

Request:
  1. ZOHODESK.get("extension.departments").then(function(response){
  2. // response returns the department configured of the extension
  3. }).catch(function(err){
  4. // error handling
  5. })

Response:
  1. {
  2. "extension.departments": [{
  3. "name": "departmentName",
  4. "id": "1234567"
  5. }],
  6. "status": "success"
  7. }

Get extension configured profiles: This API fetches the profiles configured for the extension on installation.

Request:
  1. ZOHODESK.get("extension.profiles").then(function(response){
  2. // response returns the profiles configured of the extension
  3. }).catch(function(err){
  4. // error handling
  5. })

Response:
  1. {
  2. "extension.profiles": [
  3. {
  4. "name": "Support Manager",
  5. "id": "1234567890"
  6. },
  7. {
  8. "name": "Newbie Agent",
  9. "id": "1234567890"
  10. },
  11. {
  12. "name": "Administrator",
  13. "id": "1234567890"
  14. },
  15. {
  16. "name": "Standard",
  17. "id": "1234567890"
  18. }
  19. ],
  20. "status": "success"
  21. }

Get extension configured users: This API fetches the users configured for the extension on installation.

Request:
  1. ZOHODESK.get("extension.users").then(function(response){
  2. // response returns the users configured of the extension
  3. }).catch(function(err){
  4. // error handling
  5. })

Response:
  1. {
  2. "extension.users": [
  3. "1234567890",
  4. "0987654321"
  5. ],
  6. "status": "success"
  7. }

    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 CRM Training
      Redefine the way you work
      with Zoho Workplace

        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 CRM Training

          Create, share, and deliver

          beautiful slides from anywhere.

          Get Started Now


            Zoho Sign now offers specialized one-on-one training for both administrators and developers.

            BOOK A SESSION








                                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.




                                    Manage your brands on social media

                                      Zoho Desk Resources

                                      • Desk Community Learning Series


                                      • Digest


                                      • Functions


                                      • Meetups


                                      • Kbase


                                      • Resources


                                      • Glossary


                                      • Desk Marketplace


                                      • MVP Corner


                                      • Word of the Day


                                        Zoho Marketing Automation

                                          Zoho Sheet Resources

                                           

                                              Zoho Forms Resources


                                                Secure your business
                                                communication with Zoho Mail


                                                Mail on the move with
                                                Zoho Mail mobile application

                                                  Stay on top of your schedule
                                                  at all times


                                                  Carry your calendar with you
                                                  Anytime, anywhere




                                                        Zoho Sign Resources

                                                          Sign, Paperless!

                                                          Sign and send business documents on the go!

                                                          Get Started Now




                                                                  Zoho TeamInbox Resources



                                                                          Zoho DataPrep Resources



                                                                            Zoho DataPrep Demo

                                                                            Get a personalized demo or POC

                                                                            REGISTER NOW


                                                                              Design. Discuss. Deliver.

                                                                              Create visually engaging stories with Zoho Show.

                                                                              Get Started Now







                                                                                            You are currently viewing the help articles of Sprints 1.0. If you are a user of 2.0, please refer here.

                                                                                            You are currently viewing the help articles of Sprints 2.0. If you are a user of 1.0, please refer here.



                                                                                                  • Related Articles

                                                                                                  • Extension Log APIs

                                                                                                    Extensions can make use of Log API to log the extension processes. Logs can be viewed on customer's support portal. Logs will expire after 3days. Path to Logs: Parent Logs: SubLogs List: During development, logs are loaded in the developer's portal. ...
                                                                                                  • Invoke APIs

                                                                                                    Below are some extra APIs that you can use in your extension.  ROUTE_TO INSERT MODAL_CLOSE RESIZE ROUTE_TO This command navigates between the multiple subtabs on the ticket detail page. Listed below are the different routes supported: ...
                                                                                                  • Data APIs

                                                                                                    Zoho Desk provides a set of APIs that facilitate interaction between your extension and your help desk portal. The APIs available are listed below: Ticket Object Contact Object Account Object Current Call Object User Object Portal Object Department ...
                                                                                                  • Event APIs

                                                                                                    The following APIs help you incorporate custom functionalities in your extension when certain events occur in your help desk portal. Ticket Events You can configure extensions to receive information when an event, such as adding a comment to a ticket ...
                                                                                                  • Data Storage APIs

                                                                                                    Sometimes, the extensions you create might require data storage and retrieval capabilities. To help you in such cases, we provide a data store for extensions to set (store) and get (retrieve) data. The data can be deleted when it is no longer ...
                                                                                                    Wherever you are is as good as
                                                                                                    your workplace

                                                                                                      Resources

                                                                                                      Videos

                                                                                                      Watch comprehensive videos on features and other important topics that will help you master Zoho CRM.



                                                                                                      eBooks

                                                                                                      Download free eBooks and access a range of topics to get deeper insight on successfully using Zoho CRM.



                                                                                                      Webinars

                                                                                                      Sign up for our webinars and learn the Zoho CRM basics, from customization to sales force automation and more.



                                                                                                      CRM Tips

                                                                                                      Make the most of Zoho CRM with these useful tips.



                                                                                                        Zoho Show Resources