Comment utiliser l'API StartOutboundVoiceContact d'Amazon Connect pour passer des appels sortants vers mes clients ?

Dernière mise à jour : 25/01/2022

Je souhaite utiliser Amazon Connect pour programmer des appels sortants afin de contacter mes clients. Comment puis-je automatiser les appels sortants à l'aide de l'API StartOutboundVoiceContact d'Amazon Connect ?

Brève description

Vous pouvez suivre les instructions de cet article pour créer un exemple de configuration qui vous permet d'initier des appels à l'aide de l'API StartOutboundVoiceContact.

Dans cet exemple de configuration, votre centre de contact Amazon Connect appelle le numéro de destination, puis salue le destinataire avec « Bonjour » ainsi que le nom que vous avez spécifié. Ensuite, l'appel se déconnecte automatiquement.

Pour voir d'autres exemples de configuration, consultez Automatisation des appels sortants vers des clients à l'aide d'Amazon Connect.

Solution

Remarque : si vous recevez des erreurs lors de l'exécution de commandes AWS Command Line Interface (AWS CLI), vérifiez que vous utilisez la version AWS CLI la plus récente.

Créer un flux de contact sortant

Important : pour créer un flux de contact, vous devez vous connecter à votre instance Amazon Connect en tant qu'utilisateur disposant des autorisations suffisantes dans son profil de sécurité.

1.    Connectez-vous à votre instance Amazon Connect à l'aide de votre URL d'accès (https://alias.awsapps.com/connect/login ou https://alias.awsapps.com/connect/login).
Remarque : remplacez alias par l'alias de votre instance.

2.    Dans le panneau de navigation gauche, survolez Routage, puis sélectionnez Flux de contact.

3.    Sur la page Contact flows (Flux de contact), choisissez un modèle ou Create contact flow (Créer un flux de contact) pour créer un flux de contact entièrement nouveau).

4.    Dans l'outil de conception de flux de contact, saisissez un nom pour le flux de contact dans le champ Enter a name (Saisir un nom). Par exemple, « Outbound calling » (Appel sortant).

5.    Choisissez Save (Enregistrer).

Pour en savoir plus, consultez Créer un flux de contact.

Ajouter un bloc Lire l'invite

Pour configurer l'invite audio que les clients entendent durant l'appel, utilisez un bloc de contact Lire l'invite.

1.    Dans le concepteur de flux de contacts, développez Interagir.

2.    Faites glisser et déposer un bloc Lire l'invite sur le canevas.

3.    Choisissez le titre du bloc Play prompt (Lire l'invite). Le menu des paramètres du bloc s'ouvre.

4.    Pour Prompt (Invite), procédez comme suit : Choisissez Text to speech (Ad hoc) (Synthèse vocale (ad hoc)). Pour Enter text (Saisir un texte), saisissez « Salut. Ceci est un appel test. » Confirmez que Interpret as (Interpréter en tant que) est défini sur Text (Text). Sélectionnez Save (Enregistrer).

Pour plus d'informations, consultez Ajout de la synthèse vocale aux invites et Utilisation d'attributs de contact Amazon Connect.

Ajouter un bloc Déconnecter/raccrocher

Pour mettre fin automatiquement à l'appel après la lecture du message sortant, utilisez un bloc de contact Déconnecter/Raccrocher.

1.    Sélectionnez Terminer/Transférer.

2.    Faites glisser et déposez un bloc Disconnect / hang up (Déconnecter/Raccrocher) sur le canevas à droite du bloc Play prompt (Lire l'invite).

Connecter les blocs de contact

Connectez tous les connecteurs de votre flux de contact à un bloc, dans l'ordre qui suit :

Point d'entrée > Lire l'invite > Se déconnecter/raccrocher

Important : tous les connecteurs doivent être connectés à un bloc avant de pouvoir publier le flux de contact.

Enregistrer et publier le flux de contact

1.    Choisissez Save (Enregistrer) pour enregistrer une ébauche du flux.

2.    Choisissez Publish (Publier) pour activer le flux immédiatement.

Obtenir votre ID d'instance Amazon Connect et votre ID de flux de contacts

1.    Dans le concepteur de flux de contacts, développez Show additional flow information (Afficher des informations supplémentaires relatives au flux).

2.    Sous ARN, copiez l'Amazon Resource Name (ARN). L'ARN du flux de contact inclut votre ID d'instance Amazon Connect et votre ID de flux de contact. Vous avez besoin de ces identifiants pour appeler l'API StartOutboundVoiceContact.

Exemple d'ARN du flux de contact

arn:aws:connect:region:123456789012:instance/12a34b56-7890-1234-cde5-6789f0a1b2c3/contact-flow/123a45b6-c7d8-9012-34e5-6fab789c012d

Confirmer vos autorisations IAM pour Amazon Connect

Si vous ne l'avez pas déjà fait, créez et attachez une stratégie AWS Identity and Access Management (AWS IAM) qui vous permet d'appeler l'API connect:StartOutboundVoiceContact.

Le document d'exemple de stratégie JSON suivant fournit les autorisations obligatoires :

Important : remplacez l'ARN de l'instance (la valeur « Ressource ») par l'ARN de votre instance Amazon Connect.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "VisualEditor0",
      "Effect": "Allow",
      "Action": "connect:StartOutboundVoiceContact",
      "Resource": "arn:aws:connect:region:123456789012:instance/12a34b56-7890-1234-cde5-6789f0a1b2c3/contact/*"
    }
  ]
}

Appeler l'API StartOutboundVoiceContact

Exécutez la commande suivante depuis l'interface de ligne de commande AWS (AWS CLI) :

Important : remplacez awsRegion par la région AWS de votre instance Amazon Connect. Remplacez phoneNumber par le numéro de téléphone d'un destinataire au format E.164. Remplacez contactFlowId par votre ID de flux de contacts. Remplacez instanceId par votre ID d'instance Amazon Connect. Remplacez instancePhoneNumber par le numéro de téléphone de votre centre d'appels au format E.164. Pour plus d'informations, consultez start-outbound vot-contact dans la Référence des commandes de l'interface de ligne de commande AWS (AWS CLI).

$ aws connect start-outbound-voice-contact --region awsRegion --destination-phone-number phoneNumber --contact-flow-id contactFlowId --instance-id instanceId --source-phone-number instancePhoneNumber

La réponse de la commande renvoie un ContactId lorsque l'action est réussie et un code d'erreur en cas d'échec.

Pour plus d'informations sur les erreurs courantes liées à l'API StartOutboundVoiceContact, consultez la section Erreurs de StartOutboundVoiceContact.


connect (Référence de la commande de l'AWS CLI)

Création d'invites

Configuration de l'ID de l'appelant sortant

Cet article vous a-t-il été utile ?


Besoin d'aide pour une question technique ou de facturation ?