View a markdown version of this page

Utiliser le service de recherche de transporteurs - AWS Messagerie SMS à l'utilisateur final
Cas d'utilisation de Carrier LookupFormats de numéros de téléphone pris en chargeÀ l'aide du service de recherche de transporteurs dans le AWS CLI

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.

Utiliser le service de recherche de transporteurs

AWS Les SMS de messagerie à l'utilisateur final incluent un service de recherche d'opérateur que vous pouvez utiliser pour obtenir des informations sur un numéro de téléphone, y compris si le numéro de téléphone est valide. Le service de recherche d'opérateurs renvoie les informations suivantes pour un numéro de téléphone :

  • Le numéro de téléphone au format E164 (effacé à partir de l'entrée d'origine).

  • Type de numéro de téléphone (invalide, fixe, mobile, autre).

  • Le nom du pays ou de la région pour le numéro de téléphone.

  • Le code numérique du pays ou de la région correspondant au numéro de téléphone.

  • Code de pays ou de région à deux caractères, au format ISO 3166-1 alpha-2, pour le numéro de téléphone.

  • Pour les numéros mobiles, le code de pays mobile (MCC).

  • Pour les numéros mobiles, le code du réseau mobile (MNC).

  • L'opérateur ou le fournisseur de services auprès duquel le numéro de téléphone est actuellement enregistré. Dans certains pays et régions, cette valeur peut être celle de l'opérateur ou du fournisseur de services auprès duquel le numéro de téléphone a été initialement enregistré.

L'utilisation du service de recherche de transporteurs entraîne des frais supplémentaires. Pour plus d'informations, consultez AWS la section Tarification des messages SMS destinés aux utilisateurs finaux.

Cas d'utilisation de Carrier Lookup

Vous pouvez utiliser le service de recherche de transporteurs pour activer plusieurs cas d'utilisation, notamment les suivants :

  • Rechercher les numéros de téléphone fournis sur un formulaire Web — Si vous utilisez des formulaires Web pour recueillir les coordonnées de vos clients, vous pouvez rechercher les numéros de téléphone fournis par les clients avant de soumettre le formulaire. Utilisez le backend de votre site Web pour rechercher et valider le numéro à l'aide de l'API SMS de messagerie utilisateur AWS final. La réponse de l'API indique si le numéro est valide, par exemple s'il est correctement formaté. Si vous déterminez que le numéro de téléphone fourni par le client n'est pas valide, votre formulaire Web peut inviter le client à fournir un numéro valide.

  • Nettoyage de votre base de données de contacts existante — Si vous disposez d'une base de données contenant les numéros de téléphone des clients, vous pouvez rechercher chaque numéro de téléphone et mettre à jour votre base de données à l'aide des résultats de recherche des opérateurs. 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é ChannelType pour le point de terminaison de SMS sur VOICE.

  • 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.

Formats de numéros de téléphone pris en charge

Les numéros de téléphone doivent être au format E164, en commençant par le signe plus (+) suivi du code du pays et du numéro de téléphone (par exemple, +12065551234). Le service de recherche de transporteurs accepte différents caractères de mise en forme et les supprime automatiquement pendant le traitement. Vous pouvez inclure les caractères de mise en forme suivants dans la saisie de votre numéro de téléphone :

  • Parenthèses : +1 (555) 123-4567

  • Supports : +1 [555] 123-4567

  • Espaces : +1 555 123 4567

  • Tirets : +1-555-123-4567

  • Périodes : +1.555.123.4567

  • Virgules : +1,555,123,4567

  • Formatage mixte : +1 (555)-123.4567

Tous les caractères de mise en forme sont automatiquement supprimés pendant le traitement et le service renvoie le numéro de téléphone au format E164 standard (par exemple,+15551234567) dans le E164PhoneNumber champ de la réponse.

À l'aide du service de recherche de transporteurs dans le AWS CLI

L'exemple suivant montre comment utiliser le service de recherche de transporteurs dans le AWS CLI. Le service accepte les numéros de téléphone comportant différents caractères de formatage (parenthèses, crochets, espaces, traits d'union, points, virgules) et les convertit automatiquement au format E164 pour le traitement. Pour plus d'informations, consultez CarrierLookupla référence de l'API SMS de messagerie utilisateur AWS final ou carrier-lookup dans la référence des AWS CLI commandes.

Pour utiliser le service de recherche de transporteurs (CLI)

  • En ligne de commande, entrez la commande suivante. Vous pouvez utiliser différents formats de numéros de téléphone. Le service accepte les caractères spéciaux tels que les parenthèses, les crochets, les espaces, les tirets, les points et les virgules :

    $ aws pinpoint-sms-voice-v2 carrier-lookup --phone-number "+1 (555) 555-5333"

    Ou au format E164 :

    $ aws pinpoint-sms-voice-v2 carrier-lookup --phone-number +15555555333

Réponses de recherche de transporteurs

Les informations fournies par le service de recherche d'opérateurs varient légèrement en fonction des données disponibles pour le numéro de téléphone que vous fournissez. Cette section contient des exemples de réponses renvoyées par le service de recherche de transporteurs.

Note

Les données fournies par le service de recherche d'opérateurs sont basées sur les informations fournies par les fournisseurs de télécommunications et d'autres entités du monde entier. Dans certains pays, les fournisseurs peuvent mettre à jour ces informations moins fréquemment que dans d’autres pays. Par exemple, si vous émettez une demande de validation d'un numéro de téléphone mobile et que le numéro que vous avez fourni a été transféré d'un opérateur mobile à un autre, la réponse du service de recherche d'opérateurs peut inclure le nom de l'opérateur d'origine, par opposition au nom actuel.

Numéros de téléphone mobile valides

La réponse suivante est un exemple des informations CarrierLookup renvoyées pour un numéro de téléphone portable valide :

{
    "E164PhoneNumber": "+15555555333",
    "DialingCountryCode": "1",
    "IsoCountryCode": "US",
    "Country": "United States",
    "MCC": "310",
    "MNC": "260",
    "Carrier": "ExampleCorp Mobile",
    "PhoneNumberType": "MOBILE"
}
Numéros de téléphone fixe valides

La réponse suivante est un exemple des informations CarrierLookup renvoyées pour un numéro de téléphone fixe valide :

{
    "E164PhoneNumber": "+15555555333",
    "DialingCountryCode": "1",
    "IsoCountryCode": "CA",
    "Country": "Canada",
    "Carrier": "ExampleCorp Landline",
    "PhoneNumberType": "LANDLINE"
}
Numéros de téléphone non valides

Si votre demande contient un numéro de téléphone non valide, le service de recherche d'opérateurs renvoie des informations similaires à l'exemple suivant :

{
    "E164PhoneNumber": "+15555555333444666",
    "PhoneNumberType": "INVALID"
}}

Notez que dans cette réponse, la propriété PhoneNumberTypeindique 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 PhoneNumberType est INVALID, car ces numéros n’appartiennent probablement pas aux destinataires réels.

Autres numéros de téléphone

Les numéros de téléphone qui ne sont pas classés comme mobiles, fixes ou non valides sont renvoyés avec une PhoneNumberType valeur deOTHER.