Campaigns
A campaign is one message to a list of people from your Telegram accounts. Only the phone sends, from the official Telegram. After this page you will create a campaign, start it and understand recipient statuses.
Create a campaign
Open Campaigns and press Create campaign. The wizard has five steps.
Step 1. Recipients
- Enter the Campaign name.
- Paste recipients into Recipients, one per line. A
@username, at.me/...link or a phone number with country code all work. You can add a name after a semicolon. - If you want to compare lists, fill in List with where these recipients came from (optional).
- Press Continue.
Step 2. Message
- Write the text in First message.
- Press Preview text and read what comes out.
- If needed, turn on the Second touch (further down this page).
- Press Continue.
| What you write | What the person gets |
|---|---|
{Hello|Good afternoon} | One of the variants, so messages are not identical. |
[[city]] | The field value from your list. |
[[city|your city]] | The field value, or the fallback text if it is missing. |
[[name|]], good afternoon! | For “Ivanov Ivan Ivanovich” you get “Ivan, good afternoon!”, and without a confidently recognised name just “Good afternoon!”. |
Personal name
[[name|fallback]] is a service variable. gGram takes the first name from the Name, Full name, first name, name or full name columns and checks it against a built-in dictionary of full names. Case does not matter. Initials, Latin spelling, unknown forms and conflicting columns give text without a name.
Step 3. Auto-reply
Here you can set one ready answer for people who reply to the campaign. If you do not need it, just press Continue. Details below, in Auto-reply.
Step 4. Phones and accounts
Tick the accounts to send from. They are grouped by phone, and you see how much each can send today. Nothing ticked: all accounts on your phones send. Phone offline or paused? Its messages wait in the queue and go out when it is back. Press Continue.
Step 5. Review
- Check the name, recipient count, message, auto-reply, second touch and accounts.
- Press Estimate: the dashboard shows how many messages will go out and how many the Do not write list filters out. Nothing is sent.
- Press Save and start or Save draft.
How a campaign runs
- A draft sends nothing. Sending starts only after you start the campaign.
- Every message becomes a task in the phone's queue. The phone takes tasks one by one.
- Check in Phones that the phone is Online and not paused.
- If the phone goes offline, tasks wait and the campaign pauses until it is back.
Recipient statuses
| Status | What it means | What to do |
|---|---|---|
| queued | The message is waiting its turn on the phone. | Nothing. |
| waiting for the phone | The phone is offline or paused. | Check the phone on the Phones page. |
| sent | The phone sent the message and saw that it went out. | Nothing. |
| verifying send | The phone tapped Send but saw no confirmation. | Nothing. The phone opens the chat again and checks. |
| not sent | The message did not go out. | Click the row and read the reason. |
| cancelled | You cancelled the send, the person replied, or they are on the Do not write list. | Nothing. |
The verifying send status
Sometimes Telegram does not show the phone whether a message went out. Then the phone opens that chat again and checks whether the message is there. There is only one retry, so a recipient never gets more than two identical messages. If it still cannot tell, the status becomes not sent.
Auto-reply
An auto-reply is one ready answer to a person who replied to the campaign. You write what to send. Do not rely on it alone: check Chats, the lead's reply arrives there, in that campaign's dialog, and you can answer from there. For a real conversation without you, connect the AI.
- In the wizard open the Auto-reply step.
- Turn on Reply to the first answer.
- Write the Auto-reply text.
- Press Continue.
The Do not write list
The Do not write button above the campaign list opens the list of people gGram does not write to in any campaign. Enter a @username or a number and press Add to list. The person disappears from drafts, and their queued messages are cancelled.
Second touch
On the Message step expand the Second touch block. It is off by default.
- Turn on Send another message later.
- Choose after how many days: 2, 3 or 5 after the first send.
- Choose who gets it: Read but did not reply or Everyone who did not reply.
- Write a different text. It must differ from the first message, including after fields are filled in.
Campaign buttons
| Button | What it does |
|---|---|
| Pause | Pauses the campaign. No new tasks go to the phone. |
| Resume | Lifts the pause. |
| Edit | Opens the wizard for a draft or a paused campaign. |
| Save as a set | Remembers the text and campaign settings to start a new one from them. |
| To trash | Moves the campaign to the trash. It can be restored from there. |