|
1 | | -# Cognigy Webchat Widget (v3) |
| 1 | +# Cognigy Webchat (v3) |
2 | 2 |
|
3 | | -The `v3` branch contains a work-in-progress version of our next Webchat Widget and must not be used in production. We will announce our new Webchat Widget properly once it is ready. |
| 3 | +Webchat v3 is a significant upgrade from the previous Webchat 2 versions, featuring enhanced user interface, improved customization options, and a host of [new features](https://docs.cognigy.com/webchat/v3/features/#webchat-3-key-features) designed to provide a better user experience. |
| 4 | + |
| 5 | +## Documentation |
| 6 | + |
| 7 | +To get started using this newer version of Webchat on your website, you can refer to the [Documentation section](./docs/README.md) in this repository. For additional information, please consult the [Getting Started with Webchat v3](https://docs.cognigy.com/webchat/getting-started/) guide in our product documentation. |
| 8 | + |
| 9 | +Customizing your Webchat endpoint has been made easy with Webchat v3, as it offers a lot of new settings. Here you can find the [list of endpoint settings](./docs/embedding.md/#endpoint-settings). information on further styling customization can be found in the [guide on applying custom CSS to the Webchat](./docs/css-customization.md). |
| 10 | + |
| 11 | +## Building your Webchat |
| 12 | + |
| 13 | +You need an installed version of `Node.js` to build your Webchat. Clone this repository, then run `npm i` and `npm run bundle` within the root folder to install dependencies and create bundle files in `dist/`. |
| 14 | + |
| 15 | +## Development |
| 16 | + |
| 17 | +For development purposes, you can utilize `npm run dev`. This command spawns an HTTP server on port 8080, showcasing the current form of the webchat directly from the source code. It automatically reloads upon updating source files, simplifying the development process. |
| 18 | +It automatically reloads when you make changes, streamlining the development process. |
| 19 | + |
| 20 | +## Compatibility Builds |
| 21 | + |
| 22 | +The `npm run bundle` command generates bundle files for the Webchat itself and basic Webchat plugins. Additionally, it produces a second version of each bundle ending in `.legacy.js`. These builds maintain the same feature set as the regular ones but are converted into an older JavaScript standard, enhancing compatibility for older browsers that lack support for modern JavaScript features, such as Internet Explorer 11. When you run the command `npm run bundle`, it creates bundle files for the Webchat along with some basic Webchat plugins. This command also produces a second version of each bundle, which has `.legacy.js` at the end of its name. These builds have the same features as the regular ones but are converted into an older JavaScript standard. This enhances compatibility for older browsers that don't support modern JavaScript features, such as Internet Explorer 11. |
| 23 | + |
| 24 | +## Migration Guide |
| 25 | + |
| 26 | +If you are already using Webchat 2 and want to migrate to Webchat v3, please follow the [migration guide](https://docs.cognigy.com/webchat/migration/) here. |
| 27 | + |
| 28 | +## DEPRECATION WARNING FOR WEBCHAT v2 |
| 29 | + |
| 30 | +With the release of our Webchat v3, we are also announcing the deprecation of older versions of [Webchat (v2.X)](https://github.com/Cognigy/WebchatWidget). |
| 31 | + |
| 32 | +**End of Support: 31st January 2026** |
| 33 | + |
| 34 | +### What This Means for You: |
| 35 | +Effective immediately, there will be |
| 36 | +- No Further Feature Updates: We will no longer release feature updates for the deprecated Webchat versions. |
| 37 | +- No Bug Fixes: Issues reported in the deprecated versions will not be addressed. |
| 38 | +- Limited Support: Customer support for the deprecated versions will be significantly reduced and eventually unavailable after the end of support date. |
| 39 | +- Security Fixes: We will continue to provide security fixes until the end of the support date. |
0 commit comments