Comment recevoir des SMS via l'API et les webhooks

Activez l'accès API dans votre profil, générez un jeton et appelez l'API avec. Pour que les SMS entrants soient envoyés à votre serveur, ajoutez une URL de webhook sur le même onglet.

Mis à jour 2 min de lecture

Vous pouvez lire vos messages et gérer vos numéros depuis votre propre code. Il y a deux façons d'obtenir les nouveaux SMS : les demander à l'API, ou laisser un webhook envoyer chacun à votre serveur dès son arrivée.

Obtenir un jeton API

  1. Étape 1. Ouvrez l'onglet API

    Allez dans Profile et ouvrez l'onglet API.

    Ouvrez l'onglet API. Allez dans Profile et ouvrez l'onglet API.
  2. Étape 2. Activez l'accès API

    Passez API access sur Enabled. Le même interrupteur coupe tout accès API si vous en avez besoin un jour.

  3. Étape 3. Générez le jeton

    Cliquez sur Generate token sous Personal access token. Le jeton n'est affiché qu'une fois : copiez-le et conservez-le en lieu sûr. Regenerate token en émet un nouveau et révoque le précédent.

  4. Étape 4. Appelez l'API

    Envoyez le jeton comme Bearer token dans l'en-tête Authorization. L'URL de base et un exemple curl prêt à l'emploi se trouvent sur le même onglet.

Tous les appels, paramètres et réponses sont dans la documentation de l'API.

Recevoir les SMS avec un webhook

Avec un webhook, nous envoyons une requête POST à votre serveur quand quelque chose se produit, sans que vous ayez à interroger l'API. Une fois l'accès API activé, une section Webhooks apparaît plus bas sur le même onglet.

  1. Étape 1. Saisissez votre URL

    Remplissez Webhook URL, une adresse sur votre serveur qui répond avec un statut 2xx en moins de 10 secondes. Préférez https : en http simple, le texte des SMS et les codes circulent sans chiffrement.

    Saisissez votre URL. Remplissez Webhook URL, une adresse sur votre serveur qui répond avec un statut 2xx en moins de 10 secondes. Préférez https : en http simple, le texte des SMS et les codes circulent sans chiffrement.
  2. Étape 2. Choisissez les événements

    Sélectionnez parmi New SMS received, Number is online after wake-up, Rent renewed, Rent not renewed: not enough balance et Rent ended.

  3. Étape 3. Créez et testez

    Cliquez sur Create webhook, vérifiez que Send events est activé, puis cliquez sur Send test event. Le résultat et les dernières livraisons sont listés sur la page.

Chaque requête est signée avec votre Signing secret : vérifiez donc la signature de votre côté. Les livraisons échouées sont retentées pendant plusieurs heures.

Questions sur le sujet

Dans Profile, sur l'onglet API. Après la génération du jeton, il n'est affiché qu'une fois. Si vous l'avez perdu, cliquez sur Regenerate token.

Non. Vous pouvez interroger l'API à la place. Les webhooks vous évitent simplement d'interroger l'API.

Si votre serveur ne répond pas de façon répétée, les livraisons sont désactivées. Corrigez le point de terminaison, activez Send events et enregistrez.

Non. Elle lit les messages et gère les numéros. L'envoi n'est pas proposé.

À lire aussi

Vous n'avez pas trouvé la réponse ?

Écrivez au support sur Telegram. Envoyez le numéro et une capture de ce que vous voyez, cela accélère les choses.

Actualités Assistance