Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Amazon Pinpoint intègre un service de validation de numéro de téléphone, que vous pouvez utiliser pour déterminer la validité d'un numéro, ainsi que pour obtenir des informations supplémentaires sur le numéro de téléphone lui-même. Par exemple, lorsque vous utilisez le service de validation de numéro de téléphone, il renvoie les informations suivantes :
-
Le numéro de téléphone au format E.164.
-
Le type de numéro de téléphone (mobile, fixe, VoIP, etc.).
-
La ville et le pays d’origine du numéro de téléphone.
-
Le fournisseur de services associé au numéro de téléphone.
Des frais supplémentaires sont facturés pour l’utilisation du service de validation de numéro de téléphone. Pour plus d'informations, consultez Tarification d'Amazon Pinpoint
Important
Pour les numéros de téléphone provenant des États-Unis et du Canada, l'API de validation des numéros de téléphone ne renverra plus de données pour City, County, Timezone et ZipCode.
Cas d'utilisation de la validation des numéros de téléphone Amazon Pinpoint
Vous pouvez utiliser le service de validation de numéro de téléphone dans plusieurs cas d’utilisation, parmi lesquels :
-
Vérification de numéros de téléphone fournis sur un formulaire web : si vous utilisez des formulaires web pour collecter des informations de contact pour vos clients, vous validez les numéros de téléphone fournis par les clients avant de soumettre le formulaire. Utilisez le backend de votre site web pour valider le numéro à l’aide de l’API Amazon Pinpoint. La réponse de l'API indique si le numéro n'est pas valide, par exemple si le numéro de téléphone est mal formaté. S’il s’avère que le numéro de téléphone fourni par le client n’est pas valide, votre formulaire web peut demander au client de fournir un autre numéro.
-
Nettoyage de votre base de contact existante : si vous disposez d'une base de données répertoriant les numéros de téléphone des clients, vous pouvez valider chaque numéro de téléphone, puis mettre à jour votre base de données en fonction des résultats. Par exemple, si vous détectez des points de terminaison dont les numéros de téléphone ne sont pas en mesure de recevoir des SMS, vous pouvez modifier la propriété
ChannelTypepour le point de terminaison deSMSsurVOICE. Vous pouvez d’abord valider le numéro de téléphone, puis mettre à jour la propriétéChannelTypepour les points de terminaison nouveaux ou existants en suivant les instructions dans Ajouter des points de terminaison à Amazon Pinpoint pour un seul point de terminaison ou Ajouter un lot de points de terminaison à Amazon Pinpoint pour plusieurs points de terminaison. -
Choix du canal adapté avant d’envoyer un message : si vous prévoyez d’envoyer un SMS, mais que vous déterminez que le numéro de destination n’est pas valide, vous pouvez envoyer le message au destinataire via un autre canal. Par exemple, si le point de terminaison n’est pas en mesure de recevoir des SMS, vous pouvez envoyer un message vocal.
Validez un numéro de téléphone à l'aide du AWS CLI
L'exemple suivant montre comment valider un numéro de téléphone à l'aide du AWS CLI. Pour plus d’informations, consultez phone-number-validate dans la Référence des commandes de l’AWS CLI . Pour des exemples de réponses de validation, voirRéponse de validation du numéro de téléphone. Pour plus d'informations sur la configuration du AWS CLI, voir Configurer le AWS CLI dans le guide de AWS Command Line Interface l'utilisateur.
Pour utiliser le service de validation des numéros de téléphone à l'aide du AWS CLI
-
Sur la ligne de commande, entrez la commande suivante :
aws pinpoint phone-number-validate --number-validate-request PhoneNumber=+442079460881,IsoCountryCode=GBDans la commande précédente, remplacez
+442079460881par le numéro de téléphone que vous souhaitez valider etGBpar le code ISO à deux chiffres du pays ou de la région.Note
Lorsque vous fournissez un numéro de téléphone au service de validation de numéro de téléphone, vous devez toujours inclure le code pays. Si vous n’incluez pas le code pays, le service peut renvoyer des informations relatives à un numéro de téléphone basé dans un autre pays. Vous pouvez avoir des tirets dans le numéro de téléphone, par exemple
+44-207-946-0881.
Réponse de validation du numéro de téléphone
Les informations renvoyées par le service de validation des numéros de téléphone varient légèrement en fonction des données disponibles pour le numéro de téléphone fourni. Cette section contient des exemples de réponses renvoyées par le service de validation des numéros de téléphone.
Note
Les données fournies par le service de validation de numéro de téléphone reposent sur des informations fournies par des opérateurs de télécommunications et d’autres entités dans le monde entier. Dans certains pays, les fournisseurs peuvent mettre à jour ces informations moins fréquemment que dans d’autres pays. Par exemple, si vous envoyez une requête pour valider un numéro de téléphone mobile, et que le numéro que vous avez fourni a été transmis d’un opérateur mobile à un autre, la réponse du service de validation de numéro de téléphone peut inclure le nom de l’opérateur d’origine, plutôt que celui de l’opérateur actuel.
Numéros de téléphone mobile valides
Lorsque vous envoyez une requête au service de validation des numéros de téléphone et que le numéro est un numéro de téléphone mobile valide, il renvoie des informations semblables à l’exemple suivant :
{
"NumberValidateResponse": {
"Carrier": "ExampleCorp Mobile",
"City": "Seattle",
"CleansedPhoneNumberE164": "+12065550142",
"CleansedPhoneNumberNational": "2065550142",
"Country": "United States",
"CountryCodeIso2": "US",
"CountryCodeNumeric": "1",
"OriginalPhoneNumber": "+12065550142",
"PhoneType": "MOBILE",
"PhoneTypeCode": 0,
"Timezone": "America/Los_Angeles",
"ZipCode": "98101"
}
}Numéros de téléphone fixe valides
Si votre requête contient un numéro de téléphone fixe valide, le service de validation des numéros de téléphone renvoie des informations semblables à l’exemple suivant :
{
"CountryCodeIso2": "US",
"CountryCodeNumeric": "1",
"Country": "United States",
"City": "Santa Clara",
"ZipCode": "95037",
"Timezone": "America/Los_Angeles",
"CleansedPhoneNumberNational": "4085550101",
"CleansedPhoneNumberE164": "14085550101",
"Carrier": "AnyCompany",
"PhoneTypeCode": 1,
"PhoneType": "LANDLINE",
"OriginalPhoneNumber": "+14085550101"
}Numéros de téléphone VoIP valides
Si votre requête contient un numéro de téléphone VoIP (voix sur IP) valide, le service de validation des numéros de téléphone renvoie des informations semblables à l’exemple suivant :
{
"NumberValidateResponse": {
"Carrier": "ExampleCorp",
"City": "Countrywide",
"CleansedPhoneNumberE164": "+441514960001",
"CleansedPhoneNumberNational": "1514960001",
"Country": "United Kingdom",
"CountryCodeIso2": "GB",
"CountryCodeNumeric": "44",
"OriginalPhoneNumber": "+441514960001",
"PhoneType": "VOIP",
"PhoneTypeCode": 2
}
}Numéros de téléphone non valides
Si votre requête contient un numéro de téléphone mobile non valide, le service de validation des numéros de téléphone renvoie des informations semblables à l’exemple suivant :
{
"NumberValidateResponse": {
"CleansedPhoneNumberE164": "+44163296076",
"CleansedPhoneNumberNational": "163296076",
"Country": "United Kingdom",
"CountryCodeIso2": "GB",
"CountryCodeNumeric": "44",
"OriginalPhoneNumber": "+440163296076",
"PhoneType": "INVALID",
"PhoneTypeCode": 3
}
}Notez que dans cette réponse, la propriété PhoneTypeindique que ce numéro de téléphone est INVALID. En outre, elle n’inclut pas d’informations sur l’opérateur ou l’emplacement associé au numéro de téléphone. Vous devez éviter d’envoyer des SMS ou des messages vocaux aux numéros de téléphone dont le PhoneType est INVALID, car ces numéros n’appartiennent probablement pas aux destinataires réels.
Autres numéros de téléphone
Parfois, la réponse du service de validation de numéro de téléphone comprend une propriété PhoneType dont la valeur est OTHER. Le service peut retourner ce type de réponse dans les situations suivantes :
-
Le numéro de téléphone est un numéro d’appel gratuit.
-
Le numéro de téléphone est réservé à une utilisation dans des émissions télévisées et des films, comme les numéros de téléphone nord-américains qui commencent par 555.
-
Le numéro de téléphone contient un indicatif qui n’est pas actuellement utilisé (par exemple, l’indicatif 999 en Amérique du Nord).
-
Le numéro de téléphone est réservé à d’autres fins.
L’exemple suivant illustre la réponse renvoyée par le service de validation de numéro de téléphone lorsque votre requête contient un numéro de téléphone nord-américain fictif :
{
"NumberValidateResponse": {
"Carrier": "Multiple OCN Listing",
"CleansedPhoneNumberE164": "+14255550199",
"CleansedPhoneNumberNational": "4255550199",
"Country": "United States",
"CountryCodeIso2": "US",
"CountryCodeNumeric": "1",
"OriginalPhoneNumber": "+14255550199",
"PhoneType": "OTHER",
"PhoneTypeCode": 4,
"Timezone": "America/Los_Angeles"
}
}Numéros de téléphone prépayés
Si votre requête contient un numéro de téléphone prépayé valide, le service de validation des numéros de téléphone renvoie des informations semblables à l'exemple suivant :
{
"NumberValidateResponse": {
"Carrier": "ExampleCorp",
"City": "Countrywide",
"CleansedPhoneNumberE164": "+14255550199",
"CleansedPhoneNumberNational": "4255550199",
"Country": "United States",
"CountryCodeIso2": "US",
"CountryCodeNumeric": "1",
"OriginalPhoneNumber": "+14255550199",
"PhoneType": "PREPAID",
"PhoneTypeCode": 5
}
}Pour plus d'informations sur les informations contenues dans ces réponses, consultez Validation des numéros de téléphone dans la Référence de l'API Amazon Pinpoint.
