Sign in
Documentation

Quick start

Six steps from your first dashboard sign-in to your first campaign and replies to leads. Go in order: each step is needed for the next. You will need an Android phone (tested on Android 13) with the latest official Telegram, and a Telegram account to send from.

1. Connect the phone

All the work in Telegram is done by the phone, and the dashboard tells it what to do. So the first step is to install the gGram app on the phone and connect it to the dashboard.

  1. Download the app at ggram.xyz/download and install it. It is an APK file, it is not on Google Play. If Play Protect stops the install, tap More details, then Install anyway.
  2. Open Settings, Apps, gGram, tap ⋮ in the top right corner and choose Allow restricted settings. Without it, on Android 13 the gGram switch in Accessibility is grey.
  3. Turn on the gGram service in Accessibility.
  4. Give gGram notification access: this is how it sees lead replies.
  5. Turn on the gGram keyboard as a fallback input.
  6. Remove battery restrictions for gGram. On Xiaomi, Redmi and POCO also turn on Autostart.
  7. Sign in to the official Telegram on this phone and check that Telegram notifications are on. Without them lead replies do not reach the dashboard.
  8. In the dashboard open Phones and press Connect a phone. In the app scan the QR code or type the 6-digit code. The code is valid for 5 minutes.

A phone card marked Online appears in Phones. Details on the Phones page.

2. Find the account in the dashboard

The dashboard does not sign in to Telegram for you and asks nothing about the account. You sign in yourself in the official Telegram on the connected phone, and the account appears in the dashboard by itself.

  1. Check that you are signed in to the right account in the official Telegram on the connected phone.
  2. Wait a minute: the account appears under Accounts and on the phone card.
  3. Not there? On the phone card press Refresh accounts.

3. Start the warmup

Warmup: on a schedule the phone opens channels, scrolls the feed, joins channels from a list one at a time and leaves reactions. If you have several accounts on the phone, they add each other to contacts and chat a little. That way the account has an ordinary history before its first campaign.

  1. Open Warmup and press Create a new warmup.
  2. Tick the account and press Continue.
  3. Choose the Read only mode and press Continue.
  4. Keep the 09:00 to 21:00 window and press Continue.
  5. Check the summary and press Start.

The Today tab shows a row for the account with squares, one per visit. What they mean: see the Warmup page.

4. Send your first campaign

A campaign is one message to a list of people from your accounts. For the first run take one or two people you know and watch the phone: it opens the chat, types the text and taps Send by itself.

  1. Open Campaigns and press Create campaign.
  2. Enter a name and recipients, one @username per line. Press Continue.
  3. Write the message and press Continue.
  4. Skip the auto-reply for now: press Continue.
  5. Tick the account to send from. Press Continue.
  6. Check the summary and press Save and start.

The campaign gets a status and a sent counter. What the campaign card shows: see Campaigns.

5. Reply to leads in Chats

The phone catches a lead's reply from the Telegram notification, and the message appears in the dashboard, in that campaign's dialog. The campaign stops writing to that person. You can answer right from the dashboard: the phone opens the chat in Telegram and sends your reply. For this, Telegram notifications must be on on the phone.

  1. Open Chats.
  2. Pick the account on the left and the chat in the middle.
  3. Type a reply in the field at the bottom and press the send button.

To not miss replies, link @gGram_Notifications_Bot: it messages you in Telegram as soon as a lead replies. Filters and statuses are on the Chats page.

6. Connect the AI

The AI reads the conversation and prepares a draft reply, or answers by itself if you turned auto-reply on. AI replies also go out from the phone.

  1. Open AI and start the setup wizard.
  2. Go through eight steps: provider and model, about your business, conversation goal, materials, study, clarifications, what the model understood, a 26-question check.
  3. Choose the gGram balance (a shared key, gpt-4.1-mini) or connect your own key: OpenAI, Anthropic, OpenRouter.
  4. Check the AI's answers and press Turn on AI.

In Chats an AI draft block appears above the reply field with Send, Edit and Discard buttons. How to teach and limit the model: see the AI page.

If something is not working

Open If something goes wrong: it has a table of common situations and what to do in each. If yours is not there, write to us, contacts are on the Contacts page.