Ressource de message

Une ressource de message représente un message entrant ou sortant. Twilio crée un message lorsque l'un des cas suivants se produit :

Vous envoyez un message SMS, WhatsAppouCanaux via l'API REST
Vous utilisez le mot <message> dans TwiML
Vous avez émis un message à partir d'une carte SIM programmable Wireless
Quelqu'un envoie un message à l'un de vos numéros Twilio

Avec cette API REST, vous pouvez :

Créer de nouveaux messages
Programmer un nouveau message
Extraire un message spécifique
Lire une liste de messages
Mettre à jour ou modifier le contenu d'un message existant
Supprimer des messages de votre compte

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

Ou, si vous cherchez à être opérationnel avec le guide de dé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`	string PII MTL: 30 DAYS The text content of the message
`num_segments`	string Not PII The number of segments that make up the complete message. SMS message bodies that exceed the character limit are segmented and charged as multiple messages. Note: For messages sent via a Messaging Service, `num_segments` is initially `0`, since a sender hasn't yet been assigned.
`direction`	enum:direction Not PII The direction of the message. Can be: `inbound` for incoming messages, `outbound-api` for messages created by the REST API, `outbound-call` for messages created during a call, or `outbound-reply` for messages created in response to an incoming message.
`from`	phone_number PII MTL: 120 DAYS The sender's phone number (in E.164 format), alphanumeric sender ID, Wireless SIM, short code, or channel address (e.g., `whatsapp:+15554449999`). For incoming messages, this is the number or channel address of the sender. For outgoing messages, this value is a Twilio phone number, alphanumeric sender ID, short code, or channel address from which the message is sent.
`to`	string PII MTL: 120 DAYS The recipient's phone number (in E.164 format) or channel address (e.g. `whatsapp:+15552229999`)
`date_updated`	date_time<rfc2822> Not PII The RFC 2822 timestamp (in GMT) of when the Message resource was last updated
`price`	string Not PII The amount billed for the message in the currency specified by `price_unit`. The `price` is populated after the message has been sent/received, and may not be immediately availalble. View the Pricing page for more details.
`error_message`	string Not PII The description of the `error_code` if the Message `status` is `failed` or `undelivered`. If no error was encountered, the value is `null`.
`uri`	string Not PII The URI of the Message resource, relative to `https://api.twilio.com`.
`account_sid`	sid<AC> Not PII The SID of the Account associated with the Message resource
`num_media`	string Not PII The number of media files associated with the Message resource.
`status`	enum:status Not PII The status of the Message. Possible values: `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 The SID of the Messaging Service associated with the Message resource. A unique default value is assigned if a Messaging Service is not used.
`sid`	sid<MM> Not PII The unique, Twilio-provided string that identifies the Message resource.
`date_sent`	date_time<rfc2822> Not PII The RFC 2822 timestamp (in GMT) of when the Message was sent. For an outgoing message, this is when Twilio sent the message. For an incoming message, this is when Twilio sent the HTTP request to your incoming message webhook URL.
`date_created`	date_time<rfc2822> Not PII The RFC 2822 timestamp (in GMT) of when the Message resource was created
`error_code`	integer? Not PII The error code returned if the Message `status` is `failed` or `undelivered`. If no error was encountered, the value is `null`.
`price_unit`	currency Not PII Monnaie dans laquelle le `prix` est mesuré, au format ISO 4127 (par exemple `usd`, `eur`, `jpy`).
`api_version`	string Not PII The API version used to process the Message
`subresource_uris`	uri_map Not PII Liste des ressources connexes identifiées par leurs URI relatifs à `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 vérifier votre numéro de téléphone « To » (À) avec Twilio. Vous pouvez vérifier votre numéro de téléphone en l'ajoutant à vos Verified Caller Ids‌(ID d'appelants vérifiés) dans la console.

Lors de la création d'un nouveau message via l'API, vous devez inclure le paramètre To (À). Cette valeur doit être un numéro de téléphone de destination ou une adresse de canal. Vous devez également transmettre les éléments Body (corps) et MediaUrl (URL multimédias) avec le contenu du message.

Un message multimédia WhatsApp ne peut contenir qu'un seul objet multimédia. Les paramètres supplémentaires MediaURL seront ignorés.

