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.
# Configuration de la messagerie WhatsApp professionnelle
Les rubriques de cette section expliquent comment configurer et tester la messagerie WhatsApp professionnelle pour Connect Customer. Vous utilisez [AWS End User Messaging Social](https://docs.aws.amazon.com/social-messaging/latest/userguide/what-is-service.html) pour associer un compte WhatsApp professionnel et un numéro de téléphone à une instance Connect Customer, puis vous importez le numéro de téléphone associé dans Connect Customer. Les clients peuvent ensuite WhatsApp envoyer des messages à votre centre d'appels.
Vous pouvez également automatiser les réponses aux questions client à l’aide d’Amazon Lex, ce qui permet aux agents de gagner du temps et produire moins d’efforts. Pour plus d’informations, consultez [Démarrez avec Amazon Lex](https://docs.aws.amazon.com/lexv2/latest/dg/getting-started.html) dans le *Guide du développeur Amazon Lex*.
**Topics**
+ [Conditions préalables](#whatsapp-prerequisites)
+ [Étape 1 : activer Connect Customer comme destination de l'événement](#enable-connect-destination)
+ [Étape 2 : configuration d’un flux de contacts entrants sur votre numéro de téléphone](#inbound-contact-flow)
+ [Étape 3 : envoi et réception de messages de test](#send-receive-test-messages)
+ [Étapes suivantes : préparation à la mise en service](#whatsapp-next-steps)
+ [Résolution des problèmes courants](#whatsapp-troubleshooting)
+ [WhatsApp Fonctionnalités et limites de la messagerie professionnelle avec Connect Customer](whatsapp-messaging-capabilities.md)
## Conditions préalables
Avant de pouvoir intégrer WhatsApp Connect Customer, vous devez disposer des éléments suivants :
+ Un compte WhatsApp professionnel.
+ Un WhatsApp numéro de téléphone. Le numéro doit être en mesure de recevoir un appel vocal ou un SMS pour terminer le processus de vérification du numéro de téléphone de Meta pour la messagerie WhatsApp professionnelle. Vous pouvez utiliser un numéro vocal du client Connect ou un AWS End User Messaging SMS numéro comme WhatsApp numéro de téléphone. Vous pouvez également utiliser un numéro de téléphone que vous possédez à l'extérieur AWS.
Lorsque vous utilisez un numéro vocal ou AWS End User Messaging SMS un numéro de téléphone d'un client Connect, nous vous recommandons de demander un nouveau numéro qui n'est pas utilisé pour le trafic vocal ou SMS en direct afin d'éviter toute interruption de service potentielle.
Vous pouvez utiliser la console sociale AWS End User Messaging à l'[https://console.aws.amazon.com/social-messaging/](https://console.aws.amazon.com/social-messaging/)adresse pour créer le compte WhatsApp professionnel et le numéro de téléphone. Pour plus d'informations, consultez [la section Inscription WhatsApp](https://docs.aws.amazon.com/social-messaging/latest/userguide/getting-started.html#getting-started-embedded) dans le *guide de l'utilisateur social d'AWS End User Messaging*.
**Important**
WhatsApp dispose d'un processus de vérification automatique des activités qui peut prendre jusqu'à 2 semaines. Nous vous recommandons de commencer ce processus le plus tôt possible. WhatsApp peut désactiver les comptes WhatsApp professionnels si la politique WhatsApp commerciale n'est pas respectée ou si l'identité de l'entreprise ne peut pas être vérifiée.
Nous vous recommandons également vivement de consulter [les meilleures pratiques relatives à AWS Final User Messaging Social](https://docs.aws.amazon.com/social-messaging/latest/userguide/best-practices.html) et [les WhatsApp meilleures pratiques](https://business.whatsapp.com/policy#best_practices) avant de créer et de lier WhatsApp des ressources.
Après avoir créé le compte et le numéro de téléphone, suivez les étapes des sections ci-dessous dans l’ordre indiqué.
## Étape 1 : activer Connect Customer comme destination de l'événement
Les étapes suivantes expliquent comment utiliser AWS End User Messaging Social pour activer Connect Customer comme destination d'événements pour votre compte WhatsApp professionnel associé. Cela permet au système d'importer votre WhatsApp numéro de téléphone.
Vous pouvez utiliser la [console sociale AWS End User Messaging](https://console.aws.amazon.com/social-messaging/) ou le AWS CLI pour effectuer cette tâche. Pour l'utiliser AWS CLI, reportez-vous [https://docs.aws.amazon.com/connect/latest/APIReference/API_ImportPhoneNumber.html](https://docs.aws.amazon.com/connect/latest/APIReference/API_ImportPhoneNumber.html)à la référence de l'*API client Connect et [https://docs.aws.amazon.com/social-messaging/latest/APIReference/API_PutWhatsAppBusinessAccountEventDestinations.html](https://docs.aws.amazon.com/social-messaging/latest/APIReference/API_PutWhatsAppBusinessAccountEventDestinations.html)à la référence* de l'*API sociale de messagerie pour utilisateurs AWS finaux*.
Les étapes suivantes expliquent comment utiliser la console.
**Pour utiliser la console**
1. Connectez-vous à la console sociale AWS End User Messaging à l'adresse [https://console.aws.amazon.com/social-messaging/](https://console.aws.amazon.com/social-messaging/).
1. Dans le volet de navigation, sélectionnez **Comptes WhatsApp professionnels**, puis choisissez le compte souhaité.
1. Dans l’onglet **Destination d’événement**, choisissez **Modifier la destination**.
1. Pour le **type de destination**, choisissez **Connect Customer**.
1. Pour l'**instance Connect**, choisissez votre instance Connect Customer dans la liste déroulante.
1. Pour **ARN du rôle**, choisissez un rôle IAM qui autorise la transmission de messages et d’événements, ainsi que l’importation de numéros de téléphone. Pour des exemples de politiques IAM, consultez [Ajout d’un message et d’une destination d’événement à la messagerie de réseau social pour utilisateurs finaux AWS](https://docs.aws.amazon.com/social-messaging/latest/userguide/managing-event-destinations-add.html#managing-event-destinations-amazon-connect-policies) dans le *Guide de l’utilisateur de la messagerie de réseau social pour utilisateurs finaux AWS*.
1. Sélectionnez **Enregistrer les modifications**.
Cela lance le processus d'importation de votre numéro de téléphone dans Connect Customer.
Une fois l'opération terminée, le numéro apparaît sur le site Web d'administration de Connect Customer.
**Pour afficher le numéro**
+ Dans le volet de navigation, choisissez **Canaux**, puis **Numéros de téléphone**.
La colonne **Chaînes actives** s'affiche **WhatsApp**pour tous les WhatsApp numéros.
## Étape 2 : configuration d’un flux de contacts entrants sur votre numéro de téléphone
Vous pouvez créer un flux de contacts entrants à utiliser avec votre WhatsApp numéro de téléphone, ou vous pouvez réutiliser un flux existant. Si vous réutilisez un flux, vous pouvez ajouter un bloc `CheckContactAttribute` et activer la ramification pour le flux. Le bloc vous permet d'envoyer WhatsApp des contacts vers une file d'attente spécifique ou d'effectuer une autre action.
Pour plus d’informations sur la création de votre flux de contacts, y compris les messages interactifs et les aperçus de liens enrichis, consultez [WhatsApp Fonctionnalités et limites de la messagerie professionnelle avec Connect Customer](whatsapp-messaging-capabilities.md) plus loin dans cette section.
Les étapes suivantes expliquent comment configurer un flux de contacts entrants et ajouter un bloc `CheckContactAttribute` au flux.
**Pour configurer un flux**
1. Démarrez la console Connect Customer à l'adresse [https://console.aws.amazon.com/connect/](https://console.aws.amazon.com/connect/)
1. Dans le volet de navigation, choisissez **Canaux**, puis **Numéros de téléphone**.
1. Choisissez le WhatsApp numéro, puis sélectionnez **Modifier**.
1. Sous **Flow/IVR**, choisissez le flux que vous avez mis à jour.
1. Choisissez **Enregistrer**.
**Pour ajouter CheckContactAttribute bloc**
1. Suivez les étapes 1 à 4 [de la section précédente](#enable-connect-destination).
1. Ouvrez la page **Propriétés** du flux.
1. Dans la section **Attribut à vérifier**, définissez **Espace de noms** sur **Attributs du segment** et **clé** sur **Sous-type**. Pour plus d’informations sur les attributs de segment, consultez [SegmentAttributes](ctr-data-model.md#segmentattributes) plus loin dans ce guide.
1. Dans la section **Conditions à vérifier**, définissez la **condition** sur **Égale** et **la valeur** pour **connecter : WhatsApp**.
1. Choisissez **Enregistrer**.
## Étape 3 : envoi et réception de messages de test
Au cours de cette étape, vous utilisez le panneau de configuration des contacts (CCP) et un téléphone portable pour envoyer et recevoir des messages de WhatsApp test.
**Pour tester l’intégration**
1. Dans le CCP, définissez votre statut sur **Disponible**.
1. WhatsApp Sur votre téléphone portable, lancez une conversation en saisissant le numéro de téléphone que vous avez ajouté précédemment.
L’image suivante illustre un message avec **Options** et la liste d’options qui en résulte.
## Étapes suivantes : préparation à la mise en service
Après avoir testé votre intégration, nous vous recommandons d'ajouter les fonctionnalités et capacités suivantes à votre canal WhatsApp de messagerie.
### Ajouter les fonctionnalités de Connect Customer
Les liens de la liste suivante vous redirigent vers des informations sur les fonctionnalités de Connect Customer que vous pouvez ajouter à l'expérience de vos clients et de vos agents.
+ En savoir plus sur les [WhatsApp Fonctionnalités et limites de la messagerie professionnelle avec Connect Customer](whatsapp-messaging-capabilities.md)
+ [Permettre aux clients de reprendre les conversations par chat dans Connect Customer](chat-persistence.md) : les clients peuvent reprendre des conversations antérieures en conservant le contexte, les métadonnées et les transcriptions. Ils n’ont pas besoin de se répéter lorsqu’ils reviennent dans un chat et les agents ont accès à l’historique complet de la conversation.
+ [Créez des réponses rapides à utiliser avec les contacts par chat et e-mail dans Connect Customer](create-quick-responses.md) : fournissez aux agents des réponses préécrites aux questions courantes des clients, qu’ils peuvent utiliser lorsqu’ils discutent avec eux. Les réponses rapides permettent aux agents de répondre plus rapidement aux clients.
### Ajout de points d’entrée
Les liens de la liste suivante vous redirigent vers des informations sur l’ajout de différents types de points d’entrée client.
+ Points d'entrée : [5 façons d'orienter les prospects et les clients vers des conversations de messagerie professionnelle](https://business.whatsapp.com/blog/messaging-app-entry-points) (article de WhatsApp blog)
+ Codes QR : [Gérez le code QR de votre plateforme WhatsApp commerciale](https://business.facebook.com/business/help/890732351439459) (article de méta-aide)
+ Choose-to-WhatsApp annonces : [créez des annonces que vous le souhaitez WhatsApp dans le gestionnaire de publicités](https://business.facebook.com/business/help/447934475640650?id=371525583593535) (article de méta-aide)
### Ajout d’un nom d’affichage à votre numéro de téléphone
Pour ajouter un nom d'affichage vérifié visible par les clients, voir le [nom WhatsApp d'affichage About Business](https://business.facebook.com/business/help/338047025165344) dans la méta-aide.
### Mise à l’échelle du trafic
Une fois que vous avez intégré le trafic réel à votre WhatsApp intégration, nous vous recommandons de surveiller les quotas suivants.
**Connect Customer Quotas**
Pour plus d’informations sur les quotas par défaut et sur leur augmentation, consultez [Connect Customer service quotas](amazon-connect-service-limits.md).
+ Quota [Chats actifs simultanés par instance](amazon-connect-service-limits.md#concurrent-active-chats). Pour en savoir plus sur la surveillance de ce quota, consultez [Surveillance de votre instance Connect Customer à l'aide de CloudWatch](monitoring-cloudwatch.md).
+ Quota de limitation [StartChatContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_StartChatContact.html).
+ Quota de limitation [SendChatIntegrationEvent](https://docs.aws.amazon.com/connect/latest/APIReference/API_SendChatIntegrationEvent.html).
+ Quota de limitation `SendIntegrationEvent`. API avec autorisation uniquement utilisée par AWS End User Messaging Social pour publier des WhatsApp événements entrants.
**Quotas de la messagerie de réseau social pour utilisateurs finaux**
La messagerie de réseau social pour utilisateurs finaux AWS impose des limites de débit à plusieurs API de messagerie. Surveillez les API suivantes pour déterminer si vous devez modifier un ou plusieurs quotas. Les liens vous redirigent vers la *Référence des API de la messagerie de réseau social pour utilisateurs finaux AWS*.
+ [SendWhatsAppMessage](https://docs.aws.amazon.com/social-messaging/latest/APIReference/API_SendWhatsAppMessage.html)
+ [PostWhatsAppMessageMedia](https://docs.aws.amazon.com/social-messaging/latest/APIReference/API_PostWhatsAppMessageMedia.html)
+ [GetWhatsAppMessageMedia](https://docs.aws.amazon.com/social-messaging/latest/APIReference/API_GetWhatsAppMessageMedia.html)
Pour plus d’informations sur l’augmentation des quotas de la messagerie de réseau social pour utilisateurs finaux AWS, consultez les rubriques suivantes dans le *Guide de l’utilisateur de la messagerie de réseau social pour utilisateurs finaux AWS* :
+ [Quotas de la messagerie de réseau social pour utilisateurs finaux AWS](https://docs.aws.amazon.com/social-messaging/latest/userguide/quotas.html)
+ [Augmentez les limites de conversation par messagerie dans WhatsApp](https://docs.aws.amazon.com/social-messaging/latest/userguide/increase-message-limit.html)
+ [Augmenter le débit des messages dans WhatsApp](https://docs.aws.amazon.com/social-messaging/latest/userguide/increase-message-throughput.html)
## Résolution des problèmes courants
Utilisez les informations suivantes pour résoudre les problèmes courants liés à une WhatsApp intégration.
**Topics**
+ [Impossible de voir les numéros de téléphone importés dans votre instance Connect Customer](#no-imported-number)
+ [Les messages entrants des clients ne sont pas remis](#whatsapp-messages-not-delivered)
### Impossible de voir les numéros de téléphone importés dans votre instance Connect Customer
Si votre numéro importé n'apparaît pas sur le site Web d'administration de Connect Customer, procédez comme suit :
+ Assurez-vous que le rôle IAM de destination d’événement dispose des autorisations nécessaires. Pour de plus amples informations, veuillez consulter [Étape 1 : activer Connect Customer comme destination de l'événement](#enable-connect-destination).
+ Vérifiez si votre quota *Numéros de téléphone par instance* doit être augmenté. Pour de plus amples informations, veuillez consulter [Connect Customer service quotas](amazon-connect-service-limits.md).
+ Pour réattribuer un compte WhatsApp professionnel associé à une autre instance Connect Customer, vous devez d'abord libérer les numéros de téléphone importés depuis l'instance Connect Customer d'origine. Une fois les numéros de téléphone publiés, vous pouvez mettre à jour la destination de l'événement sur votre compte WhatsApp professionnel associé à une autre instance Connect Customer.
**Important**
Ne libérez pas de numéros qui gèrent le trafic client en direct. [Demandez plutôt de nouveaux numéros de téléphone](https://docs.aws.amazon.com/connect/latest/adminguide/claim-and-manage-phonenumbers.html).
+ Pour aider à déterminer la cause du problème d'importation, recherchez les `ImportPhoneNumber` événements dans vos CloudTrail journaux et vérifiez les détails des erreurs. Si l’appel `ImportPhoneNumber` aboutit, vous pouvez appeler `DescribePhoneNumber` pour plus de détails sur l’erreur.
Si vous avez apporté une correction, vous devez réimporter les numéros de téléphone. Pour ce faire, répétez [Étape 1 : activer Connect Customer comme destination de l'événement](#enable-connect-destination).
### Les messages entrants des clients ne sont pas remis
Si la livraison des messages WhatsApp entrants s'arrête, recherchez dans vos AWS CloudTrail journaux `SendIntegrationEvent` les détails `SendChatIntegrationEvent` des erreurs.
Vous pouvez également consulter les scénarios courants suivants :
+ Assurez-vous qu'une destination d'événement Connect Customer est activée sur votre compte WhatsApp professionnel associé dans AWS End User Messaging Social.
+ Assurez-vous que votre rôle IAM de destination d’événement dispose des autorisations nécessaires. Pour plus d’informations, consultez [Étape 1 : activer Connect Customer comme destination de l'événement](#enable-connect-destination) plus haut dans cette section. Vous avez un rôle mal configuré s'il CloudTrail génère des `AccessDeniedException` erreurs depuis l'`SendIntegrationEvent`API.
+ Assurez-vous que votre WhatsApp numéro de téléphone a été correctement importé dans votre instance Connect Customer et qu'un flux de contacts entrants y est associé. Pour de plus amples informations, veuillez consulter [Étape 2 : configuration d’un flux de contacts entrants sur votre numéro de téléphone](#inbound-contact-flow).
+ Les messages entrants ont été supprimés, car ils ne sont pas encore pris en charge. Pour de plus amples informations, veuillez consulter [WhatsApp Fonctionnalités et limites de la messagerie professionnelle avec Connect Customer](whatsapp-messaging-capabilities.md).