diff --git a/CHANGELOG.md b/CHANGELOG.md index 3224920..24fd76e 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -3,6 +3,10 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). +## [1.2.1] - 2021-09-09 +### Changed + - Custom Chat Widget - readme updates + ## [1.2.0] - 2021-09-02 ### Added diff --git a/customChatWidget/README.md b/customChatWidget/README.md index 5af03ba..d37032a 100644 --- a/customChatWidget/README.md +++ b/customChatWidget/README.md @@ -1,119 +1,116 @@ -# Amazon connect chat library usage +# Custom Chat Widget Usage ## Description -This library can be used by customers to place a chat Button or Icon, chat form, and a chat widget at the bottom right of their website. When this library is imported, using a script tag in the customers web page, it will expose AmazonCustomChatWidget.ChatInterface.init method to the global window DOM object. This method can be invoked with various properties, to get the Amazon Connect Chat in the website. +Custom Chat Widget is a JavaScript library that enables you to place a Chat Button (or Icon), Chat Form, and Chat Widget at your website. When this library is imported, using `script` tag in a web page, it exposes `AmazonCustomChatWidget.ChatInterface.init()` method to the global `window` object. This method can be invoked with various properties, to get the Amazon Connect Chat in the website. -Customers who would like to use Amazon Connect Chat do not have to develop their chat widget from scratch, and worry about styling and positioning the chat widget with a chat form on their webpage. This plug-in takes care of styling and positioning the chat widget on your webpage with ease. On top of that, customers also have the flexibility to customize this library, if needed. +Custom Chat Widget library simplifies the process of embedding, styling, and positioning Chat widget, with Chat Form, on your web page. On top of that, you also have a flexibility to customize this library, according to your business requirements. -Below steps explain how Chat Widget works on a webpage +Below steps explain how Custom Chat Widget works on a web page -1. Customers have an option to have a button or an icon on their webpage. +1. To enable customers to start a new Chat on your web page, you could either use `ChatIcon` or `ChatButton`. - ![Chat Icon](customChatWidget/screenshots/ChatIcon.png) + Chat Icon: + ![ChatIcon](screenshots/ChatIcon.png) - ![Chat Button](customChatWidget/screenshots/chatButton.png) + Chat Button: + ![ChatButton](screenshots/chatButton.png) -2. When the icon or the button is clicked, a chat form will be presented to the users. The fields in this chat form are configurable +2. When `ChatIcon` (or `ChatButton`) is clicked, `ChatForm` is presented to the customer. The fields in `ChatForm` are customizable. - ![Chat Form](customChatWidget/screenshots/chatForm.png) + ![Chat Form](screenshots/chatForm.png) -3. When this form is submitted by the user, the Chat Widget opens (Widget) that connects with Amazon Connect, for self service, and/or transfer to a chat agent.. +3. When this form is submitted by the customer, Custom Chat Widget opens and starts a new Chat contact, for self service, and/or transfer to a chat agent. - ![Chat Widget](customChatWidget/screenshots/chatForm.png) + ![Chat Widget](screenshots/chatWidget.png) ## Prerequisites -- Amazon Connect instance ready to receive chats. +- Amazon Connect instance, ready to receive chats. + [Refer to : Enabling Chat in Existing Amazon Connect Contact Center section in this link](../README.md#enabling-chat-in-an-existing-amazon-connect-contact-center) - [Refer to : Enabling Chat in Existing Amazon Connect Contact Center section in this link](https://github.com/amazon-connect/chatPluginForWebpage/public/amazon-connect-chat-interface.js) +- An Amazon Connect Contact Flow, ready to receive chat contacts. + [Refer to this link on how to create a Contact Flow for Chat](https://docs.aws.amazon.com/connect/latest/adminguide/chat.html) -- An Amazon Connect Contact Flow ready to receive chats. - - [Refer to this link on how to create a contact flow for chat](https://docs.aws.amazon.com/connect/latest/adminguide/chat.html) - -- Amazon Connect Chat backend. Please use the below link to deploy the chat backend - - https://github.com/amazon-connect/amazon-connect-chat-ui-examples/tree/master/cloudformationTemplates/asyncCustomerChatUX +- Amazon Connect Chat backend. + [Refer to this link on how to deploy the Chat backend](../cloudformationTemplates/asyncCustomerChatUX/README.md) ## Usage -- Import `amazon-connect-chat-interface.js` and `ACChat.js` using script tag in your HTML. Please note that the order of this import is important. +- Import `amazon-connect-chat-interface.js` and `ACChat.js`, using `script` tag in your HTML. Please note that the order of this import is important. - [amazon-connect-chat-interface.js](https://github.com/amazon-connect/chatPluginForWebpage/public/amazon-connect-chat-interface.js) + [amazon-connect-chat-interface.js](public/amazon-connect-chat-interface.js) - [ACChat.js](https://github.com/amazon-connect/chatPluginForWebpage/public/ACChat.js) + [ACChat.js](public/ACChat.js) ```html ``` -- After ACChat.js is imported, it will expose AC.ChatInterface.init() method. This method can be invoked with certain properties, to place Amazon Connect Chat Widget on your website. +- Once `ACChat.js` is imported, it exposes `AmazonCustomChatWidget.ChatInterface.init()` method. This method can be invoked with certain properties, to place Custom Chat Widget on a web page. - Below description explains each of those properties - 1. containerId : Specify the html element ID where you would want to load the chat widget. Preferable to use the root ID# of the Body. - 2. initiationIcon: Can be 'icon' or 'button'. - 3. region: Specify the region where the API gateway was deployed. This property is used to access API gateway. - 4. name: Specify the name of the customer, this will be utilized during chat creation. This field is mandatory. It can have the below values: + 1. `containerId` : Specify a HTML Element ID, where Custom Chat Widget is going to be placed. Preferably, provide the root ID# of the document body. + 2. `initiationIcon`: Can be set as `icon` or `button`. + 3. `region`: Specify the region where Amazon API Gateway was deployed. + 4. `name`: Specify customer's name, which is passed during Chat initiation. This field is mandatory. It can have one of the below values: - A variable - A constant - - Refer to the form input field `Name` like this: "refer|inputFields|Name". + - Refer to the form input field `Name` like this: `refer|inputFields|Name`. - 5. username: Specify the username of the customer , this will will also be utilized during during chat creation. This field is mandatory. It can have the below values: + 5. `username`: Specify customer's username, which is passed during Chat initiation. This field is mandatory. It can have one of the below values: - A variable - A constant - - Refer to the input field `UserName` like this: "refer|inputFields|UserName". - - 6. apiGateway: Provide the API Gateway URL for your Amazon Connect Chat backend that was deployed using the Cloudformation template. + - Refer to the input field `UserName` like this: `refer|inputFields|UserName`. - "https://${apiId}.execute-api.${region}.amazonaws.com/Prod" + 6. `apiGateway`: Provide Amazon API Gateway URL for your Amazon Connect Chat backend, that was deployed using the Cloudformation template. (`https://${apiId}.execute-api.${region}.amazonaws.com/Prod`) - 7. Amazon Connect Contact Flow Id: Provide the contact flow ID and not the ARN. + 7. `contactFlowId`: Provide Amazon Connect Contact Flow ID (not full ARN). For example: If the Contact flow ARN : `arn:aws:connect::111111111111:instance/11111111-1111-1111-1111-1111111111/contact-flow/XXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXX`, then the contact flow ID will be `XXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXX`. - 8. Amazon Connect Instance Id: Provide your amazon connect instance ID and not the ARN. + 8. `instanceId`: Provide your Amazon Connect Instance ID (not full ARN). For example: If the Instance ARN : `arn:aws:connect::11111111111111:instance/XXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXX` , then the instance ID will be `XXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXX`. - 9. contactAttr: This is an object that can have keys and values. Basically these attributes will be sent to your contact flow during chat initiation. + 9. `contactAttr`: This is an object that can have keys and values. Basically, these attributes will be sent to your Contact Flow during chat initiation. - 10. preChatForm: This form can be used in identifying the customer, by collecting customer's information, like their name or email. These attributes can also be sent to the Amazon Connect Contact Flow, so we don't have to identify the customer again in the bot, and can just proceed with verification. This will help to reduce Average Handle Time (AHT). This field is not mandatory. If not provided, no chat form will be presented to the customer. + 10. `preChatForm`: This form can be used in identifying your customer, by collecting customer's information, like their name or email. These attributes can also be sent to Amazon Connect Contact Flow, so we don't have to identify the customer again in the bot, and can just proceed with verification. This helps to reduce Average Handle Time (AHT). This field is not mandatory. If not provided, no chat form will be presented to the customer. - - visible: This can set to true/false. - - inputFields: An array of objects. Each object has a name and a validation field. The name represents the label of the input field in the form and the validation field can be `required` or `notrequired`. + - `visible`: This can set to `true` or `false`. + - `inputFields`: An array of objects. Each object has `name` and `validation` field. The `name` represents the label of the input field in `ChatForm`, and the `validation` field can be set as `required` or `notrequired`. ```js preChatForm:{ visible: true, inputFields:[ { - name: "Name", - validation: "required" + name: "Name", + validation: "required" }, { - name: "UserName", - validation: "required" + name: "UserName", + validation: "required" }, { - name: "Email", - validation: "notrequired" + name: "Email", + validation: "notrequired" } ] } ``` - 11. primaryColor: Specify the color of the Icon/Button, form and the chat widget. + 11. `primaryColor`: Specify the color of `ChatIcon` or `ChatButton`, then `ChatForm` and `ChatWidget`. - 12. description: Specify the description that will be displayed in the chat widget. + 12. `description`: Specify the description that will be displayed in `ChatWidget`. -- Below is a simple example on how ACChat can be invoked in a html page: +- Below is a simple example on how `ACChat` can be invoked in a HTML page: - [ACChat.js](https://github.com/amazon-connect/chatPluginForWebpage/public/index.html) + [public/index.html](public/index.html) ```html @@ -129,20 +126,18 @@ Below steps explain how Chat Widget works on a webpage