You are viewing the French site, but your language preference is set to English. Switch to English site →

Menu

Expand
Évaluez cette page :

Ressource de message

Une ressource de message représente un message entrant ou sortant. Twilio crée un message lorsque l'un des cas suivants se produit :

Avec cette API REST, vous pouvez :

Vous recherchez des instructions pas à pas pour envoyer votre premier SMS avec Twilio à l'aide des librairies d'aide ? Découvrez l'un de nos guides de démarrage rapide SMS dans le langage de programmation de votre choix : C#/.NET, Java, Node.js, PHP, Python ou Ruby.

Ou, si vous cherchez à être opérationnel avec le guide de démarrage rapide de l'API Twilio pour WhatsApp : C#/.NET, Java, Node.js, PHP, Python ou Ruby.

Propriétés du message

Resource Properties in REST API format
body

Texte du message. Peut comporter jusqu'à 1 600 caractères.

num_segments
string Not PII

Nombre de segments qui composent le message complet. Un corps de message trop volumineux pour être envoyé dans un seul message SMS est segmenté et facturé comme plusieurs messages. Les messages entrants de plus de 160 caractères sont réassemblés à la réception du message. Remarques : Lorsque vous utilisez un service de messagerie pour envoyer des messages, num_segments sera toujours 0 dans la réponse de Twilio à votre requête d'API.

direction
enum:direction Not PII

Sens du message. Ce peut être : inbound (entrant) pour les messages entrants, outbound-api pour les messages initiés par une API REST, outbound-call pour les messages lancés pendant un appel, ou outbound-reply pour les messages lancés en réponse à un message entrant.

from
phone_number PII MTL: 120 DAYS

Numéro de téléphone (au format E.164), ID d'expéditeur alphanumérique ou Carte SIM Wireless à l'origine du message. Pour les messages entrants, il s'agit du numéro du téléphone expéditeur. Pour les messages sortants, cette valeur correspond à l'un de vos numéros de téléphone Twilio ou à l'identifiant alphanumérique de l'expéditeur utilisé.

to

Numéro de téléphone au format E.164 ayant reçu le message. Pour les messages entrants, il s'agit de l'un de vos numéros de téléphone Twilio. Pour les messages sortants, il s'agit du téléphone de l'expéditeur.

date_updated
date_time<rfc2822> Not PII

Date et heure de la dernière mise à jour de la ressource, en GMT, spécifiées au format RFC 2822.

price
string Not PII

Montant facturé pour le message, dans la devise spécifiée par price_unit. Notez que votre compte est facturé pour chaque segment que nous envoyons au téléphone. Rempli après l'envoi du message. Peut ne pas être disponible immédiatement.

error_message
string Not PII

Description de error_code si votre message status (statut) est failed (échec) ou undelivered (non livré). Si le message a réussi, cette valeur est nulle.

uri
string Not PII

URI de la ressource relatif à https://api.twilio.com.

account_sid
sid<AC> Not PII

SID du Compte qui a envoyé le message ayant créé la ressource.

num_media
string Not PII

Nombre de fichiers multimédias associés au message. Un message peut envoyer jusqu'à 10 fichiers multimédias.

status
enum:status Not PII

The status of the message. Can be: accepted, scheduled, canceled, queued, sending, sent, failed, delivered, undelivered, receiving, received, or read (WhatsApp only). For more information, See detailed descriptions.

messaging_service_sid
sid<MG> Not PII

SID du Service de messagerie utilisé avec le message. La valeur est nulle si aucun service de messagerie n'a été utilisé.

sid
sid<MM> Not PII

Chaîne unique créée pour identifier la ressource de message.

date_sent
date_time<rfc2822> Not PII

Date et heure auxquelles la ressource a été envoyée, en GMT, spécifiées au format RFC 2822. Pour les messages sortants, moment où le message est envoyé. Pour les messages entrants, moment où la requête HTTP est envoyée à votre application.

date_created
date_time<rfc2822> Not PII

Date et heure de création de la ressource, en GMT, spécifiées au format RFC 2822.

error_code
integer? Not PII

Le code d'erreur est renvoyé si votre message status (statut) est failed (échec) ou undelivered (non livré). L'error_code fournit plus d'informations sur l'échec. Si le message a réussi, cette valeur est nulle.

price_unit
currency Not PII

Monnaie dans laquelle le prix est mesuré, au format ISO 4127 (par exemple usd, eur, jpy).

api_version
string Not PII

Version de l'API utilisée pour traiter le message.

subresource_uris
uri_map Not PII

Liste des ressources connexes identifiées par leurs URI relatifs à https://api.twilio.com

Créer une ressource de message

post
https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/Messages.json

Pour envoyer un nouveau message sortant, effectuez un HTTP POST vers l'URI de ressource de cette liste de messages.

