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




                                                  • Desk Community Learning Series


                                                  • Digest


                                                  • Functions


                                                  • Meetups


                                                  • Kbase


                                                  • Resources


                                                  • Glossary


                                                  • Desk Marketplace


                                                  • MVP Corner


                                                  • Word of the Day


                                                  • Ask the Experts





                                                            Manage your brands on social media



                                                                  Zoho TeamInbox Resources



                                                                      Zoho CRM Plus Resources

                                                                        Zoho Books Resources


                                                                          Zoho Subscriptions Resources

                                                                            Zoho Projects Resources


                                                                              Zoho Sprints Resources


                                                                                Qntrl Resources


                                                                                  Zoho Creator 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


                                                                                            Zoho Show Resources

                                                                                              Zoho Writer

                                                                                              Get Started. Write Away!

                                                                                              Writer is a powerful online word processor, designed for collaborative work.

                                                                                                Zoho CRM コンテンツ



                                                                                                  Nederlandse Hulpbronnen


                                                                                                      ご検討中の方