Input Parameters in Widgets

Input Parameters in Widgets

Widgets is a feature in Zoho SalesIQ that lets you display different categories of information required for your operator right inside their live chat window. These widgets can be built either using Deluge or using Webhooks. There are 5 different input parameters used in Widgets and they are as follows:
  • Action
  • Target
  • Context
  • Environment
  • Operator

Action:

The action parameter contains the details of the action that was performed. This parameter will be available inside the Action Handler.

Details found:
  • The type of action that was performed - search, button, navigate or navigate_back
  • The search query in case the action type is search
  • Button name or list element name that was clicked or triggered during the action
Sample Code:
{
"type" : "search | button | navigate|navigate_back",
"text" : $search_query, // for search
"name" : $button_name | $listElementName,

}

Target:

This parameter contains the details of the section & the element from which the action was performed. This parameter will be available inside the Action Handler.

Details found:
  • Name of the section in which the action is performed
  • Reference ID of the element from which the action is performed
  • Reference ID of the section in which the action is performed
  • Reference ID of the action performed

Sample Code:
{
"type" : "search | button | navigate|navigate_back",
"text" : $search_query, // for search
"name" : $button_name | $listElementName,

}

Context:

This parameter contains the details of the context for which the widget is being invoked. The context object will be different for different entities of SalesIQ. This parameter will contain the ID and data about the conversation for which the widget is being executed. And this parameter is available in the message handler.

Details found:
  • The type of entity for which the context is being invoked
  • Unique ID for the entity
  • Object that contains the entity data based on the context.
Sample Code:
{
   "data":{
      "email_id":"zillium.pboyle@zylker.com",
      "phone":"18147471717"
   },
   "id":"403000208743933",
   "type":"conversation"
}

Environment:

This parameter contains the details of the environment in which the widget is being accessed. It is available in the detail handler and in the action handler.

Details found:
  • Data center in which the portal exists
  • Language of the operator viewing/accessing the widget
  • Environment in which the operator has accessed SalesIQ
Sample Code:
{
"datacenter" : "us/eu/cn",
"language" : "en/jp/cn",
"client" : "mobile/web/tablet"
}

Operator:

This parameter contains the details of the operator who is accessing the widget. It is available in the detail handler and in the action handler.

Details found:
  • Email address of the operator accessing the widget
  • Unique ID of the operator viewing/accessing the widget
  • Role of the operator accessing the widget
Sample Code:
{
"id" : "403000083293647",
"role" : "Administrator"
}

Related Posts:

To learn more about Widgets, check out our Help Documentation.

Regards,
Michelle

    Access your files securely from anywhere

        Zoho Developer Community




                                  Zoho Desk Resources

                                  • Desk Community Learning Series


                                  • Digest


                                  • Functions


                                  • Meetups


                                  • Kbase


                                  • Resources


                                  • Glossary


                                  • Desk Marketplace


                                  • MVP Corner


                                  • Word of the Day



                                      Zoho Marketing Automation


                                              Manage your brands on social media



                                                    Zoho TeamInbox Resources

                                                      Zoho DataPrep Resources



                                                        Zoho CRM Plus Resources

                                                          Zoho Books Resources


                                                            Zoho Subscriptions Resources

                                                              Zoho Projects Resources


                                                                Zoho Sprints Resources


                                                                  Qntrl Resources


                                                                    Zoho Creator Resources



                                                                        Zoho Campaigns Resources


                                                                          Zoho CRM Resources

                                                                          • CRM Community Learning Series

                                                                            CRM Community Learning Series


                                                                          • Kaizen

                                                                            Kaizen

                                                                          • Functions

                                                                            Functions

                                                                          • Meetups

                                                                            Meetups

                                                                          • Kbase

                                                                            Kbase

                                                                          • Resources

                                                                            Resources

                                                                          • Digest

                                                                            Digest

                                                                          • CRM Marketplace

                                                                            CRM Marketplace

                                                                          • MVP Corner

                                                                            MVP Corner





                                                                              Design. Discuss. Deliver.

                                                                              Create visually engaging stories with Zoho Show.

                                                                              Get Started Now