CognitionDesk LogoCognitionDesk
All packages
npm Packages

@cognitiondesk/widgetv1.9.0

Embeddable chat widget for vanilla JS and React. Also re-exports the client for backward compatibility.

View on npm backendUrl → api.cognitiondesk.com (default)

Install

Shell
npm install @cognitiondesk/widget

Peer dependencies: react (optional, ≥17, only for /react)

Quickstart

Run 2026-09-25 against api.cognitiondesk.com with a throwaway API key and assistant (both deleted after).

JavaScript
<script
  src="https://cdn.jsdelivr.net/npm/@cognitiondesk/widget@1/dist/widget.js"
  data-widget-id="YOUR_WIDGET_ID"
  data-api-key="YOUR_EMBED_KEY"
  async defer>
</script>

Manual init

JavaScript
<script src="https://cdn.jsdelivr.net/npm/@cognitiondesk/widget@1/dist/widget.js"></script>
<script>
  CognitionDesk.init({ apiKey: 'YOUR_EMBED_KEY', widgetId: 'YOUR_WIDGET_ID' });
</script>

React

JavaScript
import { CognitionDeskWidget } from '@cognitiondesk/widget/react';

export function Chat() {
  return (
    <CognitionDeskWidget
      apiKey="YOUR_EMBED_KEY"
      widgetId="YOUR_WIDGET_ID"
      position="bottom-right"
    />
  );
}

API

CognitionDesk.init(config) (script tag)Vanilla global, from the standalone jsDelivr build.
<CognitionDeskWidget /> (@cognitiondesk/widget/react)React component wrapper.
createCognitionDeskClient (re-export)Same client as @cognitiondesk/client, kept for backward compatibility — prefer installing @cognitiondesk/client directly for non-UI use.
@cognitiondesk/widget — CognitionDesk Docs