# Chatbot User Guide

## Introduction

This report provides a comprehensive guide on the features of the chatbot designed to support users in various roles such as User, SPO, Drep, Committee, etc. Each feature is detailed with its usage scenario, command or interaction method, accompanied by illustrations and functional explanations. The chatbot offers dynamic question recommendations randomly generated based on an underlying dataset, enhancing user engagement and relevance.

## **Search chatbots**

## User manual

## 1. Bot Startup and Account Initialization

**Feature:** Start the bot and create a new account.

**Usage Scenario:**

* Access the chatbot interface via Telegram, Messenger, or supported platform.
* Press the **Start** button or enter the command `/start` to initialize the account and begin interaction.

**Illustration:**<br>

<figure><img src="https://734685240-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FN18XEiysfUNfFbINf86G%2Fuploads%2FX94QRzaeoxOyarstInuc%2Fimage.png?alt=media&#x26;token=7aa89a57-c77a-495b-af2b-cc40bd619d6e" alt=""><figcaption></figcaption></figure>

**Function Description:**\
This command activates the chatbot session for the user, initializing profile data and enabling further feature access.

### 2. Show Available Commands

**Feature:** Display the list of commands available for user interaction.

**Usage Scenario:**

* Press the command menu in the chat interface or enter  `/help` to see all supported commands.

**Illustration:**<br>

<figure><img src="https://734685240-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FN18XEiysfUNfFbINf86G%2Fuploads%2Fy0GikWEPsUra3hquRPAp%2Fimage.png?alt=media&#x26;token=6b8abf59-6d16-48cd-a65d-02478f5e4f0b" alt=""><figcaption></figcaption></figure>

**Function Description:**\
Provides the user with an overview of all commands for easy navigation and feature discovery.

### 3. Account Settings

**Feature:** Manage user account settings.

**Usage Scenario:**

* Access via command menu or enter  `/account` to configure personal settings.

**Illustration:**<br>

<figure><img src="https://734685240-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FN18XEiysfUNfFbINf86G%2Fuploads%2FHhZX6TY7ajlp3Ijokulf%2Fimage.png?alt=media&#x26;token=d279e81d-6d70-4f79-bf7c-e3b87c1ef362" alt=""><figcaption></figcaption></figure>

**Function Description:**\
Allows users to **view and edit personal data**, **enable/disable notifications** (including **on-chain notifications**), and **set up roles for using the chatbot**.

### 4. Recommend Question Feature (Dynamic)

**Feature:** Bot recommends questions to users based on dataset-driven random selection.

**Usage Scenario:**

* Activate by entering `/find` or selecting the recommended questions menu.
* The bot will randomly display 10 questions.&#x20;
* Users select any button to view detailed content of the corresponding answer.

**Illustration:**<br>

<figure><img src="https://734685240-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FN18XEiysfUNfFbINf86G%2Fuploads%2Fz1WSkI5PHwvDLzeRfqd1%2Fimage.png?alt=media&#x26;token=9170f9e8-2bfa-4ea1-a32b-83f61812268a" alt=""><figcaption></figcaption></figure>

**Function Description:**\
The question set is dynamically generated each time from the backend dataset, providing fresh and relevant queries tailored to user context.

### 5. Interaction with Recommended Questions

For each random question (from 1 to 10), users can:

* Enter `/find`, then press the corresponding button (1 through 10) to view specific details.

**Illustration:**<br>

<figure><img src="https://734685240-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FN18XEiysfUNfFbINf86G%2Fuploads%2FGf3oGkSaKJXtSwS5PN2x%2Fimage.png?alt=media&#x26;token=011b6ea7-2950-47ce-8848-5fc85ededa70" alt=""><figcaption></figcaption></figure>

### 6. Send Feedback

**Feature:** Send direct feedback or report issues to the development team.

**Usage Scenario:**

* Choose the feedback option via menu or enter  `/feedback`.

**Illustration:**<br>

<figure><img src="https://734685240-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FN18XEiysfUNfFbINf86G%2Fuploads%2FSElgTGNgZ6vIZ5yzPYby%2Fimage.png?alt=media&#x26;token=d9bfa4e1-2d48-48d9-b20f-421a99290ff4" alt=""><figcaption></figcaption></figure>

**Function Description:**\
Helps users submit reviews, provide feedback on products, and also send inquiries, complaints, or support requests.

### 7. Clear up the chatbox

**Feature:** Clear up the conversation

**Usage Scenario:**

* Activate by entering `/reset`

**Illustration:**

<figure><img src="https://734685240-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FN18XEiysfUNfFbINf86G%2Fuploads%2FqXELamqCBJ7dsKtG1C5D%2Fimage.png?alt=media&#x26;token=419ee41e-2e62-4aa1-93f3-6f99b0fd9dce" alt=""><figcaption></figcaption></figure>

**Function Description:**\
Helps users clear the chat window and refresh the conversation.

### 8. Command doesn't exist

**Feature**: Supports suggesting commands if the user enters an incorrect or non-existent command in the chatbot

<figure><img src="https://734685240-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FN18XEiysfUNfFbINf86G%2Fuploads%2FelIR2MaKRVe1o3S9KwzW%2Fimage.png?alt=media&#x26;token=00c6472c-0e32-44e0-938c-9b7a7eb9400b" alt=""><figcaption></figcaption></figure>

### 9. Notification Onchain Settings

Feature: Allows users to set the status (enable/disable) for receiving on-chain notifications from the system.

* Turn notifications **On**: `/start → Account → Turn On`

