The following keys are essential to call the methods for displaying the conversation AI in your app.

• orgId

• widgetId

• domain 

The values of these keys appear under the Code Snippet section on the setup page of the ASAP help widget in Zoho Desk.  

SHOW BOT

Kotlin

Java

1. ZohoGC.show(activity, orgId, widgetId, domain)

Setting up location block    

Learn how to get the API key from Google                                                                                      

1. Get the API key for Google Maps from Google.                     
2. Go to the Androidmanifet.xml file and add the below lines.  

Also add the generated map API key.

1. <meta-data
   android:name="com.google.android.geo.API_KEY"
   android:value="YOUR_MAP_API_KEY" />

1. Open the strings.xml file and add the following line:

1. <string name="zoho_gc_places_api_key">YOUR_MAP_API_KEY</string>

Search option

The search option enables the user to search for a location and share it. This option will be displayed by default. If not required, follow the below method in your preferred language to hide it:

The "search option" for searching for an address is a paid service.

Kotlin

1. ZConfigUtil.hideLocationSearch = true

Java

1. ZConfigUtil.hideLocationSearch = true

What are session variables?    

These variables are dynamically retrieved during the conversation. These variables are org-specific and accessible across flows.

You can perform the following actions with the session variable:

Set Session Variable

Kotlin

Java

1. HashMap<String, Object> sessionVariableMap= new HashMap<>();

               sessionVariableMap.put("name","exampleName");

               sessionVariableMap.put("value","exampleValue");

               ArrayList<HashMap<String,Object>> sessionVariableList= new
   ArrayList<>();

               sessionVariableList.add(sessionVariableMap);

   ZohoGC.setSessionVariables(widgetId,sessionVariableList);

Update Session Variable 

Kotlin

1. val sessionVariableMap = HashMap<String, Any>()
   sessionVariableMap.apply

         {
    this["name"] = "exampleName"
    this["value"] = "exampleValue"
         }

   val sessionVariableList = ArrayList<HashMap<String, Any>>()

   sessionVariableList.add(sessionVariableMap)

   ZohoGC.updateSessionVariables(context,orgId, widgetId, domain,sessionVariableList)

Java

1. HashMap<String, Object> sessionVariableMap= new HashMap<>();
   sessionVariableMap.put("name","exampleName");
   sessionVariableMap.put("value","exampleValue");
   ArrayList<HashMap<String,Object>> sessionVariableList= new ArrayList<>();
   sessionVariableList.add(sessionVariableMap);
   ZohoGC.updateSessionVariables(context,orgId, widgetId, domain,sessionVariableList)