Amazon Connect Chat: Créer votre propre expérience de chat client

Amazon Connect prend désormais en charge la discussion asynchrone! Les clients peuvent discuter à partir d'un site Web, d'une application mobile, de SMS ou de divers services de messagerie. Tout ce que vous avez à faire est de construire l’intégration.

Dans ce blog, nous expliquerons comment une telle intégration est construite. Nous nous concentrerons sur un cas d’utilisation commun: un widget de discussion intégré à un site Web destiné aux clients.

Scénario

Nous aimerions que nos clients initient des sessions de discussion via le site Web de notre produit. Nous attendons de nos clients qu'ils leur demandent des informations sur les produits, l'état des commandes, les remboursements et les offres spéciales. Nous utiliserons un widget de discussion en ligne, intégré au site Web du produit, pour connecter nos clients. Cela ressemblera à quelque chose comme ceci.

Mise en oeuvre

Nous allons utiliser les nouvelles API de chat d'Amazon pour créer le widget de chat. Dans ce blog, nous allons nous concentrer sur trois fonctionnalités: envoyer et discuter des chats, et historique des conversations .

Pour commencer, soulignons quelques-unes des nouvelles API de discussion. 19659002] Remarque: les paramètres d'entrée et de sortie répertoriés ne sont pas exhaustifs, mais constituent le minimum nécessaire pour comprendre le but de chaque appel d'API. Consultez les références ci-dessous pour obtenir une documentation complète sur l'API.

Amazon Connect Service

StartChatContact
Initie un flux de contacts pour la discussion. Renvoie un jeton pouvant être utilisé pour ouvrir la connexion d'un participant.

API Input

Paramètre	Objet
Attributs de contact	Carte des attributs de contact à transmettre au flux de contacts
Jeton client	. ] Identifiant unique défini par le client pour la demande
ID de flux de contacts	ID du flux de contacts à initialiser
ID d'instance	ID de l'instance Amazon Connect

API Output

Paramètre [19659015] Objet
Identifiant du contact	Identifiant du contact pour ce contact
Identifiant du participant	Identifiant de ce participant
Jeton de participant	Jeton pour appeler d'autres API au nom du participant

. 19659034] Service Amazon Connect Participant

CreateParticipantConnection
Crée une connexion pour un participant au chat. Retourne un WebSocket auquel doit être abonné pour pour les messages entrants.

API Input

Paramètre	Objet
Jeton du participant (en-tête) [1965917]. jeton de StartChatContact

API Output

Paramètre	Objet
WebSocket	L'URL du WebSocket recevait les messages entrants

[19659000] GetTranscript
Obtient l'historique de la conversation pour le contact.

API Input

Paramètre	Objet
ID du contact	ID du contact renvoyé par StartChatContact . 19659018] Paramètres de lot	Ensemble de paramètres (résultats maximaux, sens de balayage, ordre de tri, position de départ) pour déterminer les messages renvoyés
Jeton de connexion (en-tête)	Jeton renvoyé par CreateParticipantConnection

API Sortie [19659060] Paramètre

Objet Transcr. ipt Historique des conversations du contact

SendMessage
Envoie un message de discussion, c'est-à-dire un message du client à Connect.

API Input

Paramètre	. ] Objet
Jeton client	Identificateur défini au cours de StartChatContact
Contenu	Le texte du message
Type de contenu	Type de contenu du message, défini sur 'text / plain'
Jeton de connexion (en-tête)	Jeton renvoyé par CreateParticipantConnection

Nous pouvons utiliser ces appels d'API pour envoyer des discussions, en recevoir, et obtenir l'historique des conversations. . Regardez le schéma suivant pour voir comment.

1. Démarrer une session de discussion avec StartChatContact
2. Créez une connexion pour recevoir des messages avec CreateParticipantConnection qui retourne le chat WebSocket
3. Obtenir l'historique de la conversation avec GetTranscript
4. Recevoir des chats via le chat Web Socket renvoyé par CreateParticipantConnection
5. Envoyer des chats avec SendMessage

Et c'est tout!

Vous pouvez maintenant envoyer et recevoir des discussions à partir d'un widget de discussion, ainsi que consulter l'historique des conversations. Ensuite, vous pouvez créer l'interface utilisateur du widget de discussion. Pour voir un exemple d'interface utilisateur et d'implémentation, consultez l'exemple Amazon référencé ci-dessous:

Vous avez peut-être remarqué que rien de ce dont nous avons discuté n'est spécifique au widget de chat. Vous pouvez utiliser les appels d'API ci-dessus pour développer une intégration pour toute plate-forme basée sur un message. Bonne chance à construire!

Références

Consultez la documentation AWS pour en savoir plus sur les nouvelles API et intégrations de chat.

Consultez également l'exemple de chat d'Amazon . widget pour plus d'échantillons de code.

Et voici la documentation de l'API nécessaire pour une plongée plus approfondie.

Service Amazon Connect

Service Amazon Connect Participant

API de flux