Telegram · HOW IT WORKS
Send OTP codes via Telegram Bot API. Novauth resolves the phone number to a Telegram user, delivers the code, and lets your server verify it — with full status tracking, TTL control, and revocation support.
code_valid · TTL 300s
request_id: 01JXTG…
phone resolved → user_id
From phone number entry to verified — step by step.
User
User taps 'Verify with Telegram' in your app
Your Backend
POST /telegram with phone number, OTP code, and TTL
Novauth
Resolves phone → Telegram User ID · validates OTP and TTL
Telegram Bot API
OTP delivered to user's Telegram chat via official Bot API
User's Telegram
Telegram notification arrives · user sees OTP code in chat
Verified
Server calls check-verification-status · returns code_valid or expired
User taps 'Verify with Telegram' in your app
POST /telegram with phone number, OTP code, and TTL
Resolves phone → Telegram User ID · validates OTP and TTL
OTP delivered to user's Telegram chat via official Bot API
Telegram notification arrives · user sees OTP code in chat
Server calls check-verification-status · returns code_valid or expired
API endpoint
POST /api/v1/connect-hub/telegramYour server calls POST /telegram/check-verification-status with the request_id. Telegram validates the code server-side — no user input needed in some flows, reducing friction.
Every request has a TTL (30–3600s). Call POST /telegram/revoke-verification at any time to invalidate a pending code — essential for resend flows and rate-limiting abuse.
Responses include request_cost, remaining_balance, and delivery_status (sent → delivered → read → expired). Webhooks fire on every state change.
$2 free credit, no credit card required. Full docs and test environment included.