<figure><img src="https://734685240-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FN18XEiysfUNfFbINf86G%2Fuploads%2FMQ5ejCXv09huS8pR5uCq%2Fimage.png?alt=media&#x26;token=3df0218f-c6e0-4b39-b611-20de6b2c9364" alt=""><figcaption></figcaption></figure>

**For example:** When there's new proposal information on Cardano, the system will automatically send a notification to the user, **helping them quickly update the information.**

<figure><img src="https://734685240-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FN18XEiysfUNfFbINf86G%2Fuploads%2FvyrIqEuE6jPkxd95yGmo%2Fimage.png?alt=media&#x26;token=a39761c3-653e-4b8b-a070-3b46287fb063" alt=""><figcaption></figcaption></figure>

* Turn notifications **Off**: `/start → Account → Turn Off`

<figure><img src="https://734685240-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FN18XEiysfUNfFbINf86G%2Fuploads%2F29N9xpeiMkyfjh1nyqgZ%2Fimage.png?alt=media&#x26;token=ad89fbeb-4b11-4973-baa9-c2663141f6fa" alt=""><figcaption></figcaption></figure>

### 10. Score calculation

**Feature:** Provides basic information about the rules and scoring mechanisms for users if a reward program is active.

**Usage Scenario:**

* Access via menu.

**Illustration:**

<figure><img src="https://734685240-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FN18XEiysfUNfFbINf86G%2Fuploads%2FUQ13KBbC8FMmtp8Scdz8%2Fimage.png?alt=media&#x26;token=615776e8-c42d-4e26-a10b-9406c9b67868" alt=""><figcaption></figcaption></figure>

### 11. Role Settings

Users can assign or modify their role via:

* `/start → Account → Role`

Roles include:

* User
* SPO
* Committee
* Drep

**Illustration:**<br>

<figure><img src="https://734685240-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FN18XEiysfUNfFbINf86G%2Fuploads%2FdwTlwGeNLxSHxNoyLXdk%2Fimage.png?alt=media&#x26;token=37fa0a10-021d-4d27-b191-a18362705730" alt=""><figcaption></figcaption></figure>

### 12. Update Onchain Id

**Feature:** To use the chatbot’s Deep Chat feature, you need to provide your on-chain ID.

**Usage Scenario:**

* Activate by entering `/id [your_onchainId]`

**Illustration:**

<figure><img src="https://734685240-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FN18XEiysfUNfFbINf86G%2Fuploads%2FAB9SVb1R2L1kXQKwBbp5%2Fimage.png?alt=media&#x26;token=83bf02e4-8595-4cb6-91f1-9c9d722dc74a" alt=""><figcaption></figcaption></figure>

### 13. Update Wallet

**Feature:** Responsible for handling user rewards during special promotions or events.

**Usage Scenario:**

* Activate by entering `/add [your_address]`

**Illustration:**

<figure><img src="https://734685240-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FN18XEiysfUNfFbINf86G%2Fuploads%2FGKiviOwfphcpUvpsvrCB%2Fimage.png?alt=media&#x26;token=93879175-e383-48f5-b992-ea7647637377" alt=""><figcaption></figcaption></figure>

### 14. Deep chat

**Feature:** The user can engage in in-depth Cardano-related discussions with GovernCardanoBot.

After selecting the role of SPO, DRep, or CC, you enter /account to check for change and then entering their onchain ID using /id \[your\_address]

* DRep

&#x20;You can now get detailed insights :

1. DRep listings: Get a comprehensive list of all active DReps.
2. Your personal DRep profile: Access specific details about your DRep ID, performance, and status.
3. Your voter base: Understand who is delegating to you and their voting power.
4. More...

<figure><img src="https://734685240-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FN18XEiysfUNfFbINf86G%2Fuploads%2F0JAm1UEm6RQWaU81xuYn%2Fimage.png?alt=media&#x26;token=a427c07b-0562-4a69-8d14-ac9418a4cbf0" alt=""><figcaption></figcaption></figure>

* SPO

You can easily query for detailed information about your Stake Pool :&#x20;

1. My Stake Pool information: "Show me my pool details." or "What are my pool stats?"
2. List of pools: "List all active pools." or "Show me all registered SPOs."
3. Your delegators: "Who are my delegators?" or "Show me my pool's stakers."
4. Pool activity history: "What is my pool's performance history?" or "Show recent pool blocks
5. Pool DRep information: "Who is my pool's DRep?"
6. More...

<figure><img src="https://734685240-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FN18XEiysfUNfFbINf86G%2Fuploads%2F32s05HyJCXIacwuLihHl%2Fimage.png?alt=media&#x26;token=2ff4e4a9-3542-4c76-8fb3-15c4cf8c0566" alt=""><figcaption></figcaption></figure>

* Committe

You can query important information related to your Committee role :&#x20;

1. Committee information: "Show me Committee details." or "What is the current CC status?"
2. Committee activities: "What are the latest CC actions?" or "Show recent Committee votes."
3. Committee proposals: "List CC proposals." or "Show active Committee proposals."
4. Committee member information: "Who are the Committee members?" or "List all CC members."
5. More...

<figure><img src="https://734685240-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FN18XEiysfUNfFbINf86G%2Fuploads%2FFibddMzQTTXFewIGupXz%2Fimage.png?alt=media&#x26;token=4fd2d08b-16a2-447e-8579-a84e6b49bbd0" alt=""><figcaption></figcaption></figure>

## Advanced Tips & Tricks

## Support and troubleshooting