Web Chat is in closed beta. Contact us at [email protected] to get access.
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
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.
- US
- EU
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
Send a message
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.