TelAI Tutorial

Step-by-step guide to using TelAI and connecting Telegram accounts

← Back to home

1. Getting Access

TelAI accounts are provisioned by HawkEyes. To request access, use the Sign Up button on the landing page to reach the HawkEyes contact form. Once your account is created, you will receive provisional login credentials from your administrator. On first login you must change your password and accept the Terms of Service before using the dashboard.

2. Logging In

  1. Navigate to the login page Go to /login or click Log In from the landing page.
  2. Enter your credentials Provide the username and password supplied by your administrator.
  3. Change your provisional password On first login TelAI requires a new password (at least 8 characters) before you can continue.
  4. Accept the Terms Review and accept the Terms of Service, Privacy Notice, and Operational Disclaimer.
  5. Open Mission Control After that you reach the TelAI Mission Control dashboard.

3. Connecting a Telegram Account

Before you can start a mission, you must connect at least one Telegram user account. You only need the phone number on that account. TelAI does not ask for API ID or API Hash.

Step 3a — Add the account in TelAI

  1. Open Telegram Connections On the dashboard, find the Telegram Connections panel at the top.
  2. Fill in the form Enter a Display Name (e.g. "Ops account") and your Phone Number in international format (e.g. +15551234567).
  3. Click Add Telegram Account The account will be saved and TelAI will request a login code from Telegram.

Step 3b — Verify with the login code

  1. Check your Telegram app Open the Telegram app on your phone. The login code appears inside the Telegram app, not as an SMS and not on this website.
  2. Enter the code In the account row on the dashboard, type the code into the Login Code field and click Submit Code.
  3. Enter 2FA password if prompted If your Telegram account has two-factor authentication enabled, also enter your cloud password in the field below the code.
  4. Wait for Connected status Once verified, the account status will show Connected and TelAI will begin listening for messages.
Tip: Login codes expire quickly. If your code no longer works, click Resend code to request a new one from Telegram. Note that Telegram may rate-limit code requests — wait the indicated time before trying again.
Important: The login code is delivered to your Telegram mobile or desktop app, not via SMS. Make sure you have Telegram open on a device linked to the phone number you entered.

4. Starting a Mission

  1. Set location and radius In the Start New Mission panel, enter a location name and a radius in kilometers.
  2. Select a Telegram account Choose a connected account from the dropdown. Only accounts with Connected status are available.
  3. Load channels and groups Click Load channels & groups to fetch the list of dialogs from your Telegram account. Select the channels or groups you want to monitor, or check All channels and groups.
  4. Start the mission Click Start Mission. TelAI will begin ingesting messages from the selected sources and scoring them against your mission parameters.

5. Reviewing Alerts

As messages arrive, TelAI scores them for risk relevance and displays matching alerts in the Alerts panel on your dashboard. Each alert includes the message content, source channel, timestamp, and risk score.

  • Pause a running mission to temporarily stop monitoring without losing configuration
  • Resume a paused mission to continue where you left off
  • Remove a mission when you no longer need it

Missions are automatically paused when you log out or close your browser tab. You can resume them manually from the dashboard at any time.

Need an account?

Contact HawkEyes to request access to TelAI.