Vous devez également inclure soit le paramètre From soit le paramètre MessagingServiceSid. Vous pouvez utiliser MessagingServiceSid si vous envoyez votre message avec un service de messagerie. Vous pouvez également choisir un numéro spécifique dans un service de messagerie à définir dans le champ From (De).

Il y a une légère différence dans la façon dont l'API de Twilio répond en fonction du paramètre que vous incluez :

From : Twilio valide les numéros de téléphone ou les adresses de canal de manière synchrone. L'API renvoie un statut queued ou une erreur.
MessagingServiceSid : L'API renvoie d'abord le statut accepted. Twilio détermine ensuite le numéro de téléphone optimal pour le champ From . Toutes les erreurs de livraison sont envoyées de manière asynchrone à votre URL StatusCallback.

Si le corps de votre message contient plus de 160 caractères GSM‐7 (ou 70 caractères UCS‐2), Twilio envoie le message sous forme de SMS segmenté et débite votre compte en conséquence.

Parameters

Parameters in REST API format
`account_sid` Path	post sid<AC> Not PII The SID of the Account creating the Message resource.
`to` Required	post string<helpers_type=phone_number> PII MTL: 120 DAYS The recipient's phone number in E.164 format (for SMS/MMS) or channel address, e.g. `whatsapp:+15552229999`.
`status_callback` Optional	post string<helpers_type=url> Not PII The URL of the endpoint to which Twilio sends Message status callback requests. URL must contain a valid hostname and underscores are not allowed. If you include this parameter with the `messaging_service_sid`, Twilio uses this URL instead of the Status Callback URL of the Messaging Service.
`application_sid` Optional	post sid<AP> Not PII The SID of the associated TwiML Application. Message status callback requests are sent to the TwiML App's `message_status_callback` URL. Note that the `status_callback` parameter of a request takes priority over the `application_sid` parameter; if both are included `application_sid` is ignored.
`max_price` Optional	post currency<helpers_type=decimal> Not PII [DEPRECATED] This parameter will no longer have any effect as of 2024-06-03.
`provide_feedback` Optional	post boolean Not PII Boolean indicating whether or not you intend to provide delivery confirmation feedback to Twilio (used in conjunction with the Message Feedback subresource). Default value is `false`.
`attempt` Optional	post integer Not PII Total number of attempts made (including this request) to send the message regardless of the provider used
`validity_period` Optional	post integer Not PII The maximum length in seconds that the Message can remain in Twilio's outgoing message queue. If a queued Message exceeds the `validity_period`, the Message is not sent. Accepted values are integers from `1` to `14400`. Default value is `14400`. A `validity_period` greater than `5` is recommended. Learn more about the validity period
`force_delivery` Optional	post boolean Not PII Réservé
`content_retention` Optional	post ienum:content_retention Not PII Détermine si le contenu du message peut être stocké ou modifié en fonction des paramètres de confidentialité
`address_retention` Optional	post ienum:address_retention Not PII Détermine si l'adresse peut être stockée ou masquée en fonction des paramètres de confidentialité
`smart_encoded` Optional	post boolean Not PII Indique s'il faut détecter les caractères Unicode ayant un caractère GSM‐7 similaire et les remplacer. Ce peut être : `true` (vrai) ou `false` (faux).
`persistent_action` Optional	post string[] Not PII Rich actions for non-SMS/MMS channels. Used for sending location in WhatsApp messages.
`shorten_urls` Optional	post boolean Not PII For Messaging Services with Link Shortening configured only: A Boolean indicating whether or not Twilio should shorten links in the `body` of the Message. Default value is `false`. If `true`, the `messaging_service_sid` parameter must also be provided.
`schedule_type` Optional	post ienum:schedule_type Not PII For Messaging Services only: Include this parameter with a value of `fixed` in conjuction with the `send_time` parameter in order to schedule a Message.
`send_at` Optional	post date_time<iso8601> Not PII Heure à laquelle Twilio enverra le message. Doit être au format ISO 8601.
`send_as_mms` Optional	post boolean Not PII If set to `true`, Twilio delivers the message as a single MMS message, regardless of the presence of media.
`content_variables` Optional	post string Not PII For Content Editor/API only: Key-value pairs of Template variables and their substitution values. `content_sid` parameter must also be provided. If values are not defined in the `content_variables` parameter, the Template's default placeholder values are used.
`risk_check` Optional	post ienum:risk_check Not PII Include this parameter with a value of `disable` to skip any kind of risk check on the respective message request.
`from` Required if messaging_service_sid is not passed	post string<helpers_type=phone_number> PII MTL: 120 DAYS The sender's Twilio phone number (in E.164 format), alphanumeric sender ID, Wireless SIM, short code, or channel address (e.g., `whatsapp:+15554449999`). The value of the `from` parameter must be a sender that is hosted within Twilio and belongs to the Account creating the Message. If you are using `messaging_service_sid`, this parameter can be empty (Twilio assigns a `from` value from the Messaging Service's Sender Pool) or you can provide a specific sender from your Sender Pool.
`messaging_service_sid` Required if from is not passed	post sid<MG> Not PII The SID of the Messaging Service you want to associate with the Message. When this parameter is provided and the `from` parameter is omitted, Twilio selects the optimal sender from the Messaging Service's Sender Pool. You may also provide a `from` parameter if you want to use a specific Sender from the Sender Pool.
`body` Required if media_url, content_sid is not passed	post string PII MTL: 30 DAYS The text content of the outgoing message. Can be up to 1,600 characters in length. SMS only: If the `body` contains more than 160 GSM-7 characters (or 70 UCS-2 characters), the message is segmented and charged accordingly. For long `body` text, consider using the send_as_mms parameter.
`media_url` Required if body, content_sid is not passed	post url[] PII MTL: 30 DAYS The URL of media to include in the Message content. `jpeg`, `jpg`, `gif`, and `png` file types are fully supported by Twilio and content is formatted for delivery on destination devices. The media size limit is 5 MB for supported file types (`jpeg`, `jpg`, `png`, `gif`) and 500 KB for other types of accepted media. To send more than one image in the message, provide multiple `media_url` parameters in the POST request. You can include up to ten `media_url` parameters per message. International and carrier limits apply.
`content_sid` Required if body, media_url is not passed	post sid<HX> Not PII For Content Editor/API only: The SID of the Content Template to be used with the Message, e.g., `HXXXXXXXXXXXXXXXXXXXXXXXXXXXXX`. If this parameter is not provided, a Content Template is not used. Find the SID in the Console on the Content Editor page. For Content API users, the SID is found in Twilio's response when creating the Template or by fetching your Templates.

