API SMS
L'API Programmable SMS de Twilio vous aide à ajouter à vos applications des fonctionnalités développées de messagerie.
À l'aide de cette API REST, vous pouvez envoyer et recevoir des SMS, suivre l'état de livraison des messages envoyés, programmer l'envoi ultérieur de SMS ainsi que récupérer et modifier l'historique des messages.
Vous souhaitez obtenir des informations plus générales sur Twilio et les SMS ? Consultez notre présentation de Programmable SMS et la page de tarification des API SMS.
URL de base
Toutes les URL référencées dans la documentation de l'API ont la base suivante :
https://api.twilio.com/2010-04-01
L'API est desservie via HTTPS. Pour garantir la confidentialité des données, les HTTP non cryptés ne sont pas pris en charge.
Vous pouvez contrôler votre connectivité dans la plateforme de Twilio en incluant votre emplacement edge spécifique dans le sous‐domaine. Cela vous permettra d'améliorer les performances de vos applications en les rapprochant de la connectivité réseau public ou privé de Twilio.
Par exemple, les clients disposant d'une infrastructure en Allemagne peuvent utiliser l'emplacement edge frankfurt en utilisant l'URL de base suivante :
https://api.frankfurt.us1.twilio.com/2010-04-01Si vous disposez d'une connexion privée via Interconnect en Allemagne, vous pouvez utiliser l'emplacement edge frankfurt‐ix à l'aide de l'URL de base suivante :
https://api.frankfurt-ix.us1.twilio.com/2010-04-01Authentification API SMS
Les requêtes HTTP vers l'API sont protégées par l'authentification HTTP de base. Pour en savoir plus sur la façon dont Twilio gère l'authentification, consultez notre documentation sur la sécurité.
En bref, vous utiliserez votre Account SID (SID de compte) Twilio comme nom d'utilisateur et votre Auth Token (jeton d'authentification) comme mot de passe pour l'authentification HTTP de base avec Twilio.
curl -G https://api.twilio.com/2010-04-01/Accounts \
-u <YOUR_ACCOUNT_SID>:<YOUR_AUTH_TOKEN>
Vous pouvez trouver votre Account SID (SID de compte) et votre Auth Token (jeton d'authentification) dans la Console.
Pour en savoir plus sur l'authentification et l'interaction avec l'API REST de Twilio, consultez notre documentation afin de voir les demandes adressées à l'API ainsi que la réponse de Twilio.
Envoyer des messages avec l'API SMS
Twilio surveille désormais les messages pour empêcher que du contenu n'enfreigne notre politique d'utilisation acceptable (AUP). Cela permet de prendre en charge Twilio Messaging en tant que canal d'engagement puissant et fiable et ne ralentira pas la remise des messages.
Si un message que vous envoyez enfreint l'AUP, il est retourné et vous recevez un code d'erreur qui identifie les modifications que vous devez effectuer avant de l'envoyer de nouveau.
L'API SMS de Twilio vous aide à envoyer et à gérer des messages de manière programmée :
- Pour envoyer un SMS, un message sur WhatsApp ou Channels avec l'API, appliquez la méthode HTTP POST afin de l'envoyer à la ressource de messages.
- Vous pouvez également utiliser la ressource de messages pour récupérer et répertorier des messages associés à votre compte.
Il est aussi possible d'utiliser l'API REST pour interroger les métadonnées et gérer vos messages:
- Supprimez ou rédigez du contenu à partir d'un message existant.
- Suivez les feedbacks de messages.
- Récupérez, mettez à jour ou supprimez des contenus médias associés à un message.
- Récupérez et mettez à jour les numéros courts associés à votre compte.
- Gérez les services de messagerie de votre compte.
Vous trouverez toutes les ressources pertinentes de l'API SMS dans le dossier Référence d'API de la barre de navigation située à gauche de la page.
Utiliser les bibliothèques d'aide pour envoyer et recevoir des messages
Envoyez et recevez des messages directement à partir de votre application Web avec l'API SMS. Pour obtenir des instructions détaillées sur la façon de procéder avec l'une de nos bibliothèques d'aide prises en charge, consultez les guides de démarrage rapide SMS pour:
Vous n'utilisez pas l'une des bibliothèques d'aide prises en charge? Consultez ces articles supplémentaires pour apprendre à envoyer un SMS avec:
Le langage que vous souhaitez utiliser n'est pas disponible? Si vous suivez les conventions de nos codes applicables curl tout au long de la documentation, vous pouvez traduire l'appel API dans le langage de programmation de votre choix.
Applications avancées basées sur l'API SMS de Twilio
- Découvrez comment suivre l'état de livraison des messages envoyés avec l'API de Twilio.
- Envoyez un SMS pendant un appel téléphonique avec Python et Flask.
- Créez des rappels de rendez‐vous par SMS.
- Envoyez des notifications ETA pour tenir vos utilisateurs à jour.
- Parcourez tous les tutoriels SMS.
Aide à l'intégration de l'API SMS
L'API SMS de Twilio est un bloc de construction flexible qui peut vous permettre d'envoyer votre premier message texte, mais aussi d'en envoyer et en recevoir des millions.
Bien que nous espérons que cette page soit une synthèse satisfaisante de ce que vous pouvez faire avec l'API, ce n'est qu'un aperçu. Pour obtenir de l'aide sur l'analyse des problèmes de l'API, consultez nos Conseils d'analyse des problèmes SMS et apprenez à utiliser les outils de débogage de Twilio.
Si vous avez besoin d'aide pour intégrer l'API SMS ou si vous souhaitez discuter des meilleures pratiques, contactez‐nous. Vous pouvez nous faire part de vos commentaires sur cette page à l'aide de l'enquête, en échangeant avec l'équipe d'assistance ou avec l'équipe commerciale, ou encore en nous contactant sur Twitter.
Nous avons hâte de vous voir à l'œuvre!
Besoin d'aide ?
Ça arrive à tout le monde, il est parfois difficile de coder. Obtenez de l'aide dès maintenant auprès de notre équipe d'assistance, ou appuyez‑vous sur la sagesse collective en visitant le collectif Stack Overflow Twilio ou en parcourant le tag Twilio sur Stack Overflow.
