# App Tutorial

This guide walks you through how to connect to the Telegram App and start earning $HATTORI. There are two ways to link your game account to the Telegram App: via a [deeplink](#linking-via-deeplink) or [manually](#manual-linking). Below is the step-by-step guide.

## **Linking via Deeplink**

<div><figure><img src="/files/tpB2L2lC0tLJbAke87G2" alt="" width="375"><figcaption><p>Step 1. Press Link Button</p></figcaption></figure> <figure><img src="/files/kfmKXAV1B7LyBayStp4j" alt="" width="375"><figcaption><p>Step 2. Press "Back to Telegram" Button</p></figcaption></figure> <figure><img src="/files/EyKeQsT0bvLIpaQi19z0" alt="" width="375"><figcaption><p>Step 3. Your Account is ready</p></figcaption></figure></div>

#### **Step 1 — Press the Link Button**

1. Open Hattori Telegram App.
2. Make sure you've installed the game.
3. Press "Link Game Account" button to start the linking process.

#### **Step 2 — Confirm Linking in the App**

1. If the Hattori game is installed, pressing the "Link Game Account" button will open the game and display a screen confirming successful linking.
2. Press the "Back to Telegram" button to return to the bot.

{% hint style="info" %}
If an error occurs (e.g., another account is already linked to this Telegram), an error code will appear.
{% endhint %}

#### **Step 3 — Access the Linked Telegram App**

1. After completing previous steps, the Telegram App can be accessed via the external button in the channel list or the button in the chat, and it will remain linked.
2. Now that your game account’s linked to the Telegram App, it’s time for the fun part farming **$HATTORI**. Join [quests](/activities/quests.md), [events](/activities/events.md) and other activities that show up in the App.
3. Details on current tasks and earning methods are in → [\[**Telegram App Activities**\]](/activities.md)

{% hint style="info" %}
It’s normal to still see an active "Copy ID" button next to "Hattori App" in the game settings. If you see your character's costume on the Telegram App’s main page, that means your account is successfully linked. We’ll add a display for the linked account in the game later.
{% endhint %}

{% hint style="warning" %}
For the quests and events to start tracking your in-game progress correctly, you need to complete the very first [daily task](/game-info/game-systems/bazaar/in-game-rewards/daily-tasks.md) (win 1 battle in the region), which you can see after initial tutorial and claim the reward in the corresponding in-game [section](/game-info/game-systems/bazaar/in-game-rewards/daily-tasks.md#general-description). After that, your progress will be tracked properly forever.
{% endhint %}

If the deeplink process doesn't work, link your account manually.

## Manual Linking

<div><figure><img src="/files/NsZ3W2mLbRdqcjnJT5Kr" alt="" width="375"><figcaption><p>Step 1.<br>Go to Settings</p></figcaption></figure> <figure><img src="/files/6sNHIGYH4Hmch3Vu91XG" alt="" width="375"><figcaption><p>Step 2.<br>Press "Link Manually"</p></figcaption></figure> <figure><img src="/files/5zvqSnHHt0yT2XTYtQVT" alt="" width="375"><figcaption><p>Step 3. <br>Paste your key from the game</p></figcaption></figure> <figure><img src="/files/EyKeQsT0bvLIpaQi19z0" alt="" width="375"><figcaption><p>Step 4.<br>Your Account is ready</p></figcaption></figure></div>

#### **Step 1 —** Set up the App

1. Go to the Telegram App here → [**\[Open App\]**](https://t.me/hattoribot)
2. Hit **"Open Telegram App"** or **"Play game directly"**.
3. Wait for it to load, might take a bit the first time because it’s pulling all components. Runs faster after that next time.
4. After tutorial click on "Settings" icon.

#### Step 2 — Start Linking

1. Press "Link Account Manually" button
2. You'll see detailed instructions inside.

#### Step 3 — Link your game account

1. Make sure you've installed the game from <img src="/files/d2dFDApt6MaDzl9eFMzg" alt="" data-size="line"> [**Google Play**](https://play.google.com/store/apps/details?id=com.hattorigame.Hattori2) or <img src="/files/koMkH6Dxb3BvQEZTZYe6" alt="" data-size="line"> [**App Store**](https://apps.apple.com/us/app/hattori-battle-clash/id6742995620) and completed the in-game tutorial.
2. Go to game settings.
3. Copy your game key: Settings → Profile Icon <img src="/files/ayRidgLwsLEszWPqEkj7" alt="" data-size="line"> → "HATTORI APP" link button:

<figure><img src="/files/UFj0VKYvIY1Dg1WdkGza" alt="" width="375"><figcaption></figcaption></figure>

4. Paste it into the Telegram App when asked and confirm the link.

#### Step 4 — Start farming

* After completing previous steps, the Telegram App can be accessed via the external button in the channel list or the button in the chat, and it will remain linked.
* Now that your game account’s linked to the Telegram App, it’s time for the fun part farming **$HATTORI**. Join [quests](/activities/quests.md), [events](/activities/events.md) and other activities that show up in the bot.
* Details on current tasks and earning methods are in → [\[**Telegram App Activities**\]](/activities.md)

{% hint style="info" %}
It’s normal to still see an active "Copy ID" button next to "Hattori App" in the game settings. If you see your character's costume on the Telegram App’s main page, that means your account is successfully linked. We’ll add a display for the linked account in the game later.
{% endhint %}

{% hint style="warning" %}
For the quests and events to start tracking your in-game progress correctly, you need to complete the very first [daily task](/game-info/game-systems/bazaar/in-game-rewards/daily-tasks.md) (win 1 battle in the region), which you can see after initial tutorial and claim the reward in the corresponding in-game [section](/game-info/game-systems/bazaar/in-game-rewards/daily-tasks.md#general-description). After that, your progress will be tracked properly forever.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.playhattori.io/app-tutorial.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.