Si vous envoyez des messages en mode d'essai, vous devez d'abord vérifier votre numéro de téléphone « To » (À) avec Twilio. 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.

Lors de la création d'un nouveau message via l'API, vous devez inclure le paramètre To (À). Cette valeur doit être un numéro de téléphone de destination ou une adresse de canal. Vous devez également transmettre les éléments Body (corps) et MediaUrl (URL multimédias) avec le contenu du message.

Un message multimédia WhatsApp ne peut contenir qu'un seul objet multimédia. Les paramètres supplémentaires MediaURL seront ignorés.

Vous devez également inclure soit le paramètre From soit le paramètre MessagingServiceSid. Vous pouvez utiliser MessagingServiceSid si vous envoyez votre message avec un service de messagerie. Vous pouvez également choisir un numéro spécifique dans un service de messagerie à définir dans le champ From (De).

Il y a une légère différence dans la façon dont l'API de Twilio répond en fonction du paramètre que vous incluez :

  • From : Twilio valide les numéros de téléphone ou les adresses de canal de manière synchrone. L'API renvoie un statut queued ou une erreur.
  • MessagingServiceSid : L'API renvoie d'abord le statut accepted. Twilio détermine ensuite le numéro de téléphone optimal pour le champ From . Toutes les erreurs de livraison sont envoyées de manière asynchrone à votre URL StatusCallback.

Si le corps de votre message contient plus de 160 caractères GSM‐7 (ou 70 caractères UCS‐2), Twilio envoie le message sous forme de SMS segmenté et débite votre compte en conséquence.

Parameters
Parameters in REST API format
account_sid
Path
post sid<AC> Not PII

SID du Compte qui va créer la ressource.

to
Required
post phone_number PII MTL: 120 DAYS

Numéro de téléphone de destination au format E.164 pour les SMS/MMS ou Adresse utilisateur du canal pour les autres canaux tiers.

status_callback
Optional
post url Not PII

URL à appeler en utilisant la méthode status_callback_method pour envoyer des informations de statut à votre application. Le cas échéant, nous effectuons un POST de ces changements de statut de message à l'URL: queued (mis en file d'attente), failed (échec), sent (envoyé), delivered (livré), ou undelivered (non livré). Twilio effectue un POST de ses paramètres de requête standard et de certains paramètres supplémentaires, dont MessageSid, MessageStatus et ErrorCode. Si vous incluez ce paramètre avec le messaging_service_sid, nous utilisons cette URL au lieu de l'URL de rappel de statut de Services de messagerie. Les URL doivent contenir un nom d'hôte valide et les underscores ne sont pas autorisés.

application_sid
Optional
post sid<AP> Not PII

SID de l'application qui doit recevoir le statut du message. Nous effectuons un POST du paramètre message_sid et du paramètre message_status, avec une valeur de sent ou failed dans message_status_callback de application. Si un paramètre status_callback est également transmis, il sera ignoré et le paramètre message_status_callback de l'application sera utilisé.

max_price
Optional
post decimal Not PII

Prix total maximum en dollars US à payer pour le message à livrer. Il peut s'agir d'une valeur décimale pouvant comporter jusqu'à 4 décimales. Tous les messages sont mis en file d'attente avant d'être livrés et le coût du message est vérifié avant son envoi. Si le coût dépasse max_price, le message échoue et un statut failed est envoyé au rappel de statut. Si MaxPrice n'est pas défini, le coût du message n'est pas vérifié.

provide_feedback
Optional
post boolean Not PII

Indique s'il faut confirmer la livraison du message. Définissez cette valeur sur true (vrai) si vous envoyez des messages qui ont une action utilisateur traçable et que vous avez l'intention de confirmer la livraison du message à l'aide de l'API de feedback de message. Ce paramètre est false (faux) par défaut.

attempt
Optional
post integer Not PII

Nombre total de tentatives faites (y compris celle‐ci) pour envoyer le message, quel que soit le fournisseur utilisé

validity_period
Optional
post integer Not PII

Durée en secondes pendant laquelle le message peut rester dans notre file d'attente de messages sortants. Une fois cette période écoulée, le message échoue et nous appelons votre rappel de statut. Peut être compris entre 1 et la valeur par défaut de 14 400 secondes. Toutefois, une fois qu'un message a été accepté par un opérateur, nous ne pouvons pas garantir qu'il ne sera pas mis en file d'attente après cette période. Nous recommandons que cette valeur soit d'au moins 5 secondes.

force_delivery
Optional
post boolean Not PII

Réservé

content_retention
Optional
post enum:content_retention Not PII

Détermine si le contenu du message peut être stocké ou modifié en fonction des paramètres de confidentialité

address_retention
Optional
post enum:address_retention Not PII

Détermine si l'adresse peut être stockée ou masquée en fonction des paramètres de confidentialité

smart_encoded
Optional
post boolean Not PII

