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





                            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 WorkDrive Resources



                                                                  Zoho Campaigns Resources

                                                                    Zoho CRM Resources

                                                                    • CRM Community Learning Series

                                                                      CRM Community Learning Series


                                                                    • Tips

                                                                      Tips

                                                                    • 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