Comment envoyer des SMS depuis votre logiciel ?
Votre agenda en ligne, votre site ou votre outil interne envoie lui-même les rappels et confirmations par SMS, sans que personne ne passe par One. Il suffit d'une clé à donner à votre développeur.
Réservé aux administrateurs
Cette page est réservée au propriétaire et aux administrateurs du compte, ainsi qu'aux membres de niveau Admin dans SMS.
Créer une clé
Ouvrez « Intégrations »
Dans SMS › Paramètres, bloc Intégrations.
Cliquez sur « Créer une clé »
Le bouton est en haut du bloc Clés API, qui liste aussi vos clés existantes.
Clés API
Gérez vos clés API pour l'envoi de SMS programmatique.
Nommez la clé, puis cliquez sur « Créer »
Choisissez un Nom de la clé qui dit quel logiciel l'utilise, par exemple « Site web ».
Copiez la clé tout de suite
La fenêtre Clé API créée affiche la clé complète. Cliquez sur Copier et collez-la dans votre logiciel, ou transmettez-la à votre développeur.
Copiez cette clé maintenant. Elle ne sera plus visible après fermeture.
La clé complète ne s'affiche qu'une fois
Une fois la fenêtre fermée, One n'en montre plus que le début. Si elle est perdue, supprimez-la et créez-en une nouvelle. Une clé permet d'envoyer des SMS au nom de votre entreprise : traitez-la comme un mot de passe.
Ce que votre développeur trouve sur la page
Sous les clés, le bloc Documentation API donne l'Endpoint à appeler (avec un bouton pour le copier), les Paramètres, des Exemples de code en cURL, JavaScript, PHP et Python, et un exemple de Réponse. La clé se transmet dans l'en-tête X-API-Key de la requête.
| Paramètre | Requis | Contenu |
|---|---|---|
to | Oui | Le numéro du destinataire au format international, ou une liste de numéros. |
message | Oui | Le texte du SMS. |
from | Non | Le nom d'expéditeur. S'il manque, c'est l'expéditeur par défaut des paramètres qui s'applique. |
Bon à savoir
- Couper l'accès un moment : basculez l'interrupteur de la clé. Elle passe en Inactif et le logiciel ne peut plus envoyer de SMS, jusqu'à ce que vous la réactiviez.
- Supprimer une clé : cliquez sur l'icône corbeille, puis sur Supprimer dans Supprimer la clé API. C'est définitif : préférez l'interrupteur si vous comptez la réutiliser.
- Chaque clé affiche son statut, le début de la clé, sa date de création (Créée le) et sa Dernière utilisation.
- Les SMS envoyés par API apparaissent dans l'historique, comme ceux envoyés depuis One.
- Clé API SMS ou jeton de l'API One ? Ce n'est pas la même chose. La clé SMS ne sert qu'à l'envoi de SMS décrit ici. Les jetons de l'API One, créés dans les paramètres du compte, donnent accès aux autres modules.