# Create Tele Airdrop Bot

### Overview <a href="#overview" id="overview"></a>

This guide explains how to set up a Telegram bot integrated with Pinksale to run automated airdrop campaigns where users complete tasks to earn points or rewards. Reading this will help you:

* Understand the process of creating a Telegram bot using **@BotFather**.
* Know how to link your Telegram bot to the Pinksale Tele Airdrop feature.
* Configure the basic information for your airdrop bot campaign on Pinksale.
* Learn how to add various tasks for users (e.g., connect wallet, join group/channel).
* Understand the specific verification steps required for Telegram channel/group tasks.
* Find answers to common questions about setting up and managing the bot.

### Steps to Create and Configure Your Telegram Airdrop Bot <a href="#steps-to-create-and-configure-your-telegram-airdrop-bot" id="steps-to-create-and-configure-your-telegram-airdrop-bot"></a>

Follow these steps to set up your automated airdrop campaign:

#### Step 1: Navigate to Pinksale Tele Airdrop Creation <a href="#step-1-navigate-to-pinksale-tele-airdrop-creation" id="step-1-navigate-to-pinksale-tele-airdrop-creation"></a>

* From the Pinksale homepage, click on "Tele Airdrop Bot" => "Create Tele Airdrop".
* You will be redirected to: <https://www.pinksale.finance/tele-airdrop-bot/create>

<figure><img src="https://191452618-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MdJrJV-Z8jLCR-JNtlx%2Fuploads%2FMC0Qg5RqpBlBevrHV8wR%2Ftele-airdrop-1.png?alt=media&#x26;token=cd2a8d38-a8f1-4205-9599-3cba28937923" alt=""><figcaption></figcaption></figure>

#### Step 2: Create a Telegram Bot (If you don't have one) <a href="#step-2-create-a-telegram-bot-if-you-dont-have-one" id="step-2-create-a-telegram-bot-if-you-dont-have-one"></a>

* Open your Telegram app.
* Search for **`@BotFather`** in the search bar.

<figure><img src="https://191452618-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MdJrJV-Z8jLCR-JNtlx%2Fuploads%2FXHDQqHMUNqjnwpjdpT19%2F2.png?alt=media&#x26;token=3c2cde15-4ca1-42e1-83fc-cefc97b5b719" alt=""><figcaption></figcaption></figure>

* * **Start a chat with BotFather by clicking on the `Start` button.**
  * Send the command `/newbot` to BotFather.
  * Follow BotFather's prompts:
    * Choose a **name** for your bot (e.g., "My Project Airdrop Bot").
    * Choose a unique **username** for your bot (must end in `bot`, e.g., `MyProjectAirdrop_bot`).
  * BotFather will confirm creation and give you a unique **HTTP API token**. **Copy and save this token securely – you'll need it.**

<figure><img src="https://191452618-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MdJrJV-Z8jLCR-JNtlx%2Fuploads%2FCS7bxxKucWPlevRSQ08D%2F10.png?alt=media&#x26;token=7df82967-4ec0-48f0-bbc4-e99798a9b060" alt=""><figcaption></figcaption></figure>

#### Step 3: Link Your Bot to Pinksale <a href="#step-3-link-your-bot-to-pinksale" id="step-3-link-your-bot-to-pinksale"></a>