Example 1

Loading Code Sample...

Example JSON response

Créer un message

Example 2

Loading Code Sample...

Example JSON response

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

Loading Code Sample...

Example JSON response

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

Remarque sur la limitation du débit des messages

Au fur et à mesure que vous envoyez des messages par l'intermédiaire de l'API, Twilio les met en file d'attente pour qu'ils soient livrés à la limite de débit prescrit. Les requêtes d'API pour les messages qui dépassent les débits spécifiés seront mises en file d'attente et exécutées en fonction de la capacité 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 numéro de téléphone long), l'API commence à 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 à 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 bêta publique.

La fonctionnalité de programmation de messages vous permet de programmer un SMS, un MMS ou un message WhatsApp à 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 indiquée ci‐dessus avec les deux paramètres requis suivants :

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

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

Remarques importantes concernant la version bêta de la programmation des messages

Pour obtenir la liste complète des limitations bêta liées à 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 numéro de téléphone From pour programmer des messages. Si vous transmettez un numéro de téléphone From, les paramètres de programmation sont supprimés de la requête d'API et le message est envoyé immédiatement.
Un message doit être programmé au moins 60 minutes avant son heure d'envoi et ne peut pas être programmé plus de 7 jours avant la requête.
Si vous envisagez d'utiliser la programmation des messages à grande échelle, veuillez consulter l'ensemble des limitations de la version bêta dans l'article d'assistance.

Example 4

Loading Code Sample...

Example JSON response

Programmer un message

Remarque : Il n'y a pas d'événement de rappel de statut pour le statut scheduled. Vous pouvez continuer à recevoir des événements de rappel existants en incluant le paramètre facultatif StatusCallBack dans la requête de message.

Codes de statut de réponse

Paramètres valides : Un HTTP 201 (programmé) est renvoyé dans la réponse API synchrone lorsque vos paramètres de requête sont valides. Lorsqu'un message est programmé, vous voyez scheduled à la place de accepted.

