Extension Token (ZAPI Key)

Extension Token (ZAPI Key)

The extension token, also known as ZAPI Key is an unique authentication key generated for each user who interacts with any component in the extension. This token can be used to connect your extension with a third party application through webhooks, to post messages to a channel or chat. 
As an extension developer, you can allow all users of the organization to create a token, through the token generation dialog prompt. 

Token generation button sample syntax

  1. [
  2. {
  3. "label": "",
  4. "type": "", // + or -
  5. "action":
  6. {
  7. "type": "invoke.function",
  8. "data":
  9. {
  10. "name": "",
  11. "owner": "" //Email ID of the extension developer
  12. },
  13. "confirm":
  14. {
  15. "title": "",
  16. "description": "",
  17. "input":
  18. {
  19. "type": "user_webhook_token"
  20. }
  21. }
  22. }
  23. }
  24. ]

Token Generation Button Object Attributes


Action object attributes

Attribute Name
Data Type
Description
type
string
Define the type of action a button should perform. For the token generation button, value for the type key must be invoke.function
data
JSON Object
Define the parameters to be passed by the button of type, invoke.function


Data object attributes

Attribute Name
Data Type
Description
name
string
Name of the function to be invoked

Confirm object attributes

Attribute Name
Data Type
Description
title
string
The title of the token generation prompt
description
string
The description of the confirmation prompt
input
JSON Object
Define the input type of dialog prompt

Input object attributes

Attribute Name
Data Type
Description
type
string
The type of input dialog prompt. Value should be:user_webhook_token


Sample code snippet of the token generation dialog

  1. response = {"text":"Click on the token generation button below!","buttons":[
  2. {
  3. "label": "Create Webhook",
  4. "type": "+",
  5. "action":
  6. {
  7. "type": "invoke.function",
  8. "data":
  9. {
  10. "name": "authentication"
  11. },
  12. "confirm":
  13. {
  14. "title":"Generate Webhooks for a GitLab Project",
  15. "description":"Connect to GitLab Projects from within Cliq",
  16. "input" :
  17. {
  18. "type":"user_webhook_token"
  19. }
  20. }
  21. }
  22. }
  23. ]};
  24. return 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 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









                                                                                                      • Related Articles

                                                                                                      • Extension Installation Handler

                                                                                                        This handler is triggered after the installation of the extension. The main purpose of this handler is to let you (extension creator) handle certain processes, like configuring webhooks after a user installs the extension. Click Edit Code under ...
                                                                                                      • Extension Incoming Webhook Handler

                                                                                                        Integration with external applications can be done with the help of incoming webhook APIs. An extension token or ZAPI key generated by each user interacting with the extension, should be used for handling incoming webhooks and messaging apis. You ...
                                                                                                      • Building a GoToMeeting Extension

                                                                                                        The GoToMeeting extension enables users to schedule meetings, invite users, and keep track of the meetings when they have joined within Zoho CRM. With GoToMeeting you can utilize HD video conferencing and screen sharing. With this extension installed ...
                                                                                                      • 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 ...
                                                                                                      • Extension Webhook

                                                                                                        Marketplace supports Extension Webhook , which will allow a market place app to create extension specific desk webhooks. Extension webhook access is restricted to the extension app alone so that the normal user can't make any changes on these ...
                                                                                                        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