Telegram · COMMENT ÇA MARCHE
Envoyez des codes OTP via l'API Bot Telegram. Novauth résout le numéro de téléphone vers un utilisateur Telegram, livre le code et laisse votre serveur le vérifier — avec un suivi complet du statut, le contrôle du TTL et la prise en charge de la révocation.
code_valid · TTL 300s
request_id: 01JXTG…
phone resolved → user_id
De la saisie du numéro à la vérification — étape par étape.
Utilisateur
L'utilisateur appuie sur 'Vérifier avec Telegram' dans votre app
Votre backend
POST /telegram avec le numéro de téléphone, le code OTP et le TTL
Novauth
Résout téléphone → ID utilisateur Telegram · valide l'OTP et le TTL
API Bot Telegram
OTP livré dans le chat Telegram de l'utilisateur via l'API Bot officielle
Telegram de l'utilisateur
La notification Telegram arrive · l'utilisateur voit le code OTP dans le chat
Vérifié
Le serveur appelle check-verification-status · renvoie code_valid ou expired
L'utilisateur appuie sur 'Vérifier avec Telegram' dans votre app
POST /telegram avec le numéro de téléphone, le code OTP et le TTL
Résout téléphone → ID utilisateur Telegram · valide l'OTP et le TTL
OTP livré dans le chat Telegram de l'utilisateur via l'API Bot officielle
La notification Telegram arrive · l'utilisateur voit le code OTP dans le chat
Le serveur appelle check-verification-status · renvoie code_valid ou expired
Endpoint de l'API
POST /api/v1/connect-hub/telegramVotre serveur appelle POST /telegram/check-verification-status avec le request_id. Telegram valide le code côté serveur — sans saisie de l'utilisateur dans certains flux, réduisant la friction.
Chaque requête a un TTL (30–3600 s). Appelez POST /telegram/revoke-verification à tout moment pour invalider un code en attente — essentiel pour les flux de renvoi et pour limiter les abus.
Les réponses incluent request_cost, remaining_balance et delivery_status (envoyé → livré → lu → expiré). Les webhooks se déclenchent à chaque changement d'état.
2 $ de crédit offert, aucune carte bancaire requise. Documentation complète et environnement de test inclus.