Demandez un numéro de téléphone - SMS Amazon Pinpoint

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.

Demandez un numéro de téléphone

À l'aide de la console SMS Amazon Pinpoint, nous vous recommanderons l'une des identités d'origine ci-dessous en fonction de votre cas d'utilisation. Les recommandations sont basées sur vos critères de saisie, notamment si vous avez besoin de fonctionnalités SMS et/ou vocales, d'un numéro bidirectionnel et d'une estimation des messages mensuels.

Note

Les types de numéros de téléphone suivants doivent être demandés dans la console du Support Center.

Vous pouvez utiliser la console SMS Amazon Pinpoint ou AWS CLI demander un nouveau numéro de téléphone.

Request a phone number (Console)

Pour demander un numéro de téléphone à l’aide de la console Amazon Pinpoint SMS, suivez ces étapes :

Demander un numéro de téléphone (console)
  1. Ouvrez la console Amazon Pinpoint SMS à l’adresse https://console.aws.amazon.com/sms-voice/.

  2. Dans le volet de navigation, sous Configurations, choisissez Numéros de téléphone, puis Auteur de la demande.

  3. Sur la page Sélectionner un pays, vous devez choisir Pays de destination des messages dans la liste déroulante de destination des messages. Choisissez Suivant.

  4. Dans la section Cas d’utilisation de messagerie, saisissez les informations suivantes :

    • Sous Fonctionnalités du numéro, choisissez SMS, Voix ou les deux, selon vos besoins.

      Important

      Les fonctionnalités pour SMS et Voix ne peuvent pas être modifiées une fois que le numéro de téléphone a été acheté.

      • SMS : choisissez si vous avez besoin des fonctionnalités SMS.

      • Voix (texte vers audio) : choisissez si vous avez besoin de fonctionnalités vocales.

    • Sous Volume mensuel estimé de SMS par mois – facultatif, choisissez le nombre estimé de SMS que vous allez envoyer chaque mois.

    • Pour Siège de l’entreprise – facultatif, choisissez l’une des options suivantes :

      • Local — Choisissez cette option si le siège social de votre entreprise se trouve dans le même pays que celui de vos clients qui relanceront les SMS. Par exemple, vous choisirez cette option si votre siège social se trouve aux États-Unis et que les utilisateurs qui recevront des messages se trouvent également aux États-Unis.

      • International — Choisissez cette option si le siège social de votre entreprise n'est pas situé dans le même pays que celui de vos clients qui relanceront les SMS.

    • Pour Messagerie bidirectionnelle, choisissez Oui si vous avez besoin d’une messagerie bidirectionnelle.

  5. Choisissez Suivant.

  6. Sous Sélectionner le type d'expéditeur, choisissez le type de numéro de téléphone recommandé ou l'un des types de numéros disponibles. Les options disponibles sont basées sur les informations de cas d’utilisation que vous avez renseignées dans les étapes précédentes.

    Si vous choisissez 10DLC et que vous avez déjà enregistré une campagne, vous pouvez choisir la campagne entre la campagne associée et la campagne enregistrée pour ajouter le numéro de téléphone 10DLC à la campagne 10DLC.

    Si le type de numéro souhaité n'est pas disponible, vous pouvez choisir Précédent pour revenir en arrière et modifier votre cas d'utilisation. Vérifiez également le Pays et régions pris en charge (canal SMS) pour vous assurer que le type d'expéditeur que vous souhaitez est pris en charge dans le pays de destination.

    Si vous souhaitez demander un code court ou un code long, vous devez ouvrir un dossier auprès de AWS Support. Pour plus d’informations, consultez Demande de codes abrégés pour la messagerie SMS avec Amazon Pinpoint SMS et Demande de codes longs dédiés pour la messagerie SMS avec Amazon Pinpoint SMS.

  7. Choisissez Suivant.

  8. Dans Vérifier et demander, vous pouvez vérifier et modifier votre demande avant de l’envoyer. Choisissez Request (Demander).

  9. Une fenêtre Inscription requise peut apparaître en fonction du type de numéro de téléphone que vous avez demandé. Votre numéro de téléphone ou ID d’expéditeur est associé à cette inscription et ne peut pas envoyer de messages tant que votre inscription n’a pas été approuvée. Pour plus d'informations sur les conditions d'inscription, voirInscriptions.

    1. Pour Nom du formulaire d’inscription, entrez un nom convivial.

    2. Choisissez Démarrer l’inscription pour terminer l’inscription du numéro de téléphone, ou choisissez S’inscrire ultérieurement.

      Important

      Votre numéro de téléphone ou ID d’expéditeur ne peut pas envoyer de messages tant que votre inscription n’a pas été approuvée.

      La redevance mensuelle pour le numéro de téléphone vous est toujours facturée, quel que soit le statut de l’inscription. Pour plus d'informations sur les conditions d'inscription, voirInscriptions.

