Comment puis-je utiliser l'API Amazon Connect StartOutboundVoiceContact pour passer des appels sortants aux clients ?

Brève description

L'exemple de configuration suivant vous permet d'utiliser l'API StartOutboundVoiceContact pour passer des appels. Dans cet exemple, votre centre d'appels Amazon Connect appelle le numéro de destination et accueille le destinataire en lui disant « Bonjour » et le nom que vous spécifiez. Ensuite, l'appel est automatiquement déconnecté. Pour d'autres exemples de configuration, consultez Automatiser les appels sortants vers les clients à l'aide d'Amazon Connect.

Résolution

Remarque : si des erreurs surviennent lorsque vous exécutez des commandes de l'interface de la ligne de commande AWS (AWS CLI), reportez-vous à Résolution des erreurs liées à AWS CLI. Vérifiez également que vous utilisez la version la plus récente de l'interface AWS CLI.

Créer un flux de contacts sortants

Important : pour créer un flux de contacts, connectez-vous à votre instance Amazon Connect en tant qu'utilisateur disposant d'autorisations suffisantes dans son profil de sécurité.

1. Utilisez votre URL d'accès pour vous connecter à votre instance Amazon Connect : (https://alias.awsapps.com/connect/login -ou- https://alias.awsapps.com/connect/login).
   Remarque : remplacez l'alias par l'alias de votre instance.
2. Dans le volet de navigation de gauche, passez la souris sur Routage, puis choisissez Flux de contacts.
3. Sur la page Flux de contacts, choisissez un modèle. Vous pouvez également choisir Créer un flux de contacts pour concevoir un flux de contacts à partir de zéro.
4. Dans le concepteur de flux de contacts, pour Entrer un nom, saisissez un nom pour le flux de contacts. Exemple : Appels sortants.
5. Choisissez Enregistrer.

Pour en savoir plus, reportez-vous à Créer un flux.

Ajouter un bloc Lire l'invite

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

1. Dans le concepteur de flux de contacts, développez Interagir.
2. Glissez et déposez un bloc Lire l'invite sur le canevas.
3. Choisissez le titre du bloc Lire l'invite. Le menu des paramètres du bloc s'ouvre.
4. Pour Invite, procédez comme suit :
   Choisissez Synthèse vocale (ad hoc).
   Dans le champ Entrer du texte, saisissez « **Bonjour. Ceci est un appel test. **»
   Vérifiez que l'option Interpréter en tant que est définie sur Texte.
   Choisissez Enregistrer.

Pour plus d'informations, reportez-vous à Ajouter la synthèse vocale aux invites et Utiliser les attributs de contact Amazon Connect.

Ajouter un bloc Déconnecter/Raccrocher

Pour mettre fin automatiquement à l'appel une fois le message sortant diffusé, utilisez un bloc de contacts Déconnecter/Raccrocher.

1. Choisissez Terminer/Transférer.
2. Glissez-déposez un bloc Déconnecter/Raccrocher sur le canevas à droite du bloc Lire l'invite.

Connecter les blocs de contact

Connectez tous les connecteurs de votre flux de contacts à un bloc dans l'ordre suivant :
Point d'entrée > Lire l'invite > Déconnecter/Raccrocher
Important : avant de pouvoir publier le flux de contacts, vous devez connecter tous les connecteurs à un bloc.

Enregistrer et publier le flux de contacts

1. Pour enregistrer un brouillon du flux, choisissez Enregistrer.
2. Choisissez Publier pour activer le flux immédiatement.

Obtenez votre identifiant d'instance Amazon Connect et votre identifiant de flux de contacts

1. Dans le concepteur de flux de contacts, développez Afficher des informations de flux supplémentaires.
2. Sous ARN, copiez l'ARN. L'ARN du flux de contacts inclut votre identifiant d'instance Amazon Connect et votre identifiant de flux de contacts. Vous avez besoin de ces identifiants pour appeler l'API StartOutboundVoiceContact.

Exemple de flux de contacts ARN

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 ce n'est pas déjà fait, créez une politique Gestion des identités et des accès AWS (AWS IAM) qui vous permet d'appeler l'API connect:StartOutboundVoiceContact. Ensuite, attachez-le.

L'exemple de politique JSON suivant fournit les autorisations requises :

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-flow/*"
    }
  ]
}

Appeler l'API StartOutboundVoiceContact

Exécutez la commande suivante depuis l'interface 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 du destinataire au format E.164. Remplacez contactFlowId par votre identifiant de flux de contacts. Remplacez instanceId par votre identifiant 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, reportez-vous à start-outbound-voice-contact dans la référence des commandes de l'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 aboutit et un code d'erreur en cas d'échec.

Pour plus d'informations sur les erreurs communes à l'API StartOutboundVoiceContact, consultez la section Erreurs dans StartOutboundVoiceContact.

Informations connexes

se connecter (référence des commandes de l'interface AWS CLI)

Créer des invites

Configurer la section d'identification des appelants sortants dans StartOutboundVoiceContact