Telegram · COME FUNZIONA
Invia codici OTP tramite la Telegram Bot API. Novauth risolve il numero di telefono in un utente Telegram, consegna il codice e lascia che il tuo server lo verifichi — con tracciamento completo dello stato, controllo del TTL e supporto alla revoca.
code_valid · TTL 300s
request_id: 01JXTG…
phone resolved → user_id
Dall'inserimento del numero alla verifica — passo dopo passo.
Utente
L'utente tocca 'Verifica con Telegram' nella tua app
Il tuo backend
POST /telegram con il numero di telefono, il codice OTP e il TTL
Novauth
Risolve telefono → ID utente Telegram · valida OTP e TTL
Telegram Bot API
OTP consegnato nella chat Telegram dell'utente tramite la Bot API ufficiale
Telegram dell'utente
Arriva la notifica di Telegram · l'utente vede il codice OTP nella chat
Verificato
Il server chiama check-verification-status · restituisce code_valid o expired
L'utente tocca 'Verifica con Telegram' nella tua app
POST /telegram con il numero di telefono, il codice OTP e il TTL
Risolve telefono → ID utente Telegram · valida OTP e TTL
OTP consegnato nella chat Telegram dell'utente tramite la Bot API ufficiale
Arriva la notifica di Telegram · l'utente vede il codice OTP nella chat
Il server chiama check-verification-status · restituisce code_valid o expired
Endpoint dell'API
POST /api/v1/connect-hub/telegramIl tuo server chiama POST /telegram/check-verification-status con il request_id. Telegram valida il codice lato server — senza input dell'utente in alcuni flussi, riducendo l'attrito.
Ogni richiesta ha un TTL (30–3600 s). Chiama POST /telegram/revoke-verification in qualsiasi momento per invalidare un codice in sospeso — essenziale per i flussi di reinvio e per limitare gli abusi.
Le risposte includono request_cost, remaining_balance e delivery_status (inviato → consegnato → letto → scaduto). I webhook si attivano a ogni cambio di stato.
2 $ di credito gratuito, nessuna carta di credito richiesta. Documentazione completa e ambiente di test inclusi.