Jeton daccès télégramme

L’API de Telegram Gateway permet à n’importe quel service d’envoyer des codes d’autorisation via Telegram au lieu des SMS traditionnels, offrant ainsi une alternative plus abordable , plus sûre et plus fiable. Ce guide vous aidera à intégrer rapidement l’API dans votre service. Pour plus d’informations, consultez :

Indexer

Avant de commencer

TLDR : ouvrez cette page et connectez-vous avec votre numéro de téléphone Telegram, puis approvisionnez votre compte ici et notez votre jeton API.

Avant de commencer, vous devrez créer un compte sur notre plateforme de passerelle dédiée. Pour ce faire, accédez à la plateforme Gateway et cliquez sur « Se connecter pour commencer », puis confirmez votre connexion via Telegram. Si c'est la première fois que vous utilisez la plateforme, vous serez invité à fournir quelques informations de base sur vous-même et votre entreprise.

À des fins de test, vous pourrez envoyer des messages de vérification gratuits au compte Telegram lié au numéro que vous avez utilisé pour vous connecter.

Pour

envoyer des messages à d’autres utilisateurs de Telegram via l’API Gateway, vous devrez approvisionner votre compte. Pour ce faire, il vous suffit de vous rendre sur cette page et de cliquer sur « Ajouter des fonds sur Fragment », puis de suivre les instructions sur Fragment.

Sur la même page, vous trouverez un historique détaillé des transactions indiquant vos dépôts et dépenses.

Obtention de votre jeton API

Avant d’appeler des méthodes API, vous devez obtenir un jeton d’accès dans les paramètres de votre compte Telegram Gateway. Pour ce faire, ouvrez cette page et cliquez sur ' Copier le jeton '.

Le jeton doit être transmis dans chaque requête de l’une des deux manières suivantes :

• Dans l’en-tête HTTP :
• En tant que paramètre.

Dans ce guide, nous supposerons que vous avez décidé d’utiliser un jeton au porteur .

Pour renforcer la sécurité, vous pouvez limiter les adresses IP ou les plages d’adresses IP autorisées à utiliser votre jeton d’API à partir de cette page.

Interrogation de l’API L’API

peut être interrogée à l’aide des méthodes HTTP GET et POST dans le langage ou le cadre de votre choix. Tout au long de ce guide, nous utiliserons Python comme exemple et supposerons que vous avez défini ce qui suit :

Envoi de codes d’authentification

TLDR : Passez un numéro de téléphone (format E.164) à cette méthode pour envoyer directement un code d’authentification à l’utilisateur. Si vous avez besoin d’un essai pour vérifier que votre code peut être livré, utilisez cette méthode.

Pour envoyer à l’utilisateur un code généré par Telegram, vous pouvez utiliser la méthode sendVerificationMessage :

Si la méthode renvoie une erreur (par exemple, parce que l’utilisateur ne peut pas recevoir de codes), vous ne serez pas facturé. En cas de succès, il renverra un objet RequestStatus.

Vous pouvez éventuellement spécifier le paramètre, en désignant un canal vérifié que vous possédez comme celui à partir duquel le code sera envoyé à l’utilisateur. Lorsque vous vous envoyez des codes à des fins de test, le canal n’a pas besoin d’être vérifié.

Vérification que les codes peuvent être remis

Avant l’envoi, vous pouvez également utiliser la méthode checkSendAbility pour vérifier que l’utilisateur que vous souhaitez cibler peut recevoir des messages sur Telegram. Ceci est particulièrement utile lorsque vous avez généré un code vous-même, mais que vous devez vérifier qu’il peut avant de l’envoyer à l’utilisateur via l’API Gateway.

Le prix d’un message vous sera automatiquement facturé à l’avance si la méthode indique que l’utilisateur peut être contacté, que vous en envoyiez un ou non. Si la méthode renvoie une erreur (par exemple, parce que l’utilisateur ne peut pas recevoir de codes), vous ne serez pas facturé.

Si la vérification réussit et que vous décidez finalement d’envoyer un message, utilisez la méthode renvoyée par pour éviter de payer à nouveau les frais de message.

Révocation des codes

Vous pouvez éventuellement révoquer des codes avant même qu’ils n’expirent en passant le correspondant à la méthode revokeVerificationMessage. Les messages qui ont déjà été lus ne seront pas supprimés.

Notez que les codes révoqués ne sont pas remboursés. Si vous avez besoin d’envoyer des codes Gratuitement à des fins de test, dirigez-les vers votre propre numéro de téléphone.

Si

vous laissez Telegram générer un code pour vous (c’est-à-dire que vous n’avez pas fourni de paramètre dans votre demande), vous pouvez utiliser la méthode checkVerificationStatus pour vérifier l’OTP soumis par votre utilisateur.

Même si vous définissez le code vous-même, vous devez appeler cette méthode une fois que l’utilisateur a saisi un code, afin que nous puissions afficher des statistiques précises sur votre interface Gateway.

Lorsque

vous incluez un paramètre dans votre demande sendVerificationMessage, l’API Gateway envoie une demande POST à cette URL contenant un rapport de remise pour le message. La charge utile de la requête POST sera un objet JSON représentant l’objet RequestStatus approprié.
Lors du traitement des rapports, vous devez Vérifiez l’intégrité des données que vous recevez comme documenté ici.

Note : La dernière documentation de l’API est disponible ici, avec des explications détaillées pour chaque méthode et paramètre. Ce guide est destiné à vous aider à démarrer rapidement et suppose que vous êtes familier avec la programmation, la gestion correcte des erreurs, la sécurisation et le stockage adéquats des numéros de téléphone, des réponses et des informations d’identification.