Skip to main content
Web Chat is in closed beta. Contact us at [email protected] to get access.
Build a two-way Web Chat in your React app. You supply the UI. Novu supplies conversation state, delivery, and the live socket.

Prerequisites

Complete channel setup first. Then you need:
  • Your application identifier from API Keys
  • A subscriber id for the signed-in person
  • The public agent identifier from the agent page in the dashboard
See Security for HMAC.

Install

@novu/react requires React 18 or later (^18.0.0 or ^19.0.0).
useWebChat reads the Novu client from context. Place NovuProvider above the chat.
NovuProvider authenticates the subscriber. useWebChat selects which agent to talk to.
Replace YOUR_* placeholders with values from API Keys and Subscribers in the dashboard.

Add Novu Web Chat to my React app

Open in Cursor

Send a message

Omit conversationId to start a new chat. The first successful send creates the conversation. See Chat UI for parts, retry, resume, and reconnect.

Next steps

Chat UI

Parts, retry, resume, cards, approvals, and reconnect.

useWebChat reference

Props, return value, callbacks, and message parts.

Channel setup

Link Web Chat on the agent. Turn on HMAC.

JavaScript SDK

Call loadWebChat(novu), then novu.webChat.conversation() in @novu/js.