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.
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
É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.
É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.
É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.
É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.
É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.
É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é.