Indique s'il faut détecter les caractères Unicode ayant un caractère GSM‐7 similaire et les remplacer. Ce peut être : true (vrai) ou false (faux).

persistent_action
Optional
post string[] Not PII

Actions riches pour les messages de canaux.

shorten_urls
Optional
post boolean Not PII

Détermine l'utilisation du suivi des clics. Une définition sur true indique à Twilio de remplacer tous les liens dans le message par une version abrégée basée sur l'ID de domaine associé, puis d'effectuer le suivi des clics. Si ce paramètre n'est pas défini sur un appel d'API, nous utiliserons la valeur définie sur le service de messagerie. Si ce paramètre n'est pas défini et que la valeur n'est pas configurée sur le service de messagerie utilisé, la valeur par défaut sera false.

schedule_type
Optional
post ienum:schedule_type Not PII

Indique votre intention de programmer un message. Transmettez la valeur fixed pour programmer un message à une heure fixe.

send_at
Optional
post date_time<iso8601> Not PII

Heure à laquelle Twilio enverra le message. Doit être au format ISO 8601.

send_as_mms
Optional
post boolean Not PII

If set to True, Twilio will deliver the message as a single MMS message, regardless of the presence of media.

content_sid
Optional
post sid<HX> Not PII

The SID of the Content object returned at Content API content create time (https://www.twilio.com/docs/content-api/create-and-send-your-first-content-api-template#create-a-template). If this parameter is not specified, then the Content API will not be utilized.

content_variables
Optional
post string Not PII

Key-value pairs of variable names to substitution values, used alongside a content_sid. If not specified, Content API will default to the default variables defined at create time.

from
Required if messaging_service_sid is not passed
post phone_number PII MTL: 120 DAYS

Numéro de téléphone Twilio au format E.164, ID d'expéditeur alphanumérique ou Adresse d'endpoint de canal activés pour le type de message à envoyer. Les numéros de téléphone ou les numéros courts achetés auprès de Twilio fonctionnent également ici. Il est notamment impossible d'usurper des messages à partir d'un numéro de téléphone cellulaire privé. Si vous utilisez messaging_service_sid, ce paramètre doit être vide.

messaging_service_sid
Required if from is not passed
post sid<MG> Not PII

SID du Service de messagerie à associer au message. Définissez ce paramètre pour utiliser les Paramètres du service de messagerie et fonctions CoPilot que vous avez configurés et laissez le paramètre From vide. Lorsque seul ce paramètre est défini, Twilio utilise les fonctions CoPilot activées pour sélectionner le numéro de téléphone From pour la livraison.

body
Required if media_url is not passed
post string PII MTL: 30 DAYS

Texte du message à envoyer. Peut contenir jusqu'à 1 600 caractères.

media_url
Required if body is not passed
post url[] PII MTL: 30 DAYS

URL du média à envoyer avec le message. Le média peut être de type gif, png et jpeg et sera formaté correctement sur l'appareil du destinataire. La taille limite du support est de 5 MB pour les types de fichiers pris en charge (JPEG, PNG, GIF) et de 500 KB pour les autres types de médias acceptés. Pour envoyer plusieurs images dans le corps du message, fournissez plusieurs paramètres media_url dans la requête POST. Vous pouvez inclure jusqu'à 10 paramètres media_url par message. Vous pouvez envoyer des images par SMS uniquement aux États‐Unis et au Canada.

Example 1
        
        
        

        Créer un message

        Example 2
              
              
              
              Utiliser le préfixe « whatsapp : » pour envoyer un message WhatsApp

              Créer un message WhatsApp

              Utiliser le préfixe « whatsapp : » pour envoyer un message WhatsApp
              Example 3
                    
                    
                    

                    Créer un message et spécifier une URL StatusCallback

                    Remarque sur la limitation du débit des messages

                    Au fur et à mesure que vous envoyez des messages par l'intermédiaire de l'API, Twilio les met en file d'attente pour qu'ils soient livrés à la limite de débit prescrit. 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 en fonction de la capacité disponible.

                    Si votre application tente de mettre en file d'attente plus de 4 heures de trafic sortant (par exemple, mettre en file d'attente plus de 14 400 messages vers le Canada sur un numéro de téléphone long), l'API commence à renvoyer des erreurs 429.

                    Si vous devez mettre en file d'attente un grand nombre de messages, vous pouvez utiliser les Services de messagerie de Twilio. Consultez notre guide sur la configuration et l'envoi de messages à partir d'un service de messagerie dans la langue de votre choix pour plus de conseils.

                    Programmer une ressource de message

                    Remarques : La programmation des messages est actuellement disponible en version bêta publique.

                    La fonctionnalité de programmation de messages vous permet de programmer un SMS, un MMS ou un message WhatsApp à une heure fixe.

                    POST https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/Messages.json

                    Pour programmer un nouveau message sortant, effectuez un HTTP POST vers l'URI de ressources de la liste de messages indiquée ci‐dessus avec les deux paramètres requis suivants :

                    • ScheduleType : Ce paramètre indique votre intention de programmer un message. Vous devez transmettre la valeur « fixed » pour programmer l'envoi d'un message à une heure fixe.
                    • SendAt : Ce paramètre indique quand Twilio enverra un message. Votre date/heure doit être au format ISO‐8601.

                    En plus des deux paramètres de programmation, vous devez encore inclure les paramètres habituels pour envoyer un message, comme décrit dans la section Créer une ressource de message : To, Body, (MediaUrl (en cas d'envoi d'un MMS) et MessageServiceSid (vous pouvez transmettre le MessagingServiceSid dans le paramètre MessagingServiceSid ou le paramètre From).

                    Remarques importantes concernant la version bêta de la programmation des messages

                    Pour obtenir la liste complète des limitations bêta liées à la programmation des messages, consultez l'article d'assistance FAQ sur la programmation des messages. Si l'une de ces limitations vous bloque, veuillez nous contacter via support@twilio.com :

                    Veuillez noter que la programmation des messages sera soumise aux limitations suivantes au lancement :

                    • La programmation des messages ne sera accessible que sur les services de messagerie. Vous devez transmettre un MessageServiceSid au lieu d'un numéro de téléphone From pour programmer des messages. Si vous transmettez un numéro de téléphone From, les paramètres de programmation sont supprimés de la requête d'API et le message est envoyé immédiatement.
                    • Un message doit être programmé au moins 60 minutes avant son heure d'envoi et ne peut pas être programmé plus de 7 jours avant la requête.
                    • Si vous envisagez d'utiliser la programmation des messages à grande échelle, veuillez consulter l'ensemble des limitations de la version bêta dans l'article d'assistance.
                    Example 4
                          
                          
                          

                          Programmer un message

                          Remarque : Il n'y a pas d'événement de rappel de statut pour le statut scheduled. Vous pouvez continuer à recevoir des événements de rappel existants en incluant le paramètre facultatif StatusCallBack dans la requête de message.

                          Codes de statut de réponse

                          Paramètres valides : Un HTTP 201 (programmé) est renvoyé dans la réponse API synchrone lorsque vos paramètres de requête sont valides. Lorsqu'un message est programmé, vous voyez scheduled à la place de accepted.

                          Paramètres non valides : Un code HTTP 400 est renvoyé dans la réponse de l'API lorsque vos paramètres de requête ne sont pas valides.

                          Example 5
                                
                                
                                

                                Programmer un message avec une URL d'image

                                Example 6
                                      
                                      
                                      

                                      Programmer un message WhatsApp

                                      Remarque : Assurez‐vous que votre expéditeur WhatsApp approuvé est ajouté au pool de numéros de votre service de messagerie à utiliser pour programmer un message WhatsApp.

                                      WhatsApp exige que les notifications initiées par l'entreprise envoyées par votre application soient modélisées et préenregistrées, à l'exception des messages envoyés en réponse à un message initié par l'utilisateur. (Pour plus d'informations, reportez‐vous à la section‌Messagerie conversationnelle (‌Conversational Messaging) sur WhatsApp).Messagerie conversationnelle sur WhatsApp).

                                      Lors de la programmation d'un message WhatsApp, la vérification des modèles pré‐enregistrés ne sera effectuée qu'au moment de l'envoi du message et non au moment de sa programmation. Si votre message ne respecte pas les modèles WhatsApp pré‐approuvés de votre compte, il est programmé, mais échoue au moment de l'envoi.

                                      Annulation des messages programmés

                                      Une fois qu'un message est programmé, vous pouvez l'annuler. Reportez‐vous à la section Annuler un message programmé pour savoir comment annuler des messages programmés.

                                      Extraire une ressource de message

                                      get
                                      https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/Messages/{Sid}.json

                                      Renvoie un seul message spécifié par le message {SID} fourni.

                                      Parameters
                                      Parameters in REST API format
                                      account_sid
                                      Path
                                      get sid<AC> Not PII

                                      SID du Compte qui a créé la ressource de message à extraire.

                                      sid
                                      Path
                                      get sid<MM> Not PII

                                      Chaîne fournie par Twilio qui identifie de manière unique la ressource de message à extraire.

                                      Example 1
                                            
                                            
                                            

                                            Fetch Message

                                            Lire plusieurs ressources de messages

                                            get
                                            https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/Messages.json

                                            Renvoie la liste des messages associés à votre compte. Si vous utilisez l'API REST de Twilio ou l'interface de ligne de commande de Twilio, la liste inclut les informations de pagination. Si vous utilisez l'une des librairies d'aide côté serveur de Twilio, la pagination s'effectue en arrière‐plan.

                                            Lorsque vous obtenez la liste de tous les messages, les résultats sont triés dans le champ DateSent, les messages les plus récents apparaissant en premier.

                                            Si vous utilisez l'API REST de Twilio et que vous prévoyez de demander plus d'enregistrements qu'il ne peut s'afficher sur une seule page, vous pouvez utiliser le nextpageuri fourni. Cette méthode vous assure que votre prochaine requête reprend là où elle s'est arrêtée et peut vous éviter de récupérer des données en double si vous êtes en train d'envoyer ou de recevoir des messages.

                                            Cela n'est pas nécessaire si vous utilisez une librairie d'aide Twilio, qui gère automatiquement la pagination. Pour plus d'informations, consultez la documentation de la librairie d'aide.

                                            Vous pouvez également filtrer la liste en fournissant les paramètres de chaîne de requête suivants à la ressource de liste :

                                            Parameters
                                            Parameters in REST API format
                                            account_sid
                                            Path
                                            get sid<AC> Not PII

                                            SID du Compte qui a créé les ressources de messages à lire.

                                            to
                                            Optional
                                            get phone_number PII MTL: 120 DAYS

                                            Lire les messages envoyés uniquement à ce numéro de téléphone.

                                            from
                                            Optional
                                            get phone_number PII MTL: 120 DAYS

                                            Lire les messages envoyés uniquement à partir de ce numéro de téléphone ou de l'ID d'expéditeur alphanumérique.

                                            date_sent
                                            Optional
                                            get date_time_inequality<iso8601> Not PII

                                            Date des messages à afficher. Spécifiez une date au format AAAA-MM-JJ, en GMT, pour lire uniquement les messages envoyés à cette date. Par exemple : 2009-07-06. Vous pouvez également spécifier une inégalité, telle que DateSent<=AAAA-MM-JJ, pour lire les messages envoyés à une date ou avant minuit, et DateSent>=AAAA-MM-JJ pour lire les messages envoyés à une date ou après minuit.

                                            Example 1
                                                  
                                                  
                                                  
                                                  Obtenir tous les messages associés à votre compte

                                                  Lire : Répertorier tous les messages

                                                  Obtenir tous les messages associés à votre compte
                                                  Example 2
                                                        
                                                        
                                                        
                                                        Répertorier tous les messages envoyés le 31 août 2016 de +15017122661 et à +15558675310

                                                        Lire : Répertorier les messages correspondant aux critères de filtre

                                                        Répertorier tous les messages envoyés le 31 août 2016 de +15017122661 et à +15558675310
                                                        Example 3
                                                              
                                                              
                                                              
                                                              Répertorier tous les messages envoyés avant le 1er mars 2019

                                                              Lire : Répertorier les messages (filtrer par date « before sent » [avant l'envoi])

                                                              Répertorier tous les messages envoyés avant le 1er mars 2019
                                                              Example 4
                                                                    
                                                                    
                                                                    
                                                                    Liste de tous les messages envoyés entre le 15 janvier 2021, 01:23:45 UTC et le 17 janvier 2021, 01:23:45 UTC

                                                                    Lire : Afficher les messages (filtrer par période)

                                                                    Liste de tous les messages envoyés entre le 15 janvier 2021, 01:23:45 UTC et le 17 janvier 2021, 01:23:45 UTC

                                                                    Mettre à jour une ressource de message

                                                                    post
                                                                    https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/Messages/{Sid}.json

                                                                    Met à jour le corps d'une ressource de message.

                                                                    Cette action est principalement utilisée pour modifier les messages : pour ce faire, effectuez un POST vers l'URI ci‐dessus et définissez le paramètre Body comme une chaîne vide : « ». Cela vous permettra de modifier efficacement le texte d'un message tout en conservant intactes les autres propriétés des ressources de messages.

                                                                    Parameters
                                                                    Parameters in REST API format
                                                                    account_sid
                                                                    Path
                                                                    post sid<AC> Not PII

                                                                    SID du Compte qui a créé les ressources de messages à mettre à jour.

                                                                    sid
                                                                    Path
                                                                    post sid<MM> Not PII

                                                                    Chaîne fournie par Twilio qui identifie de manière unique la ressource de message à mettre à jour.

                                                                    body
                                                                    Optional
                                                                    post string PII MTL: 30 DAYS

                                                                    Texte du message à envoyer. Peut comporter jusqu'à 1 600 caractères.

                                                                    status
                                                                    Optional
                                                                    post ienum:update_status Not PII

                                                                    En cas de définition sur canceled (annulé), autorise une requête d'annulation de message si un message n'a pas encore été envoyé.

                                                                    Example 1
                                                                          
                                                                          
                                                                          
                                                                          Pour modifier le corps du message d'un enregistrement de message, effectuez un POST vers l'instance avec un corps vide.

                                                                          Mise à jour : modifier un message

                                                                          Pour modifier le corps du message d'un enregistrement de message, effectuez un POST vers l'instance avec un corps vide.

                                                                          Annuler un message programmé

                                                                          Avant d'utiliser cette fonctionnalité :

                                                                          1. Assurez‐vous que la valeur du statut annulé est orthographiée avec un « l », (canceled) et non pas deux (cancelled).
                                                                          2. Assurez‐vous de stocker le MessageSid des messages que vous programmez. Vous devez référencer le MessageSid pour chaque requête d'annulation de message
                                                                          3. Il n'y a pas d'annulation en bloc. Si vous souhaitez annuler plusieurs messages, vous devez envoyer une requête d'annulation pour chaque message et référencer le MessageSid.
                                                                          4. Il existe un nouvel événement de rappel de statut pour « Canceled ». Vous pouvez continuer à recevoir des événements de rappel existants en incluant le paramètre facultatif StatusCallBack dans la requête de message.

                                                                          Remarque : Nous nous efforçons d'annuler un message programmé lorsque nous recevons votre requête. Un message ne peut pas être annulé une fois qu'il a atteint le statut finalisé.

                                                                          Example 2
                                                                                
                                                                                
                                                                                

                                                                                Annuler un message programmé

                                                                                Supprimer une ressource de message

                                                                                delete
                                                                                https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/Messages/{Sid}.json

                                                                                Supprime un enregistrement de message de votre compte. Une fois l'enregistrement supprimé, il n'apparaît plus dans les journaux de l'API et du portail de compte.

                                                                                En cas de succès, renvoie HTTP 204 (aucun contenu) sans corps.

                                                                                Une tentative de suppression d'un enregistrement de message en cours entraîne une erreur.

                                                                                Parameters
                                                                                Parameters in REST API format
                                                                                account_sid
                                                                                Path
                                                                                delete sid<AC> Not PII

                                                                                SID du Compte qui a créé les ressources de messages à supprimer.

                                                                                sid
                                                                                Path
                                                                                delete sid<MM> Not PII

                                                                                Chaîne fournie par Twilio qui identifie de manière unique la ressource de message à supprimer.

                                                                                Remarques : La suppression d'un message supprime également tout média associé au message, sauf si le même objet multimédia est associé à un autre message de votre compte qui n'a pas été supprimé. Par exemple, si vous avez envoyé 1000 messages multimédias avec la même pièce jointe, cet objet multimédia reste accessible jusqu'à ce que les 1000 enregistrements de messages associés soient supprimés.

                                                                                Example 1
                                                                                      
                                                                                      
                                                                                      

                                                                                      Delete Message

                                                                                      Sous‐ressource de messages multimédias

                                                                                      Sous‐ressource de listes multimédias

                                                                                      Les ressources d'instance de message ont une ressource de listes multimédias pour l'ensemble des éléments multimédias inclus à un message donné :

                                                                                      /2010-04-01/Accounts/{AccountSid}/Messages/{MessageSid}/Media

                                                                                      Sous‐ressource d'instance multimédia

                                                                                      Les ressources d'instance de message ont des sous‐ressources d'instance multimédias. Si un média existe dans un message donné, vous pouvez récupérer des informations sur les images et autres médias.

                                                                                      /2010-04-01/Accounts/{AccountSid}/Messages/{MessageSid}/Media/{MediaSid}

                                                                                      Annexe

                                                                                      Valeurs de statut du message

                                                                                      Voici les valeurs possibles pour le paramètre« Status » :

                                                                                      Statut Description
                                                                                      accepted (accepté) Twilio a reçu votre requête d'API d'envoyer un message avec un Services de messagerie et un numéro « From » est sélectionné dynamiquement. Il s'agit du statut initial lors de l'envoi avec un service de messagerie et le paramètre « From ».
                                                                                      scheduled (programmé) Le message est programmé pour être envoyé. Il s'agit du statut initial lors de la programmation d'un message avec un Services de messagerie
                                                                                      queued (mis en file d'attente) La requête d'API d'envoi d'un message a réussi et le message est mis en file d'attente pour être envoyé. Il s'agit du statut initial lorsque vous n'utilisez pas de Services de messagerie
                                                                                      sending (envoi) Twilio est en train d'envoyer votre message à l'opérateur en amont le plus proche du réseau.
                                                                                      sent (envoyé) L'opérateur en amont le plus proche a accepté le message.
                                                                                      Receiving le message entrant a été reçu par Twilio et est en cours de traitement.
                                                                                      Reçu Sur les messages entrants uniquement. Le message entrant a été reçu par l'un de vos numéros Twilio.
                                                                                      delivered (livré) Twilio a reçu la confirmation de la livraison du message de la part de l'opérateur en amont et, le cas échéant, du téléphone du destinataire.
                                                                                      undelivered (non livré) Twilio a reçu un accusé de réception indiquant que le message n'a pas été livré. Cela peut se produire pour plusieurs raisons, y compris le filtrage du contenu de l'opérateur et la disponibilité du téléphone du destinataire.
                                                                                      failed (échec) Le message n'a pas pu être envoyé. Cela peut se produire pour diverses raisons, y compris les dépassements de file d'attente, les suspensions de compte et les erreurs de média (dans le cas de MMS). Twilio ne vous facture pas pour les messages ayant échoué.
                                                                                      read (lu) Sur les messages WhatsApp uniquement. Le message a été remis et ouvert par le destinataire dans la conversation. Le destinataire doit avoir activé les accusés de réception.
                                                                                      canceled (annulé) (fonction bêta) Le message a été annulé. Ce statut n'est accessible que lors de l'utilisation de Services de messagerie

                                                                                      Valeurs de librairie minimales prenant en charge les reçus « READ » pour les messages WhatsApp

                                                                                      • C# : 5.30.0
                                                                                      • Java : 7.39.0
                                                                                      • Node : 3.32.0
                                                                                      • PHP : 5.33.0
                                                                                      • Python : 6.28.0
                                                                                      • Ruby : 5.24.0

                                                                                      Retour à la liste des propriétés du message.

                                                                                      Erreurs liées à la livraison

                                                                                      Lorsque le statut d'un message est failed ou undelivered, les propriétés ErrorCode et ErrorMessage contiennent l'une des options suivantes.

                                                                                      Notez que le message d'erreur est conçu pour être une description lisible par l'utilisateur. Les valeurs renvoyées peuvent être modifiées ultérieurement. Une liste complète des codes d'erreur Twilio et des conseils pour l'analyse des problèmes peuvent vous aider à résoudre les problèmes de livraison.

                                                                                      Code d'erreur Message d'erreur Description
                                                                                      30001 Queue overflow (dépassement de file d'attente) Vous avez essayé d'envoyer trop de messages trop rapidement, et votre file d'attente de messages a dépassé la limite. Essayez d'envoyer à nouveau votre message après avoir attendu un certain temps.
                                                                                      30002 Account suspended (compte suspendu) Votre compte a été suspendu entre l'envoi et la livraison du message. Veuillez contacter Twilio.
                                                                                      30003 Unreachable destination handset (téléphone de destination inaccessible) Le téléphone de destination que vous tentez de joindre est éteint ou indisponible.
                                                                                      30004 Message blocked (message bloqué) Le numéro de destination que vous tentez de joindre ne peut pas recevoir ce message (par exemple, en raison d'une liste noire).
                                                                                      30005 Unknown destination handset (téléphone de destination inconnu) Le numéro de destination que vous tentez de joindre est inconnu et n'existe peut‐être plus.
                                                                                      30006 Landline or unreachable carrier (Ligne fixe ou opérateur non joignable) Le numéro de destination ne peut pas recevoir ce message. Parmi les raisons possibles, on peut citer la tentative de joindre une ligne fixe ou, dans le cas des numéros courts, un opérateur injoignable.
                                                                                      30007 Carrier violation (violation de l'opérateur) Votre message a été signalé comme inacceptable par l'opérateur. Pour protéger leurs abonnés, de nombreux opérateurs ont mis en œuvre le filtrage du contenu ou du spam. En savoir plus sur le filtrage de l'opérateur
                                                                                      30008 Unknown error (erreur inconnue) L'erreur ne correspond à aucune des catégories ci‐dessus.
                                                                                      30009 Missing segment (segment manquant) Un ou plusieurs segments associés à votre message entrant en plusieurs parties n'ont pas été reçus.
                                                                                      30010 Message price exceeds max price (Le prix du message dépasse le prix maximum). Le prix de votre message dépasse le prix du paramètre max price.

                                                                                      Les codes d'erreur suivants ne s'appliquent que lorsque vous envoyez un message via WhatsApp ou Canal.

                                                                                      Code d'erreur Message d'erreur Description
                                                                                      63001 Channel could not authenticate the request (le canal n'a pas pu authentifier la requête) Les informations d'authentification du canal sont incorrectes. Veuillez vérifier les informations d'identification dans la page des canaux dans la console ou vous authentifier à nouveau auprès du canal.
                                                                                      63002 Channel could not find From address (le canal n'a pas pu trouver l'adresse From) L'adresse From ne correspond à aucun canal configuré. Vérifiez que vous utilisez la bonne Adresse de l'endpoint du canal à la page Canal.
                                                                                      63003 Channel could not find To address (le canal n'a pas pu trouver l'adresse To) L'adresse To est incorrecte.
                                                                                      63005 Channel did not accept given content (le canal n'a pas accepté le contenu donné)
                                                                                      63006 Could not format given content for the channel (Impossible de formater le contenu donné pour le canal)
                                                                                      63007 Twilio n'a pas trouvé de canal avec l'adresse de source spécifiée The From address does not map to any configured Channels (l'adresse From de ne correspond à aucun canal configuré). Vérifiez que vous utilisez la bonne Adresse de l'endpoint du canal à la page Canal.
                                                                                      63008 Could not execute the request because the channel module is misconfigured (impossible d'exécuter la requête, car le module de canal est mal configuré) Vérifiez la configuration du canal dans Twilio.
                                                                                      63009 Channel returned an error when executing the request (le canal a renvoyé une erreur lors de l'exécution de la requête) Reportez‐vous au message d'erreur spécifique au canal pour plus d'informations.
                                                                                      63010 Channels ‐ Twilio Internal error (Canaux ‐ Erreur interne de Twilio)
                                                                                      63012 Channel returned an internal error that prevented it from completing the request (Canal a renvoyé une erreur interne qui l'a empêché de remplir la requête)
                                                                                      63013 This message send failed because it violates Channel provider's policy (cet envoi de message a échoué, car il viole la politique du fournisseur de canaux). Veuillez consulter le message d'erreur spécifique à la chaîne pour plus d'informations.
                                                                                      63014 This message failed to be delivered to the user because it was blocked by a user action (ce message n'a pas pu être remis à l'utilisateur, car il a été bloqué par une action de l'utilisateur). Veuillez consulter le message d'erreur spécifique à la chaîne pour plus d'informations.

                                                                                      Retour à la liste des propriétés du message.

                                                                                      Propriété NumSegments

                                                                                      Pour les messages sortants , cette propriété indique le nombre de messages SMS nécessaires pour livrer le corps du message.

                                                                                      Si le corps d'un message comporte plus de 160 caractères GSM‐7 (ou 70 caractères UCS‐2), Twilio segmente et annote vos messages pour tenter de les réassembler correctement sur le téléphone du destinataire (non pris en charge par tous les opérateurs et les téléphones). Ainsi, le corps de votre texte est transmis aussi fidèlement que possible.

                                                                                      Sur les messages entrants, cette propriété indique le nombre de messages SMS qui composent le message reçu.

                                                                                      Si le corps de votre message contient plus de 160 caractères GSM‐7 (ou 70 caractères UCS‐2), Twilio tente de réassembler le message reçu par votre numéro de téléphone Twilio. Tous les opérateurs et téléphones ne prennent pas nécessairement en charge cette fonctionnalité.

                                                                                      Votre compte sera débité pour chaque segment envoyé ou reçu.

                                                                                      Retour à la liste des propriétés du message.

                                                                                      Paramètres de requête StatusCallback

                                                                                      Les paramètres que Twilio transmet à votre application dans sa requête à l'URL StatusCallback comprennent un sous‐ensemble de paramètres de requête standard et ces paramètres supplémentaires :

                                                                                      Paramètre Description
                                                                                      MessageStatus Statut du message. Les informations de remise du message sont indiquées dans le statut du message. Les valeurs possibles sont répertoriées dans la ressource de message.
                                                                                      ErrorCode Code d'erreur (le cas échéant) associé à votre message. Si le statut de votre message est « failed » ou « undelivered », l'ErrorCode peut vous donner plus d'informations sur l'échec. Si le message a été remis avec succès, aucun code d'erreur ne s'affiche. Les valeurs possibles sont répertoriées ici.
                                                                                      ChannelInstallSid SID de canal installé (affiché sur la page de détail du canal) qui a été utilisé pour envoyer ce message. Présent uniquement si le message a été envoyé via un canal.
                                                                                      ChannelStatusMessage Message d'erreur renvoyé par le canal sous‐jacent en cas d'échec de l'envoi du message. Présent uniquement si le message a été envoyé via un canal et que la livraison du message a échoué.
                                                                                      ChannelPrefix Préfixe spécifique au canal qui vous permet d'identifier le canal sur lequel ce message a été envoyé.
                                                                                      EventType Contient des événements post‐livraison. Si le canal prend en charge les accusés de réception, ce paramètre sera inclus avec la valeur « READ » une fois que l'utilisateur aura lu le message. Actuellement pris en charge uniquement pour WhatsApp.

                                                                                      Retour à Créer une ressource de message

                                                                                      Évaluez cette page :

                                                                                      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.

                                                                                            
                                                                                            
                                                                                            

                                                                                            Merci pour vos commentaires!

                                                                                            Veuillez sélectionner la ou les raisons de vos commentaires. Les informations supplémentaires que vous fournissez nous aident à améliorer notre documentation:

                                                                                            Envoi de vos commentaires...
                                                                                            🎉 Merci pour vos commentaires!
                                                                                            Une erreur s'est produite. Veuillez réessayer.

                                                                                            Merci pour vos commentaires !

                                                                                            thanks-feedback-gif