Premiers pas
Documentation Pulsr
Pulsr est une seule API HTTP pour les SMS, le RCS, les appels vocaux et la vérification de numéros. Tous les canaux partagent la même clé, les mêmes conventions JSON et le même format de webhook.
Par où commencer
Première fois sur Pulsr ? Le démarrage rapide vous mène d’une clé API à un SMS reçu en cinq minutes environ. Choisissez ensuite le canal dont vous avez besoin.
- Démarrage rapideCréez une clé, définissez deux variables d’environnement et envoyez votre premier SMS.
- AuthentificationLe fonctionnement des clés API et comment les garder hors de votre code.
- Envoyer des SMSUn numéro ou des milliers, tout de suite ou à l’heure prévue.
- Envoyer du RCSDes messages de marque avec cartes, carrousels, boutons et repli SMS.
- Appels vocauxPassez des appels, lisez du texte, diffusez de l’audio et suivez chaque état.
- Vérifier des numérosEnvoyez des codes à usage unique et vérifiez-les en deux requêtes.
Fonctionnement de l’API
- REST sur HTTPS. Les requêtes et les réponses sont en JSON. Envoyez
Content-Type: application/jsonavec chaque corps de requête. - Un seul en-tête pour s’authentifier.
Authorization: App <votre-clé-api>, sur chaque requête. Voir Authentification. - Des chemins versionnés. Chaque ressource porte sa version dans son chemin, par exemple
/sms/3/messagesou/calls/1/calls: un produit peut évoluer sans en casser un autre. - Asynchrone par défaut. Un envoi répond dès que le message est accepté. La suite (remis, échoué, lu, décroché) vous parvient par webhook.
- Un seul format de statut. Les messages de tous les canaux renvoient le même objet de statut, décrit dans Erreurs et statuts.
À propos des exemples
Chaque exemple existe en TypeScript et en Python. Choisissez un langage sur n’importe quel bloc de code et toute la documentation suit. Les exemples utilisent un petit utilitaire pulsr() autour de fetch et requests, défini dans le démarrage rapide : vous pouvez les copier dans n’importe quel projet sans installer de SDK.
Où sont vos données
Pulsr est hébergé et opéré à 100 % dans l’Union européenne et conforme au RGPD. Le contenu des messages, les données d’appel et les codes de vérification sont traités et stockés dans l’UE, où que soient vos destinataires.