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 Amazon Connect. 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 Amazon Connect, puis vous importez le numéro de téléphone associé dans Amazon Connect. 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 : activation d’Amazon Connect comme destination d’é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 messagerie professionnelle avec Amazon Connect](whatsapp-messaging-capabilities.md)
## Conditions préalables
Avant de pouvoir intégrer WhatsApp Amazon Connect, vous devez disposer des éléments suivants :
+ Un compte WhatsApp professionnel.
+ Un WhatsApp numéro de téléphone. Le numéro doit pouvoir recevoir un appel vocal ou un SMS afin de 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 Amazon 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 Amazon 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 commerciale automatisé 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 : activation d’Amazon Connect comme destination d’événement
Les étapes suivantes expliquent comment utiliser AWS End User Messaging Social pour activer Amazon Connect 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, consultez [https://docs.aws.amazon.com/connect/latest/APIReference/API_ImportPhoneNumber.html](https://docs.aws.amazon.com/connect/latest/APIReference/API_ImportPhoneNumber.html)le manuel *Amazon Connect API Reference* 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)le *AWS End User Messaging Social API Reference*.
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 **Type de destination**, choisissez **Amazon Connect**.
1. Pour **Instance Connect**, choisissez votre instance Amazon Connect 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. Cliquez sur **Enregistrer les modifications**.
Le processus d’importation de votre numéro de téléphone vers Amazon Connect est alors lancé.
Une fois l’opération terminée, le numéro s’affiche sur le site Web d’administration Amazon Connect.
**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.
![\[La page des numéros de téléphone affiche un WhatsApp numéro.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/whats-app-imported-number.png)
## É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 messagerie professionnelle avec Amazon Connect](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 Amazon Connect à 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.
![\[La section Flux de contacts/IVR de la page d'édition présentant un WhatsApp flux.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/whatsapp-flow-ivr.png)
1. Choisissez **Enregistrer**.
**Pour ajouter le bloc CheckContactAttribute**
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.
![\[Écran de téléphone portable affichant un exemple de message.\]](http://docs.aws.amazon.com/fr_fr/connect/latest/adminguide/images/whatsapp-options-results.png)
## É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.
### Ajout de fonctionnalités d’Amazon Connect
Les liens de la liste suivante vous redirigent vers des informations sur les fonctionnalités d’Amazon Connect que vous pouvez ajouter à vos expériences client et agent.
+ En savoir plus sur les [WhatsApp Fonctionnalités et limites de messagerie professionnelle avec Amazon Connect](whatsapp-messaging-capabilities.md)
+ [Permettre aux clients de reprendre les conversations par chat dans Amazon Connect](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éation de réponses rapides à utiliser lors des contacts par chat ou par e-mail dans Amazon Connect](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)
+ Click-to-WhatsAppannonces : [créez des annonces auxquelles vous pouvez accéder 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
Après avoir intégré le trafic réel à votre WhatsApp intégration, nous vous recommandons de surveiller les quotas suivants.
**Quotas Amazon Connect**
Pour plus d’informations sur les quotas par défaut et sur leur augmentation, consultez [Amazon Connect quotas de service](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 Amazon Connect à 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**
AWS End User Messaging Social impose des limites de débit à un certain nombre de messages APIs. Vérifiez les points suivants APIs pour savoir 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 Amazon Connect](#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 Amazon Connect
Si votre numéro importé ne s’affiche pas sur le site Web d’administration Amazon Connect, 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 : activation d’Amazon Connect comme destination d’é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 [Amazon Connect quotas de service](amazon-connect-service-limits.md).
+ Pour réattribuer un compte WhatsApp professionnel associé à une autre instance Amazon Connect, vous devez d'abord libérer les numéros de téléphone importés depuis l'instance Amazon Connect 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 Amazon Connect.
**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 : activation d’Amazon Connect comme destination d’é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énements Amazon Connect 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 : activation d’Amazon Connect comme destination d’événement](#enable-connect-destination) plus haut dans cette section. Votre rôle est 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 Amazon Connect 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 messagerie professionnelle avec Amazon Connect](whatsapp-messaging-capabilities.md).
# WhatsApp Fonctionnalités et limites de messagerie professionnelle avec Amazon Connect
L'intégration de la messagerie WhatsApp professionnelle fournit les fonctionnalités suivantes :
+ SMS
+ Messages interactifs. Pour de plus amples informations, veuillez consulter [Ajout de messages interactifs Amazon Lex pour les clients dans une session de chat](interactive-messages.md).
+ Messages avec aperçus de liens enrichis
+ Confirmations de remise et de lecture pour les messages professionnels
+ Pièces jointes
## Limitations
Lorsque vous intégrez la messagerie WhatsApp professionnelle à Amazon Connect, tenez compte des limites suivantes :
**Limites relatives aux confirmations de remise**
+ Les confirmations de lecture des messages client ne sont pas pris en charge.
+ Les confirmations de remise des messages client ne sont pas pris en charge. Les reçus de livraison qui apparaissent WhatsApp indiquent que le message WhatsApp a été reçu, et non Amazon Connect.
**Limites relatives aux SMS**
+ Les SMS entrants des clients de plus de 1 024 caractères ne sont pas pris en charge.
**Types de messages non pris en charge**
+ Les messages de contact entrants envoyés par les clients ne sont pas pris en charge.
+ Les messages de localisation entrants envoyés par les clients ne sont pas pris en charge.
+ Les messages de réaction envoyés par les clients ne sont pas pris en charge.
+ Les messages de réponse envoyés par les clients ne sont pas pris en charge. Le contenu des nouveaux messages est remis sans le contexte de réponse.
+ La réception de statuts de message indiquant qu’un message a été supprimé par le client n’est pas prise en charge.
**Limites relatives aux pièces jointes**
+ Toutes les pièces jointes des clients fournies lors de l’initiation d’un nouveau contact ou d’une nouvelle conversation ne sont pas prises en charge. Les clients peuvent envoyer des pièces jointes uniquement lors d’un contact existant.
+ Les pièces jointes des clients d’une taille supérieure à 20 Mo ne sont pas prises en charge.
+ Les pièces jointes sous-titrées ne sont pas prises en charge. Amazon Connect supprime tous les sous-titres et remet la pièce jointe.
+ Les stickers joints ne sont pas pris en charge.