Request a phone number (AWS CLI)

Vous pouvez utiliser cette request-phone-numbercommande pour ajouter de nouveaux numéros de téléphone à votre compte. La disponibilité des numéros de téléphone et les fonctionnalités prises en charge varient selon les pays.

Important

Vous devrez peut-être enregistrer le numéro de téléphone ou l'identifiant de l'expéditeur une fois la demande terminée. La redevance mensuelle pour le numéro de téléphone vous est toujours facturée, quel que soit le statut de l’inscription. Pour plus d'informations sur les conditions d'inscription, voirInscriptions.

Pour demander un numéro de téléphone
  • Sur la ligne de commande, entrez la commande suivante :

    $ aws pinpoint-sms-voice-v2 request-phone-number \ > --iso-country-code XX \ > --message-type TRANSACTIONAL \ > --number-capabilities VOICE \ > --number-type LONG_CODE \ > --pool-id poolId \ > --deletion-protection-enabled \ > --opt-out-list-name optOutListName \ > --registration-id CO123EX

    Dans l’exemple précédent, apportez les modifications suivantes :

    • Remplacez XX par le code ISO-3166 alpha-2 à deux lettres du pays du numéro de téléphone (par exemple, CA pour le Canada).

    • Si vous souhaitez utiliser le numéro de téléphone pour envoyer du contenu promotionnel ou lié au marketing, remplacez TRANSACTIONAL par PROMOTIONAL. Dans le cas contraire, utilisez TRANSACTIONAL.

    • Si vous souhaitez demander un numéro de téléphone pour envoyer des SMS, remplacez VOICE par SMS. Vous pouvez également demander un numéro de téléphone qui peut être utilisé pour envoyer des SMS et des messages vocaux en spécifiant SMS VOICE.

    • Remplacez LONG_CODE par le type de numéro de téléphone que vous souhaitez demander. Les valeurs acceptables sont LONG_CODE, TOLL_FREE et TEN_DLC.

    • Remplacez poolId par l'ID ou l'Amazon Resource Name (ARN) du pool auquel vous souhaitez ajouter le numéro de téléphone. Ce paramètre est facultatif. Si vous ne voulez pas ajouter de numéro de téléphone à un pool, omettez ce paramètre.

    • Si vous souhaitez activer la protection contre la suppression pour ce numéro de téléphone, ajoutez le --deletion-protection-enabled paramètre. Par défaut, la protection contre la suppression est désactivée. Si la protection contre la suppression est activée, vous ne pouvez pas supprimer le numéro de téléphone à l'aide de l'ReleasePhoneNumberAPI, sauf si vous mettez à jour la configuration du numéro de téléphone pour désactiver cette fonctionnalité.

    • Remplacez le optOutListnom par le nom ou l'ARN de la liste de désinscription que vous souhaitez associer au numéro de téléphone. Ce paramètre est facultatif. Si vous ne souhaitez pas associer le numéro de téléphone à une liste de désabonnement, omettez ce paramètre.

    • Si vous demandez un numéro de téléphone à utiliser pour une campagne 10DLC, remplacez CO123EX par l'ID de la campagne 10DLC que vous souhaitez utiliser.

      Note

      Si vous prévoyez d'utiliser un numéro de téléphone 10DLC, vous devez d'abord enregistrer votre entreprise et votre campagne. À l'heure actuelle, le seul moyen de terminer ces processus d'enregistrement est d'utiliser la console SMS Amazon Pinpoint. Pour plus d'informations sur l'enregistrement de 10DLC, consultez. Processus d'enregistrement du 10DLC

