Settings & Configurations

Accessing the Settings Control Panel

To access the Settings Control Panel:

Sign in to the Tikit Web App.
On the page header, select the gear to open Tikit Settings.

Use the left navigation to find and open Settings pages.

Security

Tikit provides role-based access control (RBAC) to enforce authorization in both the web and Teams apps. Using Application Roles simplifies the permissions process by granting permissions to specified roles and not to individual users or groups. Then administrators can assign Application Roles to different users or groups to control who has access to Tikit.

Application Roles define permissions for all Views into the four categories Create, Read, Update, and Delete (CRUD) and Actions/Function as Execute. App role permissions are cumulative, meaning that users start with no permissions and administrators add permissions as needed. There are four built-in application roles in Tikit: Administrators, Analysts, Users, and Anonymous.

Application Roles

Application Roles define permissions for all Views, Actions, and Functions available in the web and Teams apps.

Built-In Application Roles

By default, Tikit provides 4 Application Roles to manage users:

Role	Description
Administrators	The Administrators role has access to all Settings, Configurations, Views, Actions, and Functions. By default, the user that provisioned Tikit is mapped to the Administrators role.
Analysts	The Analysts role has access to create, read, and update Views but cannot delete them. Required for Tikit Teams App access. It has no default mapped roles. When an Administrator installs Tikit to a team in MS Teams, Tikit will map that Team's associated AD group to the analyst role.
Users	The Users role has read-only permissions to Views. It has no default mapped roles.
Anonymous	The Anonymous role is used by apps or service accounts to connect to Tikit. It is not intended for user access.

Assign users and groups to Application Roles

App role membership is determined via two methods:

Tikit administrators manually mapping users or groups to an app role.
User is a member of a Microsoft 365 Group with a name matching an existing app role.
- For example, if the user AdeleV is a member of the Microsoft 365 Group Users then they will automatically be a member of the Built-In Users app role.

To update an Application Role’s mapped roles in the Tikit Web App:

In the left navigation, go to Manage > Security.

In Application Roles, select the Application Role to update. See Built-In Application Roles for more details on roles.

In Mapped Roles, select a user or Team in Provider role/username to be mapped. Note that users may not appear in this list unless they have interacted with the Tikit or HelpBot apps.

Select Add to map the selected user or Team to the app role.

The new mapping should be visible in the list below the field.
Select Remove to remove mapped roles.

Select Save to save your changes.

To assign a user or group to an app role using Microsoft 365 Groups:

Sign in to the Azure portal.
In Azure Active Directory, select Groups in the left-hand navigation menu.
Select the Microsoft 365 Group that matches the Name of the Tikit app role (ex. Users or Analysts).
Under Manage, select Members.
Select Add members.
Search for and select the users to add to the group.
Select Select to save your changes in Azure.

Automations

For details on Automations settings, head to Automations.

Field	Required	Description	Example
Value	Yes	Display name for the category. Value has a max length of 75 characters.	Networking
Default		Specifies whether the new category is the default option for new Tickets and dropdowns in the Web App and Teams Apps. Defaults to unchecked	Unchecked

Priority

For info on configuring dropdowns, head to Dropdowns in General Web App Concepts.

Create new Priority

To add a custom Category using the Tikit Web App:

In the left navigation, go to Manage > Priority

Select Add to open the New Priority form.

In the New Priority form, enter the settings for the priority. See the following table for info on the form fields.

Field	Required	Description	Example
Value	Yes	Display name for the priority. Value has a max length of 75 characters.	Networking
Default		Specifies whether the new priority is the default option for new Tickets and dropdowns in the Web App and Teams Apps. Defaults to unchecked	Unchecked

Select Ok to save the priority.

Status

For info on configuring dropdowns, head to Dropdowns in General Web App Concepts.

Create new Status

To add a custom Status using the Tikit Web App:

In the left navigation, go to Manage > Status.

Select Add to open the New Status form.

In the New Status form, enter the settings for the status. See the following table for info on the form fields.

Field	Required	Description	Example
Value	Yes	Display name for the status. Value has a max length of 75 characters.	Networking
Default		Specifies whether the new status is the default option for new Tickets and dropdowns in the Web App and Teams Apps. Defaults to unchecked	Unchecked

Select Ok to save the status.

Field	Required	Description	Example
Value	Yes	Display name for the tag. The name must be unique so it cannot be the same as an existing tag. This value has a max length of 256 characters.	Networking

Knowledge

The ticket deflection knowledge base allows HelpBot to intelligently respond to user questions with useful answers to lower the ticket workload of analysts. Tikit uses Azure’s natural language processing (NLP) to support answering your users’ common requests with useful responses as an intelligent FAQ.

View Knowledge Base

Updating Current KB Questions and Answers Soon you will be able to edit your Ticket Deflection KB from within the Tikit Teams App. In the meantime, please use the Edit KB UI.

To open the Edit KB UI from the Tikit Web App:

In the left navigation, go to Manage > Knowledge.
Select Edit Knowledgebase to open the Edit KB UI. See below for more details.

Search Search for specific Question and Answer (QnA) pairs.
Add QnA Pair Add a new QnA pair to knowledge base.
Save Save changes to kb.
Questions Ticket deflection questions. Questions can include alternate phrasing to provide more conversational responses to users.
Answers Ticket Deflection answers.
Delete Phrasing Delete alternate question phrasing from QnA pair.
Delete QnA Pair Delete QnA pair from knowledge base.
Add Alternate Phrasing Add additional phrases to a Question for more conversational responses.

Update Knowledge Base

Updating Current KB Questions and Answers Soon you will be able to edit your Ticket Deflection KB from within the Tikit Teams App. In the meantime, please use the Edit KB UI.

To add to the Ticket Deflection kb with the Tikit Teams App, see Ticket Deflection.

To add a QnA (Question and Answer) pair in the Edit KB UI:

In the header, select Add QnA pair.

Enter values in the Question and Answer fields in the new QnA pair.
To add alternate phrasings to the Question, select Add alternate phrase.

Select Save to save your changes to the knowledge base.

To delete a QnA (Question and Answer) pair in the Edit KB UI:

Select the Delete button to remove a QnA pair.

Select Save to save your changes to the knowledge base.

Microsoft Teams

Tikit consists of multiple Teams applications. The goal of each app is to solve the needs of the particular user that interacts with it. The Tikit Teams App helps Analysts to quickly triage and solve tickets from Teams, while the HelpBot is the concierge to your end-users.

Update Tikit Welcome Message

When the Tikit Teams App is installed, it sends a custom welcome message to the Analyst. This message provides a quick introduction to your Analysts and is a great place to include some initial suggestions or useful links to get them started.

Plain text and limited markdown in Teams is supported. Please see available options.

Update Tikit Triage Channel Id

Triaging can be defined as assignment of urgency and categorization of a unit of work. In Tikit you can define a triage channel to receive notifications of all new tickets. The Teams channel can be named whatever you like since we use the internal Teams channel id to keep track of it. Once you have added or designated a channel in Teams for triage, message Tikit from that channel with the set triage command below to set the triage channel id.

IT IS RECOMMENDED THAT YOU FOLLOW THE METHOD BELOW TO SET YOUR TRIAGE CHANNEL ID, INSTEAD OF POPULATING THE FIELD MANUALLY!

To update the Tikit Triage Channel Id from Teams:

Sign in to Teams as a Tikit Administrator.
Confirm that the Tikit App is installed.
- Please see Getting Started for adding and installing the Tikit App to Teams.
Navigate to the Teams channel you want to set as the triage channel.
Type, do not copy and paste, the following set triage command to Tikit:

@Tikit set triage

Tikit will respond with a confirmation that the triage channel has been set successfully.

Install HelpBot Teams App

To download the HelpBot Teams App:

Sign in to the Tikit Web App.
On the page header, select the gear to open Tikit Settings.
In the left navigation, go to Settings > Microsoft Teams.
Select Download HelpBot App.
Tikit will prompt to download HelpBot.zip.

To install the HelpBot Teams App to your Organization:

Upload HelpBot for your Organization
1. As a Teams Admin, in the lower left corner of Teams, choose the Apps icon. On the Apps page, choose Upload a custom app.
2. Then select Upload for MyOrganization where MyOrganization is your companies name.
From here you have two options you can instruct your end users to access and install the HelpBot from your organizations Teams app store or the preferred method: “deploy” HelpBot to your users via a Setup Policy, make sure to pin HelpBot to your users sidebar.

Update HelpBot Welcome Message

Just like the Tikit Teams App, the HelpBot App also sends a customizable welcome message on installation. This message provides a quick introduction to your end-users and is a great place to include some initial suggestions, direction, or useful links to get them started.

Plain text and limited markdown in Teams is supported. Please see available options.

Update Ticket Deflection Score Threshold

The Ticket Deflection Score threshold lets HelpBot know when to reply to a request with a Ticket Deflection knowledge base answer or prompt to create a new Ticket. HelpBot’s confidence in an answer is known as the confidence score, a number between 0 and 100. A score of 100 is likely an exact match, while a score of 0 means that no matching answer was found.

The following table provides a general guide to the levels of confidence based on their score:

Score Value	Score Meaning
90 - 100	A near exact match of user query and a KB question.
> 70	High confidence - typically a good answer that completely answers the user's query.
50 - 70	Medium confidence - typically a fairly good answer that should answer the main intent of the user query. The recommended threshold that should would for most KBs is 50.
30 - 50	Low confidence - typically a related answer, that partially answers the user's intent.
< 30	Very low confidence - typically does not answer the user's query, but has some matching words or phrases
0	No match, so the answer is not returned. HelpBot will prompt to create a new ticket if there's no match.

The recommended threshold is 50 but you may want to adjust it to balance between accuracy and coverage of questions:

