Awesome Open Source
Awesome Open Source

LiveChat Platform Docs

Netlify Status

Hello 👋!

This is the for all of the LiveChat Platform documentation. Our documents are written in the MDX format, so pay attention to our custom tags when contributing to the docs.

Who we are

Behind LiveChat, Inc. there is a team of passionate people building online customer service software with online chat, help desk software, chatbot, and web analytics capabilities.

With a suite of four products (LiveChat, ChatBot, HelpDesk, KnowledgeBase) and their powerful APIs, we power customer communication for 33,000 companies in 150 countries.

LiveChat Platform is a range of products and services that can be used to build a variety of communication tools for businesses. Our Developer Program and Marketplace create an open ecosystem for developers, partners, and customers.

Node version

We require node version 14.x.

Development

  1. Fetch the repository
  2. Run npm install
  3. Run npm run dev
  4. Open http://localhost:3000/docs

Production

We are using Netlify to serve the docs in production.

Important: master branch is automatically deployed to production.

You can simulate the production build process locally by running.

  1. Run npm run build
  2. Run npm start

Feature branch / Deploy Preview

In order to test your work before merging to master, Netlify provides Deploy Preview. When raising a PR, github will provide Netlify notifications with the Deploy Preview url.

Versioning

Currently, versioning for the Agent Chat API, Customer Chat API, and Configuration API is as follows:

Agent Chat API Customer Chat API Configuration API
stable 3.3 3.3 3.3
dev preview 3.4 3.4 3.4
legacy 3.1, 3.2 3.1, 3.2 2.0, 3.1, 3.2

This versioning is default for all articles which aren't grouped.

Grouping versions

You can create a different set of versions for your subcategories. If your article isn't using the default versioning, you can create a custom group of versions. In order to do that, you need to add your versions scheme into /src/contant/index.js e.g.

export const VERSIONS_GROUPS = {
  ...
  "foo": {
    STABLE_VERSION: "1.0",
    DEV_PREVIEW_VERSION: "2.0",
    ALL_VERSIONS: ["1.0", "2.0"]
  }

Then inside the subcategory root index.mdx file, you must specify the newly created group in the frontmatter section e.g.

---

weight: 30
...
versionGroup: "foo"

The last step is to add the versionGroup and the specified version inside your article. Please, also remember to add versionGroup to all the siblings (all documents within the same subcategory). You don't have to specify version for them, but versionGroup is required.

Adding a new version

Run this command to automatically create folders and files for a new version of the API documentation.

new e.g. npm run version -- --type=new --newVersion=3.5 --fromVersion=3.1 (create new version 3.5 based on files from 3.1)

Options:

  • --group: (default: DEFAULT), for chat widget use --group=chat-widget
  • --exclude: e.g. --exclude=agent-chat-api,customer-chat-api

Changing the stable version

Run this command to automatically change the stable version of the API documentation. All the necessary files and folders will be created, moved, and deleted.

make-stable e.g. npm run version -- --type=make-stable --newVersion=3.3 --exclude=customer-chat-api (make version 3.3 stable, current stable version will become legacy)

Options:

  • --group: (default: DEFAULT), for chat widget use --group=chat-widget
  • --exclude: e.g. --exclude=agent-chat-api,customer-chat-api

How to contribute

All contribution's welcome! Read how to do it.

Contact us


Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
Html (418,231
Api (21,927
Rest Api (8,073
Documentation (4,468
Chat (3,230
Docs (1,694
Integration (1,133
Related Projects