Chat SDK
Pre-built React components for embedding Healthie's chat experience — conversation list and message thread — directly into your own application.
Built by Core Engineering
The problem it solves
Building a native messaging experience from scratch means re-implementing conversation lists, real-time delivery, and message rendering that Healthie already has working in its own product. Without a pre-built component, every integration re-solves the same problem.
What's included
- TypeScript React component library (@healthie/chat on npm)
- ConversationList component — displays a user's active conversations
- Chat component — full message thread, sized to its parent container
- Real-time message delivery via ActionCable (WebSockets)
- Built on top of Apollo Client
How it works
Install @healthie/chat alongside Apollo Client, @rails/actioncable, and graphql-ruby-client (chat uses ActionCable for real-time delivery). Wrap your app in HealthieProvider with the authenticated user's ID, then render the ConversationList and Chat components wherever you want messaging to appear. In server-rendered frameworks like Next.js, the SDK's WebSocket usage requires a client-only rendering workaround.
The Chat SDK is a TypeScript React component library that lets developers embed Healthie's messaging experience directly into their own application. It's built for teams building patient- or provider-facing apps who want native chat without building conversation UI from scratch. The SDK includes a ConversationList component and a Chat component, which together display a user's active conversations and let them send and receive messages. Authentication isn't included in the SDK — developers implement their own login flow and pass the resulting user ID and token into the HealthieProvider.
