Telegram API Setup

To monitor private Telegram channels, you need to provide your Telegram API credentials. This guide shows you how to get API ID and API Hash from my.telegram.org.

Why do I need this?

Private channels cannot be accessed publicly. GHOSTwire uses YOUR Telegram session to read private channels where you're a member. API credentials allow the bot to authenticate as you.

Step 1: Go to my.telegram.org

Open your browser and navigate to https://my.telegram.org

🌐 my.telegram.org
Enter your phone number to log in

Step 2: Log in with your Telegram Account

Enter your phone number (international format, e.g., +1234567890) and click "Next". You'll receive a confirmation code on Telegram.

Enter Phone Number

Use international format: +1234567890

Enter Confirmation Code

Check Telegram for the 5-digit code

Access API Tools

Once logged in, click on "API Development Tools"

📱 Telegram Login
Sign in to Telegram Phone Number: +1234567890 ───────────── Code: _ _ _ _ _ ───────────── We've sent a confirmation code to your Telegram app.

Step 3: Create an Application

After logging in, go to API Development Tools and create a new app.

Fill App Title

Enter "GHOSTwire" or any name you prefer

Fill Short Name

Enter "ghowr_bot" or any short name

Click "Create Application"

Your app will be created instantly

Create Application

App title: GHOSTwire
Short name: ghowr_bot
URL: (leave empty)
Description: (optional)

[ Create Application ]

Step 4: Copy Your API Credentials

After creating the app, you'll see your api_id and api_hash. Copy these values — you'll need them in the bot.

Copy App api_id

This is a number (e.g., 12345678)

Copy App api_hash

This is a long string (e.g., abc123def456...)

Keep them safe

You'll need these for the bot setup

Your Application

App title: GHOSTwire
Short name: ghowr_bot
App api_id: 12345678
App api_hash: abc123def456789...

Created: 2026-01-15

Step 5: Enter Credentials in GHOSTwire

Now go to the bot and enter your API credentials.

Open GHOSTwire Bot

Go to @ghowr_bot on Telegram

Go to TG Auth

Click 🔐 TG Auth from main menu

Setup Credentials

Click Setup Credentials

Enter API ID, Hash, Phone

Paste your api_id, api_hash, and phone number

👻 @ghowr_bot
🔐 Step 1/3 Enter your API ID (from my.telegram.org): Type cancel to abort. « Back
🔐 Step 2/3 Enter your API Hash: « Back
🔐 Step 3/3 Enter your Phone (+1234567890): « Back
✅ Credentials Saved! Now click Connect Session to authenticate.
Quick Reference
1. Go to my.telegram.org
2. Log in with your phone number
3. Go to API Development Tools
4. Create an app (any name works)
5. Copy api_id and api_hash
6. In GHOSTwire: 🔐 TG Auth → Setup Credentials
7. Paste API ID, API Hash, and Phone
8. Click Connect Session → Complete login

Troubleshooting

"Invalid API ID" error

Make sure you're copying the api_id (number) correctly, not the api_hash. The API ID is usually 6-8 digits.

"API Hash is incorrect" error

The api_hash is a long string (32+ characters). Double-check that you copied the entire hash without extra spaces.

Can't log in to my.telegram.org

Make sure you're using the correct phone number with country code. If you have 2FA enabled, you'll need to enter your 2FA password after the code.

🔐 Security Notes
  • Your API credentials are never shared with anyone
  • The bot stores them encrypted in the database
  • You can revoke access anytime from my.telegram.org → API Development Tools → Delete App
  • Never share your api_hash with anyone

FAQ

Do I need to create a new app?

Yes. Create a new app specifically for GHOSTwire. You can name it anything — "GHOSTwire" is recommended.

Can I use existing API credentials?

Yes, you can reuse credentials from another app. However, creating a new app is recommended for better tracking.

Is this safe?

Yes. API credentials only allow the bot to read messages from channels you're a member of. The bot cannot send messages or access your personal chats.

What if I lose my API credentials?

You can always view them again from my.telegram.org → API Development Tools → Your App.