Si le numéro est ajouté à votre compte, vous obtenez un résultat similaire à celui qui suit :

{ "PhoneNumberArn": "arn:aws:sms-voice:us-east-1:111122223333:phone-number/phone-615790209ea34aea8da9b729fexample", "PhoneNumberId": "phone-615790209ea34aea8da9b729fexample", "PhoneNumber": "+12045550123", "Status": "PENDING", "IsoCountryCode": "CA", "MessageType": "TRANSACTIONAL", "NumberCapabilities": [ "SMS" ], "NumberType": "LONG_CODE", "MonthlyLeasingPrice": "1.00", "TwoWayEnabled": false, "SelfManagedOptOutsEnabled": false, "OptOutListName": "Default", "DeletionProtectionEnabled": false, "CreatedTimestamp": 1645568542.0 }
Note

Lorsque vous achetez un numéro de téléphone pour la première fois, la valeur de l'attribut Status est PENDING. Lorsque le numéro de téléphone est prêt à être utilisé, la valeur de Status devient ACTIVE.

Si un numéro de téléphone répondant aux paramètres que vous avez spécifiés n'est pas disponible, la demande échoue avec un message d'erreur.

Modify phone number capabilities (AWS CLI)

Après avoir demandé un numéro de téléphone, vous pouvez utiliser la update-phone-numberCLI pour modifier les paramètres de ce numéro de téléphone ou pour activer des fonctionnalités supplémentaires. Vous pouvez modifier plusieurs paramètres du numéro de téléphone, notamment le pool et la liste de désabonnement associés au numéro de téléphone, ainsi que le paramètre de protection contre la suppression.

La messagerie bidirectionnelle est un exemple de fonctionnalité supplémentaire que vous pouvez activer en mettant à jour un numéro de téléphone. Le support pour la messagerie bidirectionnelle varie en fonction du pays vers lequel vous prévoyez d'envoyer des messages. Pour obtenir la liste des pays pris en charge, consultezPays et régions pris en charge (canal SMS).

$ aws pinpoint-sms-voice-v2 update-phone-number \ > --phone-number-id phone-d2b0f5dd4fd14ebdb2a3b9128example \ > --deletion-protection-enabled true \ > --opt-out-list-name optOutListName \ > --self-managed-opt-outs-enabled true \ > --two-way-enabled true \ > --two-way-channel-arn arn:aws:sns:us-east-1:111122223333:MyTopic

Dans la commande précédente, procédez comme suit :

  • Remplacez phone-d2b0f5dd4fd14ebdb2a3b9128example par l' PhoneNumberID ou le Amazon Resource Name (ARN) du numéro de téléphone que vous souhaitez mettre à jour. Vous pouvez trouver ces deux valeurs en utilisant l' DescribePhoneNumbersopération.

  • Remplacez le optOutListnom par le nom de la liste de désinscription que vous souhaitez associer à ce numéro de téléphone.

  • Si vous souhaitez désactiver la fonctionnalité de protection contre la suppression, remplacez la valeur du paramètre DeletionProtectionEnabled par false.

  • Si vous souhaitez bénéficier de la fonctionnalité de désabonnement aux SMS autogérée, remplacez la valeur du SelfManagedOptOutsEnabled paramètre par. false

  • Si vous souhaitez désactiver la messagerie SMS bidirectionnelle pour ce numéro de téléphone, remplacez la valeur du TwoWayEnabled paramètre par. false

  • Si vous activez la fonctionnalité de messagerie bidirectionnelle pour le numéro de téléphone, vous devez spécifier l'ARN d'une rubrique Amazon SNS. Remplacez arn:aws:sns:us-east- 1:111122223333 : par l'ARN de MyTopic la rubrique Amazon SNS que vous souhaitez utiliser. Lorsque vous recevez des messages entrants, ils sont envoyés à la rubrique que vous spécifiez.

Le paramètre PhoneNumberId est le seul requis pour cette commande. Vous pouvez omettre l'un des autres paramètres si vous ne voulez pas modifier les paramètres correspondants.

