Setting up the Teams Bot Integration
6 min
setting up the central config api key log in to the centralconfig > configure application > security controls > apikeys find the centralconfigapikey as shown below and copy the value paste the copied value in the appsettings json file for the centralconfigapikey for example, central config api key"=”xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx” executing the powershell script (from version 2023 4 onwards) download the zip file to a relevant folder in your machine extract the zip file open powershell as administrator go to the location where the powershell script is located, that is, the location where you extracted the zip file run the script \install ps1 provide relevant details to the below prompts is the environment ssl enabled? please enter the ism tenant id \[example ismtenant yourdomain com] only if environment is ssl enabled, otherwise provide app server ip address or host/domain name please enter the central config tenant id \[example configtenant yourdomain com] only if environment is ssl enabled, otherwise provide server ip address or host/domain name the configuration is done executing the powershell script (before version 2023 4) download the zip file to a relevant folder in your machine extract the zip file open powershell as administrator go to the location where the powershell script is located, that is, the location where you extracted the zip file run the script \teamsbot ps1 you will be prompted for the appserver as well as the central config ipaddress/ machine name/ localhost name name/ localhost enter the appropriate address/machine name/localhost the configuration is done troubleshooting incorrect ipaddress/machine name/local host name (version 2023 4 onwards) if you provide incorrect ip address/machine name/local host name, open the appsetting json file from the folder inetpub >teams bot service verify and replace the value for the following appserveruri centralconfiguri configserviceclienturi example of the appsetting json file { "jsonmaxdepth" 128, "microsoftappid" "", "microsoftapppassword" "", "ipcmservicename" "/serviceapi/ipcmservice asmx", "loglevel" "debug", "cachetimeout" "30", "isonpremise" true, "central config api key" "", "appserveruri" "https //ism onprem15 tenant1 ivanticlouddev com/heat", "nooffaq" 2, "noofknowledgebase" 3, "soap" { "opentimeout" "2", "closetimeout" "2", "sendtimeout" "2", "receivetimeout" "2" }, "centralconfiguri" "https //cfg onprem15 ism ivanticlouddev com/centralconfig", "buildversion" "", "configserviceclienturi" " https //cfgonprem15 ism ivanticlouddev com/centralconfig ", "ism configserviceclientname" "api/centralconfig", "configserviceclientname" "api/centralconfig", "useinmemorystate" true, "secretstorageuri" "", "redisstorageconfiguration" { "enableredisflag" true, "redisconnectionstring" "redis redis svc cluster local", "sendmessagetochatservice" "reveivemessagefromteams", "closesocketsignal" "closesocketsignal" }, "iocservices" \[ { "lifetimetype" "1", "assemblyname" "servicemanager simplestoragestrategy", "classname" "servicemanager simplestoragestrategy azureblobstorage", "interfacename" "servicemanager simplestoragestrategy isimplestoragestrategy" }, { "lifetimetype" "1", "assemblyname" "servicemanager simplestoragestrategy", "classname" "servicemanager simplestoragestrategy secretstorage appsettingsecretkey", "interfacename" "servicemanager simplestoragestrategy secretstorage isimplesecretstoragestrategy" }, { "lifetimetype" "1", "assemblyname" "servicemanager appserver webreference", "classname" "servicemanager appserver webreference ipcmservice", "interfacename" "servicemanager appserver webreference iipcmservice" }, { "lifetimetype" "1", "assemblyname" "servicemanager centralconfig webreference", "classname" "servicemanager centralconfig webreference rest configserviceclientjson", "interfacename" "centralconfig contract iconfigserviceapi" }, { "lifetimetype" "1", "assemblyname" "servicemanager cache", "classname" "heat cache inmemory inmemorycache", "interfacename" "heat cache contract icache" } ] } incorrect ipaddress/machine name/local host name (before version 2023 4) if you provide incorrect ip address/machine name/local host name, open the appsetting json file from the folder inetpub >teams bot service and replace the appserveripaddress with the correct one example of the appsetting json file {"microsoftappid"="";"microsoftapppassword"="";"ipcmurl"= "http //$appserveripaddress/heat/serviceapi/ipcmservice asmx"; "workflowurl"= "http //$appserveripaddress/heat/serviceapi/workflowservice asmx"; "configurl"= "http //$centralconfigipaddress/centralconfig/configserviceapi asmx"; "retrievetenantloglevel ws url"= "http=//$centralconfigipaddress/centralconfig/retrievetenantloglevel ashx"; "enablecentrallogging"= false; "loggingservice ws url"= "http //$appserveripaddress/heat logging service/api/loggingservice/heatservicemanagementlogging"; "elapsedsecondstoflushlog"= 60; "itemsizetoflushlog"= 1000; "logsettingcachetimeoutinminutes"= 5; "sendlogfilelocation"= "c \logs"; "writelogfilelocation"= "c \logs"; "sendlogwaitinterval"= 300; "writelogwaitinterval"= 300; "enablelogging"= true; "cachetimeout"= "30"; "isonpremise" false; ”centralconfigapikey”=”” } make sure that boolean values (true/false) don't not have double quotes to know the execution policy list run the command ps c \users\administrator>get executionpolicy list sample image of the policy list to set the execution policy once the powershell script is executed successfully, execute the command set executionpolicy executionpolicy “provide previous value” scope localmachine to set the execution policy sample image of setting execution policy