Paramètres non valides : Un code HTTP 400 est renvoyé dans la réponse de l'API lorsque vos paramètres de requête ne sont pas valides.

Example 5

Loading Code Sample...

Example JSON response

Programmer un message avec une URL d'image

Example 6

Loading Code Sample...

Example JSON response

Programmer un message WhatsApp

Remarque : Assurez‐vous que votre expéditeur WhatsApp approuvé est ajouté au pool de numéros de votre service de messagerie à utiliser pour programmer un message WhatsApp.

WhatsApp exige que les notifications initiées par l'entreprise envoyées par votre application soient modélisées et préenregistrées, à l'exception des messages envoyés en réponse à un message initié par l'utilisateur. (Pour plus d'informations, reportez‐vous à la section‌Messagerie conversationnelle (‌Conversational Messaging) sur WhatsApp).Messagerie conversationnelle sur WhatsApp).

Lors de la programmation d'un message WhatsApp, la vérification des modèles pré‐enregistrés ne sera effectuée qu'au moment de l'envoi du message et non au moment de sa programmation. Si votre message ne respecte pas les modèles WhatsApp pré‐approuvés de votre compte, il est programmé, mais échoue au moment de l'envoi.

Annulation des messages programmés

Une fois qu'un message est programmé, vous pouvez l'annuler. Reportez‐vous à la section Annuler un message programmé pour savoir comment annuler des messages programmés.

Extraire une ressource de message

get

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

Renvoie un seul message spécifié par le message {SID} fourni.

Parameters

Parameters in REST API format
`account_sid` Path	get sid<AC> Not PII The SID of the Account associated with the Message resource
`sid` Path	get sid<MM> Not PII The SID of the Message resource to be fetched

Parameters in REST API format

account_sid

Path

get sid<AC> Not PII

The SID of the Account associated with the Message resource

sid

Path

get sid<MM> Not PII

The SID of the Message resource to be fetched

Example 1

Loading Code Sample...

Example JSON response

Fetch Message

Lire plusieurs ressources de messages

get

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

Renvoie la liste des messages associés à 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 côté serveur de Twilio, la pagination s'effectue en arrière‐plan.

Lorsque vous obtenez la liste de tous les messages, les résultats sont triés dans le champ DateSent, les messages les plus récents apparaissant en premier.

Si vous utilisez l'API REST de Twilio et que vous prévoyez de demander plus d'enregistrements qu'il ne peut s'afficher sur une seule page, vous pouvez utiliser le nextpageuri fourni. Cette méthode vous assure que votre prochaine requête reprend là où elle s'est arrêtée et peut vous éviter de récupérer des données en double si vous êtes en train d'envoyer ou de recevoir des messages.

Cela n'est pas nécessaire si vous utilisez une librairie d'aide Twilio, qui gère automatiquement la pagination. Pour plus d'informations, consultez la documentation de la librairie d'aide.

Vous pouvez également filtrer la liste en fournissant les paramètres de chaîne de requête suivants à la ressource de liste :

Parameters

Parameters in REST API format
`account_sid` Path	get sid<AC> Not PII The SID of the Account associated with the Message resources.
`to` Optional	get phone_number PII MTL: 120 DAYS Filter by recipient. For example: Set this `to` parameter to `+15558881111` to retrieve a list of Message resources with `to` properties of `+15558881111`
`from` Optional	get phone_number PII MTL: 120 DAYS Filter by sender. For example: Set this `from` parameter to `+15552229999` to retrieve a list of Message resources with `from` properties of `+15552229999`
`date_sent` Optional	get date_time_inequality<iso8601> Not PII Filter by Message `sent_date`. Accepts GMT dates in the following formats: `YYYY-MM-DD` (to find Messages with a specific `sent_date`), `<=YYYY-MM-DD` (to find Messages with `sent_date`s on and before a specific date), and `>=YYYY-MM-DD` (to find Messages with `sent_dates` on and after a specific date).
`date_sent_>` Optional	get string Not PII Filter by Message `sent_date`. Accepts GMT dates in the following formats: `YYYY-MM-DD` (to find Messages with a specific `sent_date`), `<=YYYY-MM-DD` (to find Messages with `sent_date`s on and before a specific date), and `>=YYYY-MM-DD` (to find Messages with `sent_dates` on and after a specific date).
`date_sent_<` Optional	get string Not PII Filter by Message `sent_date`. Accepts GMT dates in the following formats: `YYYY-MM-DD` (to find Messages with a specific `sent_date`), `<=YYYY-MM-DD` (to find Messages with `sent_date`s on and before a specific date), and `>=YYYY-MM-DD` (to find Messages with `sent_dates` on and after a specific date).

