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 :
- Vous envoyez un message SMS, WhatsAppouCanaux via l'API REST
- Vous utilisez le mot <message> dans TwiML
- Vous avez émis un message à partir d'une carte SIM programmable Wireless
- Quelqu'un envoie un message à l'un de vos numéros Twilio
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
|
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, |
direction
|
Sens du message. Ce peut être : |
from
|
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 et heure de la dernière mise à jour de la ressource, en GMT, spécifiées au format RFC 2822. |
price
|
Montant facturé pour le message, dans la devise spécifiée par |
error_message
|
Description de error_code si votre message |
uri
|
URI de la ressource relatif à |
account_sid
|
SID du Compte qui a envoyé le message ayant créé la ressource. |
num_media
|
Nombre de fichiers multimédias associés au message. Un message peut envoyer jusqu'à 10 fichiers multimédias. |
status
|
The status of the message. Can be: |
messaging_service_sid
|
SID du Service de messagerie utilisé avec le message. La valeur est nulle si aucun service de messagerie n'a été utilisé. |
sid
|
Chaîne unique créée pour identifier la ressource de message. |
date_sent
|
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 et heure de création de la ressource, en GMT, spécifiées au format RFC 2822. |
error_code
|
Le code d'erreur est renvoyé si votre message |
price_unit
|
Monnaie dans laquelle le |
api_version
|
Version de l'API utilisée pour traiter le message. |
subresource_uris
|
Liste des ressources connexes identifiées par leurs URI relatifs à |
Créer une ressource de message
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 statutqueued
ou une erreur.MessagingServiceSid
: L'API renvoie d'abord le statutaccepted
. Twilio détermine ensuite le numéro de téléphone optimal pour le champFrom
. Toutes les erreurs de livraison sont envoyées de manière asynchrone à votre URL StatusCallback.
Parameters
Parameters in REST API format | |
---|---|
account_sid
Path
|
SID du Compte qui va créer la ressource. |
to
Required
|
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
|
URL à appeler en utilisant la méthode |
application_sid
Optional
|
SID de l'application qui doit recevoir le statut du message. Nous effectuons un POST du paramètre |
max_price
Optional
|
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 |
provide_feedback
Optional
|
Indique s'il faut confirmer la livraison du message. Définissez cette valeur sur |
attempt
Optional
|
Nombre total de tentatives faites (y compris celle‐ci) pour envoyer le message, quel que soit le fournisseur utilisé |
validity_period
Optional
|
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
|
Réservé |
content_retention
Optional
|
Détermine si le contenu du message peut être stocké ou modifié en fonction des paramètres de confidentialité |
address_retention
Optional
|
Détermine si l'adresse peut être stockée ou masquée en fonction des paramètres de confidentialité |
smart_encoded
Optional
|
Indique s'il faut détecter les caractères Unicode ayant un caractère GSM‐7 similaire et les remplacer. Ce peut être : |
persistent_action
Optional
|
Actions riches pour les messages de canaux. |
shorten_urls
Optional
|
Détermine l'utilisation du suivi des clics. Une définition sur |
schedule_type
Optional
|
Indique votre intention de programmer un message. Transmettez la valeur |
send_at
Optional
|
Heure à laquelle Twilio enverra le message. Doit être au format ISO 8601. |
send_as_mms
Optional
|
If set to True, Twilio will deliver the message as a single MMS message, regardless of the presence of media. |
content_sid
Optional
|
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
|
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
|
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
Required if
from
is not passed
|
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 |
body
Required if
media_url
is not passed
|
Texte du message à envoyer. Peut contenir jusqu'à 1 600 caractères. |
media_url
Required if
body
is not passed
|
URL du média à envoyer avec le message. Le média peut être de type |
Example 1
Example 2
Example 3
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éphoneFrom
pour programmer des messages. Si vous transmettez un numéro de téléphoneFrom
, 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
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
Example 6
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 sectionMessagerie 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
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
|
SID du Compte qui a créé la ressource de message à extraire. |
sid
Path
|
Chaîne fournie par Twilio qui identifie de manière unique la ressource de message à extraire. |
Example 1
Lire plusieurs ressources de messages
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
|
SID du Compte qui a créé les ressources de messages à lire. |
to
Optional
|
Lire les messages envoyés uniquement à ce numéro de téléphone. |
from
Optional
|
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
|
Date des messages à afficher. Spécifiez une date au format |
Example 1
Example 2
Example 3
Example 4
Mettre à jour une ressource de message
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
|
SID du Compte qui a créé les ressources de messages à mettre à jour. |
sid
Path
|
Chaîne fournie par Twilio qui identifie de manière unique la ressource de message à mettre à jour. |
body
Optional
|
Texte du message à envoyer. Peut comporter jusqu'à 1 600 caractères. |
status
Optional
|
En cas de définition sur |
Example 1
Annuler un message programmé
Avant d'utiliser cette fonctionnalité :
- Assurez‐vous que la valeur du statut annulé est orthographiée avec un « l », (canceled) et non pas deux (cancelled).
- Assurez‐vous de stocker le
MessageSid
des messages que vous programmez. Vous devez référencer leMessageSid
pour chaque requête d'annulation de message - 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
. - 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
Supprimer une ressource de message
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
|
SID du Compte qui a créé les ressources de messages à supprimer. |
sid
Path
|
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
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. |
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.