Phones
In Phones you connect phones and see whether they are ready to work. Messages go out only from them: from the official Telegram, from accounts you signed in to on the phone. After this page you will have an online phone that can send messages and warm accounts up.
Connect a phone
You need a phone on Android 7.0 or newer (tested on Android 13) with the official Telegram from Google Play or telegram.org, updated to the latest version. Telegram X and other clients do not work.
- Download the app at ggram.xyz/download and install it. If Android asks, allow installs from this source. If Play Protect stops the install, tap More details, then Install anyway.
- In Settings, Apps, gGram tap ⋮ in the top right corner and Allow restricted settings.
- Turn on the gGram service in Accessibility.
- Give gGram notification access.
- Turn on the gGram keyboard.
- Remove battery restrictions for gGram, and on Xiaomi, Redmi and POCO also turn on Autostart.
- Sign in to the official Telegram on this phone and check that Telegram notifications are on.
- In the dashboard open Phones, press Connect a phone, and in the gGram app scan the QR code on the dashboard screen or type the 6-digit code. Accounts (up to 3) appear in the dashboard by themselves.
Permissions in the app
The app walks you through the steps and shows what is already on. The order is the same as on the App page.
| Permission | Why it is needed |
|---|---|
| Restricted settings | On Android 13 and newer an app installed from a file cannot get Accessibility and notification access until you allow it on the gGram App info screen via ⋮. Without it the switches are grey. |
| gGram service in Accessibility | Lets the app open chats, enter text and tap Send in Telegram. Without it the phone sends nothing. |
| Notification access | The phone reads Telegram notifications so lead replies reach Chats in the dashboard. This is a separate access, not the same as allowing gGram to show notifications. |
| gGram keyboard | A backup input method when the service cannot paste text. Keep your own keyboard as the main one. |
| Battery and autostart | Unrestricted battery usage, and Autostart on Xiaomi, Redmi and POCO. Otherwise Android may unload gGram in the background. |
| Telegram notifications | A setting of Telegram itself, not of gGram. Notifications for private messages must be on both in Telegram and in Android settings. If they are off, lead replies do not reach the dashboard. The gGram app warns you if it sees they are off. |
| gGram notifications | An icon in the status bar so Android does not unload gGram from memory. |
Phone card
A phone card appears in the dashboard. What it shows:
| What it says | What it means | What to do |
|---|---|---|
| Online | The phone answers the dashboard. | Nothing. |
| No connection | The dashboard has not heard from the phone for a while. Tasks wait in the queue. | Hover the ⓘ next to Last signal for a hint. |
| Paused | Someone pressed Stop on the phone, Disable phone or Stop everything. | Press Resume. |
| Screen is off | The phone cannot work with Telegram. | Unlock the phone and turn on Keep screen on in the app. |
| gGram service is off | No Accessibility access. | Turn the service on in the app. |
| gGram keyboard is off | No backup input method. | Turn the keyboard on in the app. |
| No notification access | Lead replies will not reach the dashboard. | Allow notification access in the app. |
| Telegram notifications are off | Telegram on the phone shows no notifications, lead replies will not reach the dashboard. | Turn on notifications for private messages in Telegram and in Android settings. |
| The phone is in use | You are using the phone yourself right now. gGram pauses tasks so it does not get in the way. | Nothing. Tasks continue once the phone is free. |
| Telegram is not installed | The phone has no official Telegram. | Install Telegram and sign in. |
The card also shows the phone's accounts (up to 3), battery, app version and the task queue: how many are waiting and how many are running. The phone does one task at a time.
If the phone is offline
- Find Last signal on the card and hover the ⓘ.
- Check that the phone has internet and gGram is open.
- If it does not come back within a couple of minutes, close gGram and open it again.
While the phone is away, tasks wait in the queue and the campaign pauses. Once it is back, the phone continues by itself. Click the card to open the phone window. At the bottom are Disable phone (a pause; accounts and tasks stay) and Remove phone (accounts go to the archive). Both ask for confirmation.
Keep the phone on charge
Lead replies arrive right away while the screen is on. Plug the phone in, open the phone screen in the app and check that Keep screen on is enabled. Without a charger the app warns you that the screen may go dark.
Pause and Stop
| Button | What it does |
|---|---|
| Stop on the phone | A round button over the screen. Drops the current task and pauses this phone. |
| Disable phone | The same from the dashboard, in the phone window. |
| Resume | The phone takes tasks from the queue again. The button is on the phone card in the dashboard. |
| Disable all phones | Pauses every phone at once. You type the confirmation word to proceed. |
| Refresh accounts | The phone re-reads its Telegram accounts; the list updates in about a minute. |
Update the app
- Press Stop on the phone so it does not take a new task.
- Download the new version at ggram.xyz/download and install it over the old one.
- In the dashboard press Resume.