HushCircuits Docs

Appearance

Return to top
On this page

Telegram Integration

HushCircuits runs as a full Telegram WebApp, giving you mobile access with native-feeling interactions, haptic feedback, and automatic authentication.

Linking Your Account

TELEGRAM LINK PROTOCOL

Secure handshake between web and mobile

🔑
GENERATE
📱
ENTER
🤝
VERIFY
✅
LINKED
1
GENERATE CODE

In the web app, go to Settings > Security & Telegram. Click "Generate Link Code" to get a one-time pairing code.

2
ENTER IN TELEGRAM

Open the HushCircuits Telegram bot. Enter the link code and your 6-digit PIN to initiate the handshake.

3
SECURE HANDSHAKE

The server verifies both the code and PIN. A cryptographic handshake links your Telegram account to your HushCircuits identity.

4
ACCOUNT LINKED

Your Telegram is now linked. You can use HushCircuits directly from Telegram with auto-authentication and haptic feedback.

HANDSHAKE: READY

Features in Telegram

When using HushCircuits through Telegram, you get:

  • Auto-authentication — No need to log in; your Telegram identity is verified automatically
  • Haptic feedback — Tactile responses on button presses, call events, and notifications
  • Viewport optimization — The interface adapts to Telegram's WebApp container
  • Close protection — Prevents accidental app closure during active calls
  • Cloud storage — Crash logs are stored in Telegram CloudStorage for debugging

From the Web App

  1. Go to Settings > Security & Telegram
  2. Click Generate Link Code
  3. A one-time code appears with an expiry timer
  4. Note the code — you'll enter it in Telegram

From Telegram

  1. Open the HushCircuits bot in Telegram
  2. Enter the link code from the web app
  3. Enter your 6-digit PIN for verification
  4. The handshake completes and your accounts are linked

WARNING

Link codes expire after a short time. If the code expires, generate a new one from the web app.

Haptic Feedback Levels

When using Telegram, you can configure vibration intensity in Settings > Haptics:

LevelDescription
SILENTNo vibration
SUBTLELight tap on interactions
TACTILEMedium feedback on all actions
IMPACTStrong vibration on key events

Telegram vs Web

FeatureWebTelegram
AuthenticationEmail/passwordAutomatic
Haptic feedbackNot availableConfigurable
Close protectionNot neededActive
Cloud crash logslocalStorageTelegram CloudStorage
PIN lockRequiredOptional (Telegram has its own lock)

Troubleshooting

IssueSolution
Link code expiredGenerate a new one from Settings > Security
Haptics not workingCheck Settings > Haptics — may be set to SILENT
App closes during callEnable close protection in Telegram settings
Can't find the botSearch for the HushCircuits bot in Telegram