# 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="https://1600250607-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOztbzZyXUmP3BH4IPnha%2Fuploads%2F9ie4AZI5KL6Z9NOnmIqo%2FAuto_1.jpg?alt=media&#x26;token=1df0306b-c1e7-4d4e-8875-3e97f1e58ff0" alt="" width="375"><figcaption><p>Step 1. Press Link Button</p></figcaption></figure> <figure><img src="https://1600250607-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOztbzZyXUmP3BH4IPnha%2Fuploads%2FCvqtw6KVF2s3JbC4n6SX%2FAuto_2.jpg?alt=media&#x26;token=6396154d-eb41-4ffc-aec0-5214ebf59ca8" alt="" width="375"><figcaption><p>Step 2. Press "Back to Telegram" Button</p></figcaption></figure> <figure><img src="https://1600250607-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOztbzZyXUmP3BH4IPnha%2Fuploads%2Fq10b4FAxoC2nE8MLM3rG%2FAuto_3.png?alt=media&#x26;token=3ec43eec-a422-48ba-b971-1dfab287a06c" 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](https://docs.playhattori.io/activities/quests), [events](https://docs.playhattori.io/activities/events) and other activities that show up in the App.
3. Details on current tasks and earning methods are in → [\[**Telegram App Activities**\]](https://docs.playhattori.io/activities)

{% 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](https://docs.playhattori.io/game-info/game-systems/bazaar/in-game-rewards/daily-tasks) (win 1 battle in the region), which you can see after initial tutorial and claim the reward in the corresponding in-game [section](https://docs.playhattori.io/game-info/game-systems/bazaar/in-game-rewards/daily-tasks#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="https://1600250607-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOztbzZyXUmP3BH4IPnha%2Fuploads%2F9DBcCF7tgfld9wTGEuoR%2FManual_1.jpg?alt=media&#x26;token=3179331a-c016-4008-8d63-905fa8df7205" alt="" width="375"><figcaption><p>Step 1.<br>Go to Settings</p></figcaption></figure> <figure><img src="https://1600250607-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOztbzZyXUmP3BH4IPnha%2Fuploads%2F8tz5LjR7SgPTHlbLoEjR%2FManual_2.jpg?alt=media&#x26;token=d588dcd7-417f-44b5-8780-c453e9b95e82" alt="" width="375"><figcaption><p>Step 2.<br>Press "Link Manually"</p></figcaption></figure> <figure><img src="https://1600250607-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOztbzZyXUmP3BH4IPnha%2Fuploads%2FNsQtpW1No8HwuQAexkuW%2FManual_3.jpg?alt=media&#x26;token=d5fdd0bf-f4fa-4266-8fd5-c0239560f73b" alt="" width="375"><figcaption><p>Step 3. <br>Paste your key from the game</p></figcaption></figure> <figure><img src="https://1600250607-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOztbzZyXUmP3BH4IPnha%2Fuploads%2Fq10b4FAxoC2nE8MLM3rG%2FAuto_3.png?alt=media&#x26;token=3ec43eec-a422-48ba-b971-1dfab287a06c" 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="https://1600250607-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOztbzZyXUmP3BH4IPnha%2Fuploads%2FpFUen4w2p2Gs7JHS5NFW%2Fimage%201.png?alt=media&#x26;token=8e2140c5-1434-4fe4-b694-84011fc177d6" alt="" data-size="line"> [**Google Play**](https://play.google.com/store/apps/details?id=com.hattorigame.Hattori2) or <img src="https://1600250607-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOztbzZyXUmP3BH4IPnha%2Fuploads%2FHMYISo49q5Z6LPj8Jh9y%2Fimage%202.png?alt=media&#x26;token=055e5ae8-6daa-4090-ba35-3b99c7c78194" 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="https://1600250607-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOztbzZyXUmP3BH4IPnha%2Fuploads%2FugNpReyF5nWmr3Y1MCuX%2Fimage.png?alt=media&#x26;token=fdd9aaaf-1642-4784-a901-6b0dfcf16d3c" alt="" data-size="line"> → "HATTORI APP" link button:

<figure><img src="https://1600250607-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FOztbzZyXUmP3BH4IPnha%2Fuploads%2F1Qu7hVr7MyfxGD8L3BCP%2Fimage.png?alt=media&#x26;token=6a0d5520-3443-4313-aac0-6dc642e12ac9" 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](https://docs.playhattori.io/activities/quests), [events](https://docs.playhattori.io/activities/events) and other activities that show up in the bot.
* Details on current tasks and earning methods are in → [\[**Telegram App Activities**\]](https://docs.playhattori.io/activities)

{% 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](https://docs.playhattori.io/game-info/game-systems/bazaar/in-game-rewards/daily-tasks) (win 1 battle in the region), which you can see after initial tutorial and claim the reward in the corresponding in-game [section](https://docs.playhattori.io/game-info/game-systems/bazaar/in-game-rewards/daily-tasks#general-description). After that, your progress will be tracked properly forever.
{% endhint %}
