Skip to content
Help for campaign teams

Setting up WhatsApp, Telegram and SMS

You write one message in Communication → Send and pick where it goes. What happens next depends on the channel, because each provider allows different things. These are their rules, not ours — knowing them before polling season saves a lot of grief.

What each channel can do
TelegramWhatsAppSMS
Post to groups you already runYes — automatically, any group the bot is inYes — through the cockpit; you press send in each group—
Message one personOnly people who pressed Start on your botYes, from a Cloud API number; a template after 24 hours of silenceYes, from your own phone in the cockpit
Group sizeUp to 200,000Your groups as they are (up to 1,024)—
PollsNative polls, in groups tooNo poll API exists—
Read group messages for summariesYes, with the bot's privacy mode offNoNo
Bulk sendingPaced automaticallyNever automated — protects your number from a banFrom your own phone, up to 100 a day; sender-ID SMS needs TRAI DLT

The Desk — WhatsApp, Telegram and SMS side by side

Communication → Desk shows your three channels next to each other inside DemocracyIndia, each on your own number or account, with one box on top: pick people from your contacts, write once, tick WhatsApp, Telegram and SMS, and press Check, then Send. Only contacts who agreed to hear from you are messaged, and nothing goes out during your silence period.

WhatsApp Web, Telegram Web and Google Messages themselves cannot be opened inside another website — they forbid it. If you want those exact apps side by side, use the cockpit with the DemocracyIndia browser extension.

Telegram — your own account

  1. In Connected numbers, press Sign in with a QR code.
  2. On your phone, open Telegram → Settings → Devices → Link Desktop Device and scan the code. If you set a two-step verification password in Telegram, type it in when asked.
  3. No phone at hand? Choose Use my phone number instead: Telegram sends a code to your Telegram app, and you type it in.
  4. Your recent chats appear in the Desk. Messages you send there go out as you; Telegram shows DemocracyIndia as a logged-in device you can end at any time.

Telegram restricts accounts that message many new people. DemocracyIndia sends first messages to at most 40 people a day, with a pause between each. People who are not on Telegram, or hide their number, are skipped. Sending to someone by number adds them to your Telegram contacts.

Telegram — your groups, automatically

  1. In Telegram, open @BotFather, send /newbot, give it a name (e.g. “Sultanpur Office”) and a username ending in bot. It replies with a token.
  2. Paste the token in Communication → Connected numbers. We check it and connect in one step.
  3. Add the bot to each of your groups (booth groups, karyakarta groups, your channel) and make it an admin. Each group appears in your list by itself — there are no group IDs to type.
  4. For group summaries, send BotFather /setprivacy → Disable; otherwise a bot only sees messages addressed to it.

WhatsApp groups — through the cockpit

No WhatsApp business API can post into a group you already run, at any price. So your groups are reached from your own WhatsApp, in the cockpit: it opens each group and fills in the message, and you press send. Unattended bulk posting is exactly what gets a number banned — the number is yours, so the last press is too.

  1. Open the cockpit page and install the DemocracyIndia Cockpit — the Chrome extension, or the Windows app.
  2. Sign in to WhatsApp Web once inside it by scanning the QR code with your phone (WhatsApp → Linked devices).
  3. Register the groups you want to message. They then appear as destinations in Send.
  4. After you send, the cockpit has your groups queued: it opens each in turn with the message filled in.

A WhatsApp Business number — one-to-one

Easiest: press Connect with Facebook in Connected numbers, sign in, and pick your WhatsApp Business number. If you use the WhatsApp Business app on it, tick the box to keep using it: Meta shows a QR code, you scan it with the WhatsApp Business app on your phone, and your one-to-one chats then sync both ways with the Desk. The account is yours and Meta bills it directly: add a card or UPI under Meta Business → Billing & payments. Replies within 24 hours are free; starting a conversation uses a paid, approved template.

Or connect by hand, if you already run a WhatsApp Cloud API app:

  1. In Meta Business (business.facebook.com) create an app with the WhatsApp product, and add your number.
  2. From WhatsApp → API Setup copy the phone number ID, the WhatsApp Business Account ID, and a permanent system-user access token.
  3. Paste them in Connected numbers. We then show the webhook address to put in your Meta app, subscribed to messages.

WhatsApp lets you write freely to someone for 24 hours after they last wrote to you. After that, only a pre-approved template message can open the conversation again. A number connected this way is used through our inbox; keeping it in sync with the WhatsApp app on your phone needs onboarding by a Meta partner, which we do not offer yet.

SMS

In India, bulk SMS from a sender name (like DI-OFFICE) must be registered on TRAI's DLT platform — your entity, the sender header and every message template. DemocracyIndia does not send sender-ID SMS. Instead, your own Android phone sends. In Connected numbers, press Connect my phone for SMS and scan the QR code with that phone. It opens the steps: install the free SMS Gateway for Android app, press Start, choose By Codeand paste the code shown. The phone connects by itself — there is no password to copy. Texts then go out from your SIM and number to contacts who agreed to hear from you — at most 100 a day per phone, so your operator does not treat the SIM as a bulk sender. Keep the phone charged and online while it sends.

Press Receive replies to see answers in the Desk. Only texts from your contacts, or from numbers you have texted from DemocracyIndia, are kept; everything else your phone receives (bank codes, family, offers) is ignored and never stored.

For one-off texts, the cockpit's third window (Google Messages for web) also sends from your phone.

Messaging a village or booth list

Village contact lists hold voters who gave their number and agreed to hear from you. Text a list from your own phone with “Text from my phone” on the list (after connecting your phone above). For larger lists, invite them to that village's Telegram or WhatsApp group (your workers can do this door to door), then send to the group from Communication → Send. Never add people to a group or message them without their agreement — it is the law (DPDP Act) and it is also what gets numbers reported.

The silence period

Section 126 of the Representation of the People Act bars campaign messages in the 48 hours before polling ends. Send is switched off automatically for that window, using your campaign's poll date. Replying to people who write to you still works.

Back to your setup · Getting your constituency data