Sending Messages
Grâce à l'API REST de Twilio, vous pouvez envoyer des SMS sortants depuis votre numéro de téléphone Twilio vers des téléphones portables du monde entier.
Dans ce guide, nous allons découvrir comment utiliser l'API Programmable Messaging de Twilio pour :
Vous préférez un guide étape par étape pour envoyer votre premier message ? Découvrez notre démarrage rapide (quickstart) de Programmable SMS en C#, Java, Node.js, PHP, Python ou Ruby.
Vous pouvez également trouver la référence d'API complète pour la ressource de message ici.
Si vous souhaitez envoyer et vérifier des jetons (token) par SMS, consultez nos API de sécurité de compte pour Authy (2FA) et Verify (vérification du téléphone).
Envoyer un SMS avec l'API de Twilio
Pour envoyer un nouveau message sortantà partir d'un numéro de téléphone Twilio vers un numéro externe, effectuez une requête HTTP POST à la ressource de message (message resource) de votre compte :
/2010-04-01/Accounts/{AccountSid}/MessagesVous pouvez publier directement sur l'API avec cURLou utiliser l'une de nos six librairies prises en charge pour envoyer des messages avec C#, Java, Node.js, PHP, Python ou Ruby.
Lors de la création d'un nouveau message via l'API, incluez les paramètres To (À), From (De) et Body (corps).
To
Ce paramètre détermine le numéro de téléphone de destination de votre SMS. Formatez ce numéro avec un « + » et un code pays, par exemple +16175551212 (format E.164).
Si vous envoyez des messages en mode d'essai, vous devez d'abord vérifier votre numéro de téléphone « To » (À) afin que Twilio sache que vous en êtes propriétaire. Si vous tentez d'envoyer un SMS depuis votre compte d'essai vers un numéro non vérifié, l'API renvoie l'erreur 21219.
Vous pouvez vérifier votre numéro de téléphone en l'ajoutant à vos Verified Caller IDs(ID d'appelants vérifiés) dans la console.
From
From(De) spécifie le numéro de téléphone Twilio,le short code, (numéro court) ou le service de messagerie qui envoie ce message. Il doit s'agir d'un numéro de téléphone Twilio que vous possédez, formaté avec un « + » et un code pays, par exemple+16175551212 ( format E.164).
Pour obtenir votre premier numéro de téléphone Twilio,allez dans la consoleet trouvez un numéro qui vous plaît grâce aux fonctionnalités SMS. Si vous souhaitez utiliser un numéro court, vous pouvez également en demander un via la console.
Notez que vous ne pouvez pas simuler de messages à partir de votre numéro de téléphone portable personnel sans avoir fait le portage de votre numéro vers Twilio au préalable. Pour en savoir plus, cliquez ici.
Conseil : envoyer un message à partir d'un service de messagerie
Vous pouvez également saisir un SID de service de messagerie comme valeur de paramètre From (De) lorsque vous envoyez un SMS. Lorsque vous utilisez un SID de service de messagerie, Twilio envoie automatiquement votre message à l'aide de l'un des numéros de téléphone de votre groupe de services.*
Un service de messagerie est similaire à un conteneur pour vos numéros de téléphone, regroupé autour de cas d'utilisation courants, tels que l'intelligence de routage et les fonctionnalités de contenu. Pour plus d'informations, consultez le guide sur Sending SMS Messages from a Messaging Service (Envoyer des messages SMS à partir d'un service de messagerie).
Body (corps)
Le paramètre Body (corps) inclut le texte complet du message que vous souhaitez envoyer, limité à 1 600 caractères.
Twilio vérifie que vous avez inclus un numéro de téléphone Twilio valide dans le paramètre From (De), puis met l'appel en file d'attente ou renvoie une erreur.
Consultez la référence d'API complète pour les messages afin d'obtenir laliste entière des paramètresque vous pouvez inclure dans votre requête. Vous pouvez également trouver les paramètres que vous pouvez attendre de Twilio.
Surveiller le statut de votre message
En incluant une URLStatusCallbackdans votre appel API, vous pouvez indiquer à Twilio où effectuer une requête POST pour les informations de votre message.
Veuillez noter que Twilio fera une requête POST pour votre URL StatusCallback.
Twilio effectuera une requête POST sur cette URL chaque fois que le statut de votre message passe à l'un des statuts suivants :
- queued (file d'attente)
- failed (échec)
- sent (envoyé)
- delivered (remis)
- undelivered (non remis)
Les paramètres envoyés par Twilio à votre URL de rappel incluent un sous-ensemble des paramètres de requête standard et certains paramètres de messagerie uniques. Vous pouvez voir la liste complète dans la référence d'API de la ressource de message.
Vous trouverez ci-dessous un exemple des paramètres de requête envoyés à l'URL StatusCallback pour un message remis :
{
"SmsSid": "SMXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
"SmsStatus": "delivered",
"MessageStatus": "delivered",
"To": "+15558675310",
"MessageSid": "SMXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
"AccountSid": "ACXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX",
"From": "+15017122661",
"ApiVersion": "2010-04-01"
}Inclure des médias dans vos messages
Bien que vous ne puissiez uniquement envoyer des messages texte de presque n'importe où sur la planète, l'envoi de médias est actuellement uniquement disponible aux États-Unis et au Canada.
L'envoi d'un message MMS ressemble beaucoup à l'envoi d'un SMS, mais il inclut un nouveau paramètre, MediaUrl. Ce paramètre spécifie l'URL du média que vous souhaitez inclure dans votre message.
Twilio prend en charge le contenu .gif, .png ou .jpeg et formate l'image sur l'appareil de votre destinataire. Si l'en-tête de type de contenu de votre MediaUrl ne correspond pas au média de cette URL, Twilio rejette la requête.
Lesautres types MIMEsont acceptés par l'API, mais ne seront pas modifiés pour la capacité de l'appareil.
La taille maximale des médias dans les messages est de 5 Mo.
Pour envoyer plusieurs images dans un corps de message, indiquez plusieurs valeurs MediaUrl dans votre requête POST (limité à 10 par message).
Utiliser un ID d'expéditeur alphanumérique
Les ID d'expéditeurs alphanumériques sont utilisés pour la messagerie unidirectionnelle personnalisée. Au lieu d'utiliser un numéro de téléphone Twilio au format E.164 pour la valeur « From », vous pouvez utiliser une chaîne personnalisée comme la marque de votre propre entreprise. Les ID d'expéditeurs alphanumériques peuvent être utilisés sans frais supplémentaires lors de l'envoi d'un SMS aux pays prenant en charge cette fonction.
La prise en charge de l'envoi de messages à partir d'un ID d'expéditeur alphanumérique dépend de votre numéro de téléphone de destination (« To ») et n'est pas disponible partout. Veuillez consulter cet article pour obtenir la liste complète des pays prenant en charge cette fonctionnalité.
Remarque sur la limitation du débit
Si vous envoyez plusieurs messages simultanément à partir d'un seul expéditeur Twilio (numéro ou ID d'expéditeur alphanumérique), Twilio les mettra en file d'attente pour livraison. Vos messages peuvent connaître des limites tarifaires différentes en fonction de l'expéditeur que vous utilisez. Pour les messages provenant d'un numéro long aux États-Unis ou au Canada, la limite est d'un segment de message par seconde (MPS). Si vous envoyez des messages à partir d'un numéro long en dehors des États-Unis ou du Canada, ou d'un ID d'expéditeur alphanumérique, la limite supérieure est de 10 MPS.
Les requêtes d'API pour les messages qui dépassent les débits spécifiés seront mises en file d'attente et exécutées au débit d'envoi de votre expéditeur Twilio.
Si votre application tente de mettre en file d'attente plus de 4 heures de trafic sortant provenant d'un seul expéditeur (par exemple, en mettant en file d'attente plus de 14 400 segments de message vers le Canada sur un numéro de téléphone long), les messages excédentaires échoueront avec l'erreur 30001 Queue Overflow (dépassement de file d'attente).
Si vous avez besoin d'augmenter votre débit de SMS sortants, nous vous recommandons d'utiliser un service de messagerie.
Vous prévoyez d'envoyer un grand nombre de messages à un débit supérieur à un message par seconde ? Envisagez de demander un numéro court.
Les numéros courts ne sont pas soumis aux mêmes limites de débit que les numéros longs et peuvent être une meilleure option pour vous.
Et ensuite ?
- Consultez notre documentation de référence d'API pour Twilio SMS.
- Transformez vos messages en une conversation avec notre guide Créer une conversation SMS pour C#, Java, Node.js, PHP, Python ou Ruby.
- Apprenez à suivre l'état de remise des messages que vous envoyez avec C#, Java, Node.js, PHP, Python ou Ruby.
- Optimisez la capacité de livraison de votre message en envoyant des commentaires à Twilio.
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.
