Parcours d’intégration SMS
1. Réussir le premier parcours
Section intitulée « 1. Réussir le premier parcours »Lisez la vue d’ensemble SMS pour choisir l’opération adaptée. Suivez ensuite le premier SMS : obtenir une clé, soumettre un message, conserver son identifiant et consulter son statut.
Votre application reste responsable du choix des destinataires et de la gestion de leur consentement. Une création de contact ne remplace pas ce consentement.
2. Préparer le contenu et les crédits
Section intitulée « 2. Préparer le contenu et les crédits »Vérifiez le nom d’expéditeur avant la soumission. Comprenez le calcul des segments, puis consultez les crédits et contacts pour les opérations utiles à votre intégration.
3. Choisir le mode d’envoi
Section intitulée « 3. Choisir le mode d’envoi »Défilement horizontal si nécessaire. Au clavier : Tab, puis les flèches gauche et droite.
| Besoin | Guide | Permission de création |
|---|---|---|
| Un destinataire maintenant | Envoi immédiat | sms.send |
| Un destinataire à une date future | Programmation | sms.schedule |
| Plusieurs destinataires, même texte et date future | Lots | sms.schedule |
4. Enregistrer et suivre chaque opération
Section intitulée « 4. Enregistrer et suivre chaque opération »Enregistrez la clé d’idempotence avant l’appel réseau et les identifiants publics dès que vous recevez la réponse. Utilisez delivery.read pour consulter les résultats. Une acceptation du fournisseur n’est pas une livraison.
Combinez les statuts, l’idempotence et les reprises et les erreurs pour distinguer refus certain, traitement en cours et résultat inconnu.
Les recettes d’intégration montrent comment relier ces étapes dans votre application.
5. Vérifier avant la mise en service
Section intitulée « 5. Vérifier avant la mise en service »- Vérifiez l’organisation, l’activation et les permissions de la clé.
- Préservez le corps initial et la clé d’idempotence pendant les reprises.
- Traitez les crédits insuffisants même après une lecture de solde favorable.
- Gérez la pagination des lots et la possibilité que les statuts évoluent.
- Ne renvoyez pas un SMS pour corriger ou vérifier son accusé de livraison.
- Préparez vos journaux sans secrets et la procédure de support.
La référence API décrit les opérations et schémas exacts. Le contrat ne comprend aucun webhook client ni endpoint OTP spécialisé.