Chat Widget

Part 1: Installation Guide (For Developers)

The Starko ONE widget allows you to embed AI-powered support directly into your application. Follow the instructions below to integrate the widget into your website.

1. General Settings

Before installation, ensure your widget is configured correctly in the Starko Dashboard:

  • Translations: Navigate to the AI Settings page to translate the widget interface into your desired language.
  • Knowledge Hub: Ensure your articles are categorized correctly, as these will appear as "Collections" in the widget.

2. Embed Code

Locate your unique clientKey in the Installation tab. Use the following methods to add the widget to your project.

Option A: Basic HTML/JavaScript

Add this code before the closing </body> tag of your website template.

html
<!-- Include the Starko Chat widget script --><script src="https://chat.starko.one/widget.js"></script><script>  window.Widget &&    window.Widget.init({      props: { clientKey: "3ba57953-699d-4385-bc68-08fd6e7d9226" },    });</script>

Option B: Next.js / React

Create a new component (e.g., WidgetInstall.tsx) and use the following code:

tsx
"use client";import Script from "next/script";import React from "react";
export default function WidgetInstall() {  return (    <Script      src="https://chat.starko.one/widget.js"      strategy="afterInteractive"      onLoad={() => {        (window as any).Widget?.init({          props: { clientKey: "3ba57953-699d-4385-bc68-08fd6e7d9226" },        });      }}    />  );}

Part 2: User Guide (How to use the Widget)

Welcome to the Starko ONE support widget. This tool allows you to find answers instantly, chat with our AI assistant, or manage your support tickets.

### 1. Home Screen Overview

When you open the widget, you will see the Home dashboard. This includes:

  • Ask a Question: The primary button to start a conversation.
  • Collections: Categories of support articles (e.g., Ticketing, Workspace settings, Threads) pulled directly from our Knowledge Hub.
  • Navigation Tabs: Located at the bottom (Home, Inbox, Tickets).

2. Chatting with Starko AI

Click "Ask a question" to open the chat interface.

  • Instant Greeting: You will be greeted immediately by the AI.
  • AI Capabilities: The AI utilizes our entire Knowledge Hub to answer your questions. You can upload screenshots or documents directly into the chat for analysis.
  • Context Awareness: The system uses your User ID to remember your context, ensuring a smooth conversation flow.

### 3. Escalation & Human Support

If the AI cannot resolve your issue, the system handles the handover automatically:

  • Human Handoff: Depending on agent availability settings, the chat may transfer you directly to a human agent.
  • Automatic Ticketing: If no agents are available, or if the AI cannot solve the issue, a Support Ticket is created automatically.
  • User Persistence: If you specifically ask to speak to a human and live chat is disabled, the system will automatically open a ticket for you.

4. Self-Service Knowledge Base

If you prefer to browse, scroll down on the Home screen to view Collections. Clicking a category (e.g., Workspace Settings) lets you read static help articles and FAQs directly in the widget without leaving the page.

5. Managing Your Activity

Use the bottom navigation bar to manage your history:

  • Inbox Tab: View your chat history. Conversations are saved and persistent, so you can close the browser and return later without losing your chat log.
  • Tickets Tab: Track the status of your formal support requests.
    • View Status: See if your ticket is Open, In Progress, or Closed.
    • Reply: You can send replies to existing tickets directly from this tab.

Did this answer your question?