TrapyfyDocs

Connect Your Telegram Bot

Create a Telegram bot using BotFather and connect it to Trapyfy as the customer-facing storefront.

Overview

Trapyfy uses a Telegram bot as the customer-facing storefront. The bot is created in Telegram using BotFather and connected to Trapyfy using the bot token. Once connected, customers can browse products, add to cart, and place orders directly inside Telegram.

1

Create a bot in BotFather

  1. Open Telegram.
  2. Search for BotFather and open it.
  3. Type /newbot and send.
  4. Enter the bot display name (shown to customers).
  5. Enter the bot username (must end in bot, e.g. mystore_bot).
  6. BotFather will confirm creation and provide a bot token. Copy this token.
2

Add the bot token in Trapyfy

  1. Sign in to Trapyfy at trapyfy.com.
  2. Open Organizations from the left-hand panel.
  3. Select your organization.
  4. In the top-right corner, click Manage Platform Keys.
  5. Click Add Key (or edit an existing Telegram key).
  6. Select Telegram as the platform.
  7. Paste the bot token into the input field.
  8. Click Create (or Save).
  9. Confirm the bot status shows connected/active where available.
Manage Platform Keys — add Telegram bot token
3

Test the bot

  1. Open the Telegram bot you created.
  2. Tap Start or type /start.
  3. Confirm the welcome message appears.
  4. Enter the store and confirm categories and products appear.

If the store appears empty, confirm your products are Published and have pricing configured for the correct country.

Optional: Secret phrase

Some Trapyfy configurations use a secret phrase as a bot activation step. This is an optional or legacy flow — only relevant if your setup requires it.

  • If prompted, enter the phrase exactly as configured in Trapyfy.
  • The phrase is case-sensitive and includes any special characters or spaces.
  • To reset or change the phrase, go to organization settings.
Optional secret phrase configuration

Troubleshooting

Bot token copied incorrectly

Re-copy the token from BotFather. Ensure no extra spaces before or after the token.

Bot not responding to /start

Confirm the bot was created in BotFather and the correct token was pasted into Trapyfy. Try messaging the bot directly in Telegram first.

Wrong bot token

Invalid tokens return the same connectivity error as restricted accounts. Double-check the token matches the bot you intend to connect.

Bot already connected elsewhere

A bot token can only be used by one service at a time. Disconnect it from any other platform before connecting to Trapyfy.

Connection status not updating

Save the platform key and refresh. If the status remains inactive, verify the token is correct and try creating a new bot in BotFather.

Network blocking Telegram

Some networks, VPNs, or firewalls block api.telegram.org. Disable or switch your VPN/proxy and retry.

Telegram account or bot restricted

Telegram may restrict accounts due to suspicious activity or policy violations. Create a fresh bot in BotFather and reconnect.

You can continue setup even if the bot is not yet active. The bot token can be replaced at any time in Organizations → Manage Platform Keys.

Additional platform keys

If you need to add keys for other platforms (such as WhatsApp or Signal, where supported), follow the same flow in Organizations → Manage Platform Keys and select the relevant platform type.

Additional platform keys are not required for the Telegram storefront launch workflow.

Related pages

Launch Your StoreGo-Live ChecklistFAQs & Troubleshooting

Need help?

Email [email protected] with your merchant name, store or order reference, screenshots or error messages, and a short description of the issue.