If Accuracy is more important, increase your threshold. This means HelpBot will be more confident in an answer when replying, but you may end up leaving more questions unanswered and turned into tickets.
If Coverage is more important, decrease your threshold. This means HelpBot will answer more questions, but some answers may only be a partial match to the user’s question.

For more detailed info on the confidence score, please see the docs for Confidence score.

Billing

You can view your current subscription and billing info via the Billing setting page. The subscription email, billing address, and card information can also be updated from Billing settings.

View Billing Settings

To view the Billing settings page:

Sign in to the Tikit Web App.
On the page header, select the gear to open Tikit Settings.
In the left navigation, go to Settings > Billing.

View Subscription

The Subscription section displays information for your current subscription or trial info:

Account Email The email address for any email notifications for your subscription.

User Count The total number of users with HelpBot or Tikit installed. Subscription costs are calculated using this count.

Billing Plan Your billing or trial plan and its current status; active or inactive.

Next Billing Date The next date you will be billed for active subscriptions. All transactions will be billed from Cireson LLC.

Update Billing Information

The Billing section displays your current billing address and allows you to update your address or card information.

To update billing information:

Navigate to the Billing settings page:
1. Sign in to the Tikit Web App.
2. On the page header, select the gear to open Tikit Settings.
3. In the left navigation, go to Settings > Billing.
Under Subscription, update the Account Email field if needed. This email is used for email notifications for subscriptions, including successful or failed payments.
Under Billing, update the billing address fields and the Credit Card information as needed.
1. MM/YY is the expiration of the credit card.
2. CVC is the Card Verification Code, typically found on the back of the card.
Select Setup Payment to update your billing information.

Cancel Subscription

To cancel an active subscription:

Navigate to the Billing settings page:
1. Sign in to the Tikit Web App.
2. On the page header, select the gear to open Tikit Settings.
3. In the left navigation, go to Settings > Billing.
Select Cancel Subscription.
In the Warning dialog, select Ok to confirm.

Email Connector

Connect Tikit to an existing Office 365 mailbox. All emails sent to the connected mailbox will automatically open new tickets in Tikit.

To configure the Email Connector you will need to Grant Consent and then Connect the O365 mailbox. Note that connecting a shared mailbox is supported to avoid having to use a license.

View Email Connector Settings

To view the Email Connector settings page:

Sign in to the Tikit Web App.
On the page header, select the gear to open Tikit Settings.
In the left navigation, go to Settings > Email Connector.

Grant Consent

Navigate to the Email Connector settings page:
1. Sign in to the Tikit Web App.
2. On the page header, select the gear to open Tikit Settings.
3. In the left navigation, go to Settings > Email Connector.
Select Grant Consent To Email Read & Send Permissions.

Microsoft will prompt for credentials in order to grant permissions to the Tikit app. If you see “Need admin approval” please try again using an admin account.

Select Accept to accept permissions.

Connect O365 Mailbox

Select Connect O365 Mailbox. Microsoft will prompt to login to an O365 mailbox. Note that connecting a shared mailbox is supported to avoid having to use a license.

After successfully connecting the O365 mailbox, you will be redirected back to the Tikit Web App and prompted to login under your original account.

You have successfully configured the email connector and are ready to turn emails into tickets!

To connect a new mailbox select Disconnect Current Mailbox And Connect New O365 Mailbox

To disconnect the current mailbox select Disconnect Current Mailbox.

Access Tokens

Tikit offers a comprehensive REST API using OData. The OData interface can be found at https://app.tikit.ai/api and access to the API is managed via access tokens. The level of permissions granted by access tokens is based on Tikit app roles. By default, access tokens provide access at the level of the User app role, but can be given additional roles on creation from the creating user’s mapped roles. For more details on Tikit app roles, please see Security.

View Access Tokens

Tikit administrators can view all access tokens, while analysts can only see tokens that they have created.

To view the tokens settings page:

Sign in to the Tikit Web App.
On the page header, select the down arrow next to currently logged in user, then select Access Tokens.

Search Search for specific tokens.
Export to Excel Export current table as a Microsoft Excel Document (.xlsx).
Reset Table Settings Reset the table to default display settings.
Add Add a new token.
Token Name Select the token name to view details.
Delete Token Delete the token.

View Access Token Details

To view a token’s details:

In the tokens settings page, select a token’s name to view more details.

Name The token’s name.
Expiration Date When the access granted by the token will expire.
Application Roles The app roles granted when using the access token.

Add New Access Token

To add a new access token:

In the tokens settings page, select the Add button to create a new token.

In the new token form, enter the token’s details:

Name The token’s name.
Expiration Date When the access granted by the token will expire.
Application Roles The app roles granted when using the access token.

Select Save to save the token.

The access token’s secret value will be displayed. Select Copy to Clipboard or select and copy the value.

Store the new access token’s value in a safe place. This value will not be displayed again and if lost, a new authentication token will need to be generated.

Still need help?

Reach out to our support team

Resources

Support