Telegram: connect your store’s bot
Your AI shop assistant answers your customers through your own Telegram bot, and your team takes over when they need a person.
What it does
Emporiqa answers the messages your customers send to your store’s Telegram bot, from your products and your pages, as the chat on your shop does. When a customer needs a person, your team answers them in Conversations. The bot stays yours: you create it in Telegram and keep it in @BotFather. It answers private chats only, not groups or channels.
Before you connect
- You are the store owner in Emporiqa, and Handoff is on (Settings > Handoff): your team answers when your AI shop assistant can’t.
- A bot for your store. In Telegram, open @BotFather and send /newbot, or use a bot you already have.
- The bot’s token. @BotFather gives it to you when it creates the bot, and /token shows it again. Anyone with the token can control your bot, so don’t share it.
- Your store’s privacy policy link, set for the bot in @BotFather. Telegram asks every bot for one, and the standard policy it applies to a bot without its own does not allow sharing customers’ data with third parties such as Emporiqa.
Connect your bot
- In the dashboard, open Settings > All channels.
- On the Telegram card, press Connect.
- Paste the bot token and press Connect.
- The card says Connected. Send your bot a message from Telegram to try it.
Emporiqa checks the token with Telegram, points the bot’s messages to Emporiqa, and stores the token encrypted: it is never shown again. If the bot already answered through another service, it stops there and answers here, and the messages that were waiting for that service are not answered. A store has one bot: connecting another one replaces the first.
What your customers get
- When a customer opens your bot and taps Start, they get your chat’s welcome message.
- The first answer in each conversation tells them they are chatting with an AI assistant and can ask for a person from your team.
- Telegram shows the bot as typing while your AI shop assistant writes its answer.
- Product photos come with the answer, several products as one album.
- Suggested replies show as buttons under the message box, which close after a tap.
- Customers can send photos when Let shoppers send photos is on in your chat settings. Otherwise the bot asks them to type their message.
- Files (PDF, Word, Excel, up to 10 MB) are kept for your team in Conversations. Your AI shop assistant does not read them, and a file sent on its own goes to your team.
- For a voice note, the bot asks the customer to type their message, and your team sees that a voice note came in.
- A customer who sends STOP gets one line confirming it, and nothing more until they write again. A customer who blocks your bot gets nothing more from it until they write again.
Your team
Telegram conversations are in Conversations with the others. Press Take over to answer a customer yourself, and Hand back to the chat to let your AI shop assistant answer again. Telegram has no reply window: your team can answer at any time. Messages show a single tick, because Telegram does not tell bots when a message arrives or is read.
What it costs
- Telegram charges nothing for the messages your bot sends and receives.
- Emporiqa charges for the conversations its AI answers through your bot. They are paid from your Emporiqa balance and count toward your monthly limit, as chats on your shop do.
From the chat on your shop to Telegram
When the chat on your shop hands a customer to your team, it can show a Telegram button, so they can go on in your bot. For that, list your bot in Settings > Handoff: on the Telegram card in Settings > All channels, press Show it to website shoppers when they ask for a person. The button links the two chats: your AI shop assistant reads the customer’s own earlier messages from the website chat, never its own replies or your team’s, and an open handoff comes along. Nothing else from the visit to your shop does. The link works for one hour.
Disconnect
On the Telegram card in Settings > All channels, press Settings, then open Disconnect Telegram, or ask us to do it. Your bot stops answering at once: Emporiqa deletes its token, stops its messages from coming to Emporiqa, and does not send messages still waiting to go. The bot stays yours in @BotFather. Conversations stay in Conversations until 90 days after their last message.
Troubleshooting
That doesn’t look like a bot token
Copy the whole token from @BotFather: the number, the colon and everything after it, for example 123456789:AAE followed by more letters and numbers.
Telegram doesn’t accept this token
The token was changed or the bot was deleted. Send /token to @BotFather, choose your bot, and paste the token it gives you.
This bot is already connected to another store
A bot answers for one store. Disconnect it from the other store first, or create a new bot for this one.
The card says Needs reconnecting
Telegram no longer accepts the bot’s token, usually because it was changed in @BotFather, so replies are not going out. Press Reconnect and paste the bot’s current token.
Create a free account, then open Settings > All channels in the dashboard.
Create a free account