Example 1

Loading Code Sample...

Example JSON response

Obtenir tous les messages associés à votre compte

Lire : Répertorier tous les messages

Obtenir tous les messages associés à votre compte

Example 2

Loading Code Sample...

Example JSON response

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

Loading Code Sample...

Example JSON response

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

Loading Code Sample...

Example JSON response

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 à jour le corps d'une ressource de message.

Cette action est principalement utilisée pour modifier les messages : pour ce faire, effectuez un POST vers l'URI ci‐dessus et définissez le paramètre Body comme une chaîne vide : « ». Cela vous permettra de modifier efficacement le texte d'un message tout en conservant intactes les autres propriétés des ressources de messages.

Parameters

Parameters in REST API format
`account_sid` Path	post sid<AC> Not PII SID du Compte qui a créé les ressources de messages à mettre à jour.
`sid` Path	post sid<MM> Not PII The SID of the Message resource to be updated
`body` Optional	post string PII MTL: 30 DAYS The new `body` of the Message resource. To redact the text content of a Message, this parameter's value must be an empty string
`status` Optional	post ienum:update_status Not PII Set as `canceled` to prevent a not-yet-sent Message from being sent. Can be used to cancel sending a scheduled Message (Messaging Services only).

Example 1

Loading Code Sample...

Example JSON response

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 programmé

Avant d'utiliser cette fonctionnalité :

Assurez‐vous que la valeur du statut annulé est orthographiée avec un « l », (canceled) et non pas deux (cancelled).
Assurez‐vous de stocker le MessageSid des messages que vous programmez. Vous devez référencer le MessageSid pour chaque requête d'annulation de message
Il n'y a pas d'annulation en bloc. Si vous souhaitez annuler plusieurs messages, vous devez envoyer une requête d'annulation pour chaque message et référencer le MessageSid.
Il existe un nouvel événement de rappel de statut pour « Canceled ». Vous pouvez continuer à recevoir des événements de rappel existants en incluant le paramètre facultatif StatusCallBack dans la requête de message.

Remarque : Nous nous efforçons d'annuler un message programmé lorsque nous recevons votre requête. Un message ne peut pas être annulé une fois qu'il a atteint le statut finalisé.

Example 2

Loading Code Sample...

Example JSON response

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 supprimé, il n'apparaît plus dans les journaux de l'API et du portail de compte.

En cas de succès, renvoie HTTP 204 (aucun contenu) sans corps.

Une tentative de suppression d'un enregistrement de message en cours entraîne une erreur.

Parameters

Parameters in REST API format
`account_sid` Path	delete sid<AC> Not PII The SID of the Account associated with the Message resource
`sid` Path	delete sid<MM> Not PII The SID of the Message resource you wish to delete

Parameters in REST API format

account_sid

Path

delete sid<AC> Not PII

The SID of the Account associated with the Message resource

sid

Path

delete sid<MM> Not PII

The SID of the Message resource you wish to delete

Remarques : La suppression d'un message supprime également tout média associé au message, sauf si le même objet multimédia est associé à un autre message de votre compte qui n'a pas été supprimé. Par exemple, si vous avez envoyé 1000 messages multimédias avec la même pièce jointe, cet objet multimédia reste accessible jusqu'à ce que les 1000 enregistrements de messages associés soient supprimés.

Example 1

Loading Code Sample...

Example JSON response

Delete Message

Sous‐ressource de messages multimédias

Sous‐ressource de listes multimédias

Les ressources d'instance de message ont une ressource de listes multimédias pour l'ensemble des éléments multimédias inclus à un message donné :

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

Sous‐ressource d'instance multimédia

Les ressources d'instance de message ont des sous‐ressources d'instance multimédias. Si un média existe dans un message donné, vous pouvez récupérer des informations sur les images et autres médias.

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

