# Telegram Bot

## Telegram Bot

The **PandaTip** Telegram bot lets you hold and move PND without leaving Telegram — handy for sending tips in the [Pandacoin Telegram group](https://t.me/pandacoin), rewarding community contributors, or doing quick wallet-to-wallet transfers on the go.

{% hint style="info" %}
All bot commands are sent **in private chat with the bot** unless otherwise noted. Tips are the one exception — they work in the group chat where you want to tip someone.
{% endhint %}

### Get started

1. **Find the bot** in Telegram and start a chat with it.
2. **Get your deposit address** — send `/deposit` or `/address` in private.
3. **Fund it** — send PND to that address from your desktop wallet (the PandaBank), an exchange, or have a friend tip you.
4. **Check your balance** — send `/balance` in private.

Your funds are held in an account tied to your Telegram `@username` (or your numeric UserID if you don't have one — **see the warnings further down**, this matters).

### Tipping

Once you've got PND in the bot, share the love:

```
/tip <user> <amount>
```

Make sure you **correctly tag the user** (with `@`) — the bot can't tip someone who isn't properly tagged.

#### Multi-tip

You can tip multiple users at once, as long as the number of users matches the number of amounts:

```
/tip @alice 10 @bob 25 @charlie 5
```

### Withdraw to your main wallet

To send PND from the bot out to your regular Pandacoin wallet address:

```
/withdraw <address> <amount>
```

Or with the amount first:

```
/withdraw <amount> <address>
```

{% hint style="danger" %}
**Double-check the address before sending.** Withdrawals cannot be reversed. If you send to a wrong address, the PND is gone.
{% endhint %}

### Command reference

<table><thead><tr><th width="180">Command</th><th>What it does</th></tr></thead><tbody><tr><td><code>/deposit</code> / <code>/address</code></td><td>Show your deposit address (private only).</td></tr><tr><td><code>/balance</code></td><td>Show your balance (private only).</td></tr><tr><td><code>/tip @user amount</code></td><td>Send PND to another Telegram user.</td></tr><tr><td><code>/withdraw address amount</code></td><td>Send PND from the bot to an external wallet.</td></tr></tbody></table>

### ⚠️ Account ownership — read this

Your PandaTip account is tied to your Telegram `@username`. That's both convenient and fragile. A few scenarios to be aware of:

<details>

<summary><strong>You want to change your @username</strong></summary>

Changing your `@username` moves your PandaTip account with you only if the bot already knows both identities. Safer flow:

1. With your **new** `@username`, get a deposit address from the bot.
2. Switch back to your **old** `@username`.
3. Use `/withdraw` to send your balance to the new deposit address.
4. Switch to your new `@username` and confirm the funds arrived.

This way the coins are moved explicitly, not dependent on the bot following your rename.

</details>

<details>

<summary><strong>You lose your @username to someone else</strong></summary>

If you change your `@username` and someone else later claims the old one, **they gain access to whatever PandaTip balance was tied to it**. This is a limitation of how Telegram usernames work, not a bug.

If this happens and you can prove you used to own that `@username`, admins *may* be able to help — but only if the new holder is willing to give the funds back. Don't count on it.

The safe move: **transfer funds out before you abandon a username**.

</details>

<details>

<summary><strong>You have no @username (account tied to UserID)</strong></summary>

If you don't have a Telegram `@username` set, your PandaTip account is tied to your numeric Telegram UserID instead.

* Set a `@username` if you can — it makes tipping you possible and makes account recovery a bit more flexible.
* If you **delete** your Telegram account without a username, the balance is effectively unrecoverable (unless you can prove the old UserID was yours to admins).

</details>

<details>

<summary><strong>You delete your Telegram account</strong></summary>

* **If you had a `@username`:** create a new Telegram account with the same username and you should regain access. But if someone else grabs that username first, it's theirs.
* **If you had no `@username`:** the account is tied to the old UserID, which you can't recover once deleted.

Withdraw before deleting.

</details>

### Safety tips

* **The bot is custodial.** Balances you hold in the bot are not in your own private keys — they're in the bot's wallet, credited to your account. Good for small amounts and tipping. **Don't park large balances in it.**
* **Withdraw regularly** to your own Pandacoin wallet for anything more than pocket money.
* **Nobody from the team will DM you** asking for your balance, password, or login. See the FAQ on scam DMs.

### Need help?

Ask in [Telegram](https://t.me/pandacoin) — the bot's operators are in the group and can help if something goes sideways.

***


---

# 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://wiki.pandacoin.tech/support/support-guide/telegram-bot.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.