List phone numbers (AWS CLI)

Vous pouvez utiliser le describe-phone-numberspour obtenir plus d'informations sur les numéros de téléphone d'origine de votre compte Amazon Pinpoint.

Pour répertorier tous les numéros de téléphone de votre compte à l'aide du AWS CLI
  • Sur la ligne de commande, entrez la commande suivante :

    $ aws pinpoint-sms-voice-v2 describe-phone-numbers

Le résultat de cette commande inclut des informations sur tous les numéros de téléphone de votre compte. Vous pouvez également afficher des informations sur des numéros de téléphone spécifiques en incluant le paramètre PhoneNumberId.

Pour consulter les informations relatives à un numéro de téléphone spécifique à l'aide du AWS CLI
  • Sur la ligne de commande, entrez la commande suivante :

    $ aws pinpoint-sms-voice-v2 describe-phone-numbers \ > --phone-number-id phone-d2b0f5dd4fd14ebdb2a3b9128example

Dans l'exemple précédent, remplacez phone-d2b0f5dd4fd14ebdb2a3b9128example par l' PhoneNumberID ou le Amazon Resource Name (ARN) du numéro de téléphone sur lequel vous souhaitez obtenir plus d'informations.

Vous pouvez également utiliser le paramètre filter pour filtrer la liste des numéros de téléphone en fonction de critères que vous définissez. Par exemple, vous pouvez filtrer en fonction du pays du numéro de téléphone ou de ses fonctionnalités (c'est-à-dire s'il prend en charge les SMS ou les messages vocaux, ou les deux).

Pour afficher une liste filtrée de numéros de téléphone à l'aide du AWS CLI
  • Sur la ligne de commande, entrez la commande suivante :

    $ aws pinpoint-sms-voice-v2 describe-phone-numbers \ > --filters Name=number-capability,Values=SMS \ > --filters Name=iso-country-code,Values=CA

Le filtre Name peut avoir l'une des valeurs suivantes :

  • status : le statut actuel du numéro de téléphone, tel que ACTIVE.

  • iso-country-code : le code ISO-3166 alpha-2 à deux caractères du pays du numéro de téléphone.

  • message-type : le type de messages que le numéro de téléphone est utilisé pour envoyer. Les valeurs possibles sont TRANSACTIONAL ou PROMOTIONAL.

  • number-capability : les canaux de messagerie pris en charge par le numéro de téléphone. Les valeurs possibles sont SMS et VOICE.

  • number-type : le type de numéro de téléphone, tel que LONG_CODE, SHORT_CODE ou TOLL_FREE.

  • two-way-enabled : une valeur booléenne qui indique si la messagerie SMS bidirectionnelle est activée ou non.

  • self-managed-opt-outs-enabled : une valeur booléenne qui indique si les désabonnements par SMS autogérés sont activés ou non.

  • opt-out-list-name : le nom de la liste de désabonnement associée au numéro de téléphone.

  • deletion-protection-enabled : une valeur booléenne qui indique si le numéro de téléphone peut être supprimé à l'aide de l'opération DeletePhoneNumber.

État du numéro de téléphone

Lorsque vous achetez un numéro de téléphone pour la première fois, le statut du numéro de téléphone estPENDING. Lorsque le numéro de téléphone est prêt à être utilisé, son statut estACTIVE. Si le numéro de téléphone nécessite un enregistrement, celui-ci doit être terminé avant que le statut du numéro de téléphone ne soit changé en numéroACTIVE.

État du numéro de téléphone
  1. Ouvrez la console Amazon Pinpoint SMS à l’adresse https://console.aws.amazon.com/sms-voice/.

  2. Dans le volet de navigation, sous Configurations, choisissez Numéros de téléphone.

  3. Sur les numéros de téléphone, le statut du numéro de téléphone est indiqué dans la colonne État du numéro.

    • PENDING— Le numéro de téléphone n'est pas prêt à être utilisé. Vous devrez peut-être enregistrer le numéro de téléphone. Pour plus d’informations, consultez Inscriptions.

    • ACTIVE— Le numéro de téléphone est prêt à être utilisé.