Annexe

Valeurs de statut du message

Voici les valeurs possibles pour le paramètre« Status » :

Statut	Description
accepted (accepté)	Twilio a reçu votre requête d'API d'envoyer un message avec un Services de messagerie et un numéro « From » est sélectionné dynamiquement. Il s'agit du statut initial lors de l'envoi avec un service de messagerie et le paramètre « From ».
scheduled (programmé)	Le message est programmé pour être envoyé. 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 requête d'API d'envoi d'un message a réussi et le message est mis en file d'attente pour être envoyé. 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 à l'opérateur en amont le plus proche du réseau.
sent (envoyé)	L'opérateur en amont le plus proche a accepté le message.
Receiving	le message entrant a été reçu par Twilio et est en cours de traitement.
Reçu	Sur les messages entrants uniquement. Le message entrant a été reçu par l'un de vos numéros Twilio.
delivered (livré)	Twilio a reçu la confirmation de la livraison du message de la part de l'opérateur en amont et, le cas échéant, du téléphone du destinataire.
undelivered (non livré)	Twilio a reçu un accusé de réception indiquant que le message n'a pas été livré. Cela peut se produire pour plusieurs raisons, y compris le filtrage du contenu de l'opérateur et la disponibilité du téléphone du destinataire.
failed (échec)	Le message n'a pas pu être envoyé. Cela peut se produire pour diverses raisons, y compris les dépassements de file d'attente, les suspensions de compte et les erreurs de média (dans le cas de MMS). Twilio ne vous facture pas pour les messages ayant échoué.
read (lu)	Sur les messages WhatsApp uniquement. Le message a été remis et ouvert par le destinataire dans la conversation. Le destinataire doit avoir activé les accusés de réception.
canceled (annulé)	(fonction bêta) Le message a été annulé. Ce statut n'est accessible que lors de l'utilisation de Services de messagerie

Valeurs de librairie minimales prenant en charge les reç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 à la liste des propriétés du message.

Erreurs liées à la livraison

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

Notez que le message d'erreur est conçu pour être une description lisible par l'utilisateur. Les valeurs renvoyées peuvent être modifiées ultérieurement. Une liste complète des codes d'erreur Twilio et des conseils pour l'analyse des problèmes peuvent vous aider à résoudre les problèmes de livraison.

