On Telegram, businesses talk to customers through a bot: an account with its own name, picture and link (for example t.me/windandwool_bot). Customers find your bot, tap Start and write to it; their messages arrive in the PALMS inbox and your team answers from there. You create the bot yourself in Telegram with BotFather, Telegram’s official tool, then paste its token in PALMS. It takes about 5 minutes and it’s free.
Before you start
- Telegram on your phone or computer, signed in to your account. Any account works; it becomes the bot’s owner.
- A name for the bot: customers see it, so use your business name, for example Wind & Wool.
- A username ending in
bot, for examplewindandwool_bot. Have two or three ideas in case the first is taken. - Already have a bot for your business? You can connect it: see an existing bot.
Open BotFather
- In PALMS, click Open BotFather. On a computer without Telegram, scan the QR code with your phone’s camera instead: it opens BotFather in the Telegram app.
- Check the chat is @BotFather with a blue tick. Other accounts with similar names aren’t Telegram’s: never give them your token.
- Tap Start at the bottom of the chat. BotFather lists its commands.
Create your bot
Send these three messages to BotFather:
/newbot. BotFather asks for a name.- The bot’s name, for example
Wind & Wool. You can change it later. - The bot’s username: 5 to 32 letters, numbers or
_, ending inbot— for examplewindandwool_botorWindAndWoolBot. It can’t be changed later, and it becomes your link:t.me/windandwool_bot.
BotFather answers “Done! Congratulations on your new bot…” with the token: a long code such as 123456789:AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsaw0. Tap it to copy it.
- “Sorry, this username is already taken”: try another one, for example with your city:
windandwool_accra_bot. - Keep the token secret. Anyone who has it controls the bot. PALMS stores it encrypted and never shows it again.
- To give your bot a picture and a description, send
/mybots→ your bot → Edit Bot. PALMS shows the new picture after Test on the channel.
An existing bot
If your business already has a bot, you don’t need a new one: in BotFather send /mybots, choose the bot, then API Token and copy it. Then go to paste the token.
When PALMS connects the bot, Telegram delivers its messages to PALMS only: another tool that received them (a chatbot builder, a script) stops receiving them. Disconnect the bot there first if you used one.
Paste the token
Paste the token in PALMS and click Connect the bot. You can paste BotFather’s whole message: PALMS picks the token out of it. PALMS then:
- checks the token with Telegram and shows your bot’s name, username and picture;
- stores the token encrypted;
- tells Telegram to deliver the bot’s messages to PALMS, with a secret only PALMS and Telegram know.
If Telegram refuses the token, the wizard explains why and how to fix it; see also Telegram errors.
Test your connection
PALMS shows a code such as PALMS-4821, a button and a QR code.
- Click Open the bot (or scan the QR code with your phone).
- Tap Start: Telegram sends the code to your bot for you.
- PALMS answers in Telegram and the step shows a success tick.
Already chatted with the bot? Type the code and send it. If nothing arrives, see the test message didn’t arrive.
What works on Telegram
- Customers write first. A bot can only message people who started it. Share the bot’s link (
t.me/your_bot) on your website, social profiles, receipts and packaging. - No 24-hour window and no templates: once a customer has started the bot, you can answer at any time.
- Text, photos, videos, voice notes, documents, stickers, locations and contacts arrive in the inbox. You can send text, photos, videos, audio and documents.
- Private chats only. Messages in groups and channels where the bot is added aren’t brought into PALMS.
- Free: Telegram doesn’t charge for bots.
- If a customer blocks the bot, your messages to them fail with an explanation; they can unblock it or tap Restart to write again.
Reconnect
Reconnect when the channel shows Reconnect needed — usually because the token was revoked in BotFather — or after another tool took over the bot.
- In BotFather, send
/mybots, choose the same bot, then API Token. If the token leaked, tap Revoke current token first and copy the new one. - In PALMS, Settings → Channels → Reconnect on the Telegram channel, paste the token and click Reconnect the bot.
PALMS checks the token belongs to the same bot. Conversations and history stay as they are. To use a different bot, connect it as a new channel.
Disconnect
Disconnect in Settings → Channels stops Telegram delivering the bot’s messages to PALMS and deletes the token from PALMS. The bot itself stays yours in Telegram; delete it in BotFather with /deletebot if you no longer need it.