* Go back to the Pinksale Tele Airdrop creation page (<https://www.pinksale.finance/tele-airdrop-bot/create>).
* Enter the **Telegram Bot Username** you just created (e.g., `MyProjectAirdrop_bot`).
* Enter the **Telegram Bot Token** (the HTTP API token from BotFather).
* Click "Next".

<figure><img src="https://191452618-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MdJrJV-Z8jLCR-JNtlx%2Fuploads%2FAzdML3P85fWouhs4AugK%2Ftelegram-airdrop-2.png?alt=media&#x26;token=9c6cc0ea-635f-4898-a363-e7e13a21a86c" alt=""><figcaption></figcaption></figure>

#### Step 4: Input Airdrop Bot Information <a href="#step-4-input-airdrop-bot-information" id="step-4-input-airdrop-bot-information"></a>

* After verification, fill in the details for your specific airdrop campaign using this bot. *(The exact fields might include campaign title, description, reward type (points/tokens), etc. Fill these based on the Pinksale interface).*

<figure><img src="https://191452618-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MdJrJV-Z8jLCR-JNtlx%2Fuploads%2F8FdD6mzavFUoFeMysXIi%2F13.png?alt=media&#x26;token=b15ab224-94f4-4de2-aeb9-665aaa8b47c9" alt=""><figcaption></figcaption></figure>

<figure><img src="https://191452618-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MdJrJV-Z8jLCR-JNtlx%2Fuploads%2FPD6QpNzrmvwux4HeimQb%2F14.png?alt=media&#x26;token=fa41a6fe-adad-4332-b073-7d5166475953" alt=""><figcaption><p><br></p></figcaption></figure>

#### Step 5: Complete Creation <a href="#step-5-complete-creation" id="step-5-complete-creation"></a>

Click "Create Tele Airdrop Bot". Confirm the transaction in your wallet (this likely registers the bot setup on Pinksale's backend).

<figure><img src="https://191452618-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MdJrJV-Z8jLCR-JNtlx%2Fuploads%2FIGZp5AU15rPp5wg22Lzv%2F17.png?alt=media&#x26;token=49c56009-4055-47a3-b4f3-ca5f41ee3480" alt=""><figcaption></figcaption></figure>

### Adding Tasks to Your Bot <a href="#adding-tasks-to-your-bot" id="adding-tasks-to-your-bot"></a>

After creating the bot entry on Pinksale, you need to define the tasks users must complete.

#### Step 1: Add Task <a href="#step-1-add-task" id="step-1-add-task"></a>

On your Tele Airdrop Bot management page, click the "Add Task" button.

#### Step 2: Choose Task Type <a href="#step-2-choose-task-type" id="step-2-choose-task-type"></a>

Select the type of task from the available options (e.g., Connect TON wallet, Check Telegram account premium, Subscribe Telegram channel, Join Telegram group, etc.).

<figure><img src="https://191452618-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MdJrJV-Z8jLCR-JNtlx%2Fuploads%2FB7J49tcscS8EXd9E8xcF%2F21.png?alt=media&#x26;token=63ddd8cb-ce99-4469-a014-2605ae08cdcf" alt=""><figcaption></figcaption></figure>

#### Step 3: Configure Task <a href="#step-3-configure-task" id="step-3-configure-task"></a>

* Fill in the required information for the chosen task (e.g., for "Join Group", you'll likely need the Group invite link or ID).
* Enter a **Description** for the task (what the user needs to do).
* Assign **Reward points** for completing this task.
* Click the "Add Task" button to save this specific task.

<figure><img src="https://191452618-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MdJrJV-Z8jLCR-JNtlx%2Fuploads%2FLKlVfLSZAdowTaXN3miG%2F22.png?alt=media&#x26;token=3693d690-7b5c-42f3-a29e-a96a75aaeb3b" alt=""><figcaption></figcaption></figure>

<figure><img src="https://191452618-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MdJrJV-Z8jLCR-JNtlx%2Fuploads%2FyBvFCrtGP2UJ5LNc5a9B%2F26.png?alt=media&#x26;token=b2346416-9502-47a6-9e57-73743c530fea" alt=""><figcaption></figcaption></figure>

#### Step 4: Special Verification for Channel/Group Tasks <a href="#step-4-special-verification-for-channelgroup-tasks" id="step-4-special-verification-for-channelgroup-tasks"></a>

* **NOTE:** For the tasks **Subscribe to Telegram Channel** and **Join Telegram Group**, there's an extra verification step using `@PinkSaleLaunchBot`.
* **A.** After clicking the confirm button ("Select Telegram Channel" / "Select Telegram Group") on the Pinksale task setup page, **a new browser tab/pop-up should appear**, prompting you to open Telegram.

<figure><img src="https://191452618-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MdJrJV-Z8jLCR-JNtlx%2Fuploads%2FHUgf9Y2u0sSOmMUxq7e5%2F41.png?alt=media&#x26;token=ca23db14-b4ba-4a42-adcc-8f4ba403e6fc" alt=""><figcaption></figcaption></figure>

**B.** **Open Telegram** as prompted. This will take you to a chat with `@PinkSaleLaunchBot`. (If you miss the pop-up, click the "Verify" button back on the Pinksale page to trigger it again).

<figure><img src="https://191452618-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MdJrJV-Z8jLCR-JNtlx%2Fuploads%2FxANe92OzHAo56bc4KOGS%2F37.png?alt=media&#x26;token=45211e9d-5c79-43a2-94ad-4d41a030ec5f" alt=""><figcaption></figcaption></figure>

* **C.** In the Telegram chat with `@PinkSaleLaunchBot`, click the **"Start"** button.

<figure><img src="https://191452618-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MdJrJV-Z8jLCR-JNtlx%2Fuploads%2FfdQjwy3TeQaP3iMkceUC%2F51.png?alt=media&#x26;token=09dd4e5c-9fff-4c34-b384-780fe934c82d" alt=""><figcaption></figcaption></figure>

**D.** Choose the **"Verify Bot in Group"** option (this likely works for verifying channels too).

<figure><img src="https://191452618-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MdJrJV-Z8jLCR-JNtlx%2Fuploads%2FWck4OWOVHhgToASx11CV%2F52.png?alt=media&#x26;token=63657c6e-ccc8-4d62-882b-4e416fe4c73c" alt=""><figcaption></figcaption></figure>

* **E.** Select the specific Channel or Group you are adding as a task. **Crucially, `@PinkSaleLaunchBot` must be added as an admin** in that target Channel/Group *before* you do this step for the verification and task tracking to work correctly.
* **F.** Once verified through the bot, the task setup on the Pinksale page should complete.

<figure><img src="https://191452618-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MdJrJV-Z8jLCR-JNtlx%2Fuploads%2FU46SGUKPfKKwVw1apM5z%2F53.png?alt=media&#x26;token=34a6472f-7e89-419f-becb-a39c3fcce8fe" alt=""><figcaption></figcaption></figure>

### Q\&A (FAQs) <a href="#qa-faqs" id="qa-faqs"></a>

* **Q1:** What's the difference between the bot I create with BotFather and `@PinkSaleLaunchBot`?
  * **A:** The bot you create (`YourProject_bot`) is the one users will interact with to start the airdrop and see tasks. `@PinkSaleLaunchBot` is a utility bot used by Pinksale (and you during setup) to verify that *your* bot has the necessary permissions within the specified Telegram groups or channels for tasks like checking membership.
* **Q2:** Do I need coding skills to set up this bot?
  * **A:** No, Pinksale provides the interface to configure the bot's tasks and logic. You only need to follow the steps to create the basic bot shell using Telegram's `@BotFather` and then configure it through the Pinksale website.
* **Q3:** What kind of rewards can users get?
  * **A:** The system primarily seems based on earning "Reward points" for completing tasks, as shown in the setup images. How these points translate into actual token rewards or other benefits would likely depend on further configuration within Pinksale or rules defined by the project team separately.
* **Q4:** Can I add custom tasks not listed in the options?
  * **A:** Based on the documentation, you select tasks from the predefined options provided by the Pinksale interface (Join Group, Subscribe Channel, Connect Wallet, etc.). Creating fully custom tasks would likely require different tools or custom bot development.

### Troubleshooting <a href="#troubleshooting" id="troubleshooting"></a>

* **Q:** BotFather isn't responding to `/newbot`.
  * **A:** Ensure you are interacting with the official `@BotFather` (it has a blue checkmark). Telegram might occasionally have delays. Try the command again after a short wait. Make sure you clicked "Start" first.
* **Q:** Pinksale gives an error when I input my Bot Token in Step 3.
  * **A:** Double-check that you copied the *entire* HTTP API token correctly from BotFather. Make sure there are no extra spaces before or after the token.
* **Q:** Verification fails for the "Join Group" or "Subscribe Channel" task (Step 4 of Adding Tasks).
  * **A:** The most common issue is forgetting to **add `@PinkSaleLaunchBot` as an administrator** in the target Telegram group or channel *before* trying to verify it via the bot steps. Ensure it has the necessary permissions (often just basic admin rights are needed, not necessarily posting rights).
* **Q:** Users are completing tasks, but the bot isn't registering them correctly.
  * **A:** Re-check the configuration for each task on the Pinksale Tele Airdrop management page. Ensure links/IDs for groups/channels are correct. For wallet connections or premium checks, ensure the user is interacting correctly with the bot's prompts. There might be delays in updates, or potential bugs; consider contacting Pinksale support if issues are widespread.