Code d'erreur	Message d'erreur	Description
30001	Queue overflow (dépassement de file d'attente)	Vous avez essayé d'envoyer trop de messages trop rapidement, et votre file d'attente de messages a dépassé la limite. Essayez d'envoyer à nouveau votre message après avoir attendu un certain temps.
30002	Account suspended (compte suspendu)	Votre compte a été suspendu entre l'envoi et la livraison du message. Veuillez contacter Twilio.
30003	Unreachable destination handset (téléphone de destination inaccessible)	Le téléphone de destination que vous tentez de joindre est éteint ou indisponible.
30004	Message blocked (message bloqué)	Le numé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 (téléphone de destination inconnu)	Le numéro de destination que vous tentez de joindre est inconnu et n'existe peut‐être plus.
30006	Landline or unreachable carrier (Ligne fixe ou opérateur non joignable)	Le numé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 numéros courts, un opérateur injoignable.
30007	Carrier violation (violation de l'opérateur)	Votre message a été signalé comme inacceptable par l'opérateur. Pour protéger leurs abonnés, de nombreux opérateurs ont mis en œuvre le filtrage du contenu ou du spam. En savoir plus sur le filtrage de l'opérateur
30008	Unknown error (erreur inconnue)	L'erreur ne correspond à aucune des catégories ci‐dessus.
30009	Missing segment (segment manquant)	Un ou plusieurs segments associés à votre message entrant en plusieurs parties n'ont pas été reçus.
30010	Message price exceeds max price (Le prix du message dépasse le prix maximum).	Le prix de votre message dépasse le prix du paramè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 requête)	Les informations d'authentification du canal sont incorrectes. Veuillez vérifier les informations d'identification dans la page des canaux dans la console ou vous authentifier à nouveau auprè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 à aucun canal configuré. Vérifiez que vous utilisez la bonne Adresse de l'endpoint du canal à 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 accepté le contenu donné)
63006	Could not format given content for the channel (Impossible de formater le contenu donné pour le canal)
63007	Twilio n'a pas trouvé de canal avec l'adresse de source spécifiée	The From address does not map to any configured Channels (l'adresse From de ne correspond à aucun canal configuré). Vérifiez que vous utilisez la bonne Adresse de l'endpoint du canal à la page Canal.
63008	Could not execute the request because the channel module is misconfigured (impossible d'exécuter la requête, car le module de canal est mal configuré)	Vérifiez la configuration du canal dans Twilio.
63009	Channel returned an error when executing the request (le canal a renvoyé une erreur lors de l'exécution de la requête)	Reportez‐vous au message d'erreur spé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 renvoyé une erreur interne qui l'a empêché de remplir la requête)
63013	This message send failed because it violates Channel provider's policy (cet envoi de message a échoué, car il viole la politique du fournisseur de canaux).	Veuillez consulter le message d'erreur spécifique à la chaî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 être remis à l'utilisateur, car il a été bloqué par une action de l'utilisateur).	Veuillez consulter le message d'erreur spécifique à la chaîne pour plus d'informations.

Retour à la liste des propriétés du message.

Propriété NumSegments

Pour les messages sortants , cette propriété indique le nombre de messages SMS nécessaires pour livrer le corps du message.

Si le corps d'un message comporte plus de 160 caractères GSM‐7 (ou 70 caractères UCS‐2), Twilio segmente et annote vos messages pour tenter de les réassembler correctement sur le téléphone du destinataire (non pris en charge par tous les opérateurs et les téléphones). Ainsi, le corps de votre texte est transmis aussi fidèlement que possible.

Sur les messages entrants, cette propriété indique le nombre de messages SMS qui composent le message reçu.

Si le corps de votre message contient plus de 160 caractères GSM‐7 (ou 70 caractères UCS‐2), Twilio tente de réassembler le message reçu par votre numéro de téléphone Twilio. Tous les opérateurs et téléphones ne prennent pas nécessairement en charge cette fonctionnalité.

Votre compte sera débité pour chaque segment envoyé ou reçu.

Retour à la liste des propriétés du message.

Paramètres de requête StatusCallback

Les paramètres que Twilio transmet à votre application dans sa requête à l'URL StatusCallback comprennent un sous‐ensemble de paramètres de requête standard et ces paramètres supplémentaires :

Paramètre	Description
MessageStatus	Statut du message. Les informations de remise du message sont indiquées dans le statut du message. Les valeurs possibles sont répertoriées dans la ressource de message.
ErrorCode	Code d'erreur (le cas échéant) associé à votre message. Si le statut de votre message est « failed » ou « undelivered », l'ErrorCode peut vous donner plus d'informations sur l'échec. Si le message a été remis avec succès, aucun code d'erreur ne s'affiche. Les valeurs possibles sont répertoriées ici.
ChannelInstallSid	SID de canal installé (affiché sur la page de détail du canal) qui a été utilisé pour envoyer ce message. Présent uniquement si le message a été envoyé via un canal.
ChannelStatusMessage	Message d'erreur renvoyé par le canal sous‐jacent en cas d'échec de l'envoi du message. Présent uniquement si le message a été envoyé via un canal et que la livraison du message a échoué.
ChannelPrefix	Préfixe spécifique au canal qui vous permet d'identifier le canal sur lequel ce message a été envoyé.
EventType	Contient des événements post‐livraison. Si le canal prend en charge les accusés de réception, ce paramètre sera inclus avec la valeur « READ » une fois que l'utilisateur aura lu le message. Actuellement pris en charge uniquement pour WhatsApp.

Retour à Créer une ressource de message

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.

Parameters

Example 1

Créer un message

Example 2

Créer un message WhatsApp

Example 3

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

Example 4

Programmer un message

Example 5

Programmer un message avec une URL d'image

Example 6

Programmer un message WhatsApp

Parameters

Example 1

Fetch Message

Parameters

Example 1

Lire : Répertorier tous les messages

Example 2

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

Example 3

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

Example 4

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

Parameters

Example 1

Mise à jour : modifier un message

Example 2

Annuler un message programmé

Parameters

Example 1

Delete Message

Besoin d'aide ?

Merci pour vos commentaires!

Merci pour vos commentaires !