Chatoshi Web SDK
The Chatoshi Web SDK is a small browser library that puts the Chatoshi chat on your website. It renders the chat inside an iframe it manages for you, so it works on any page: plain HTML, WordPress, React, you name it.
What is Chatoshi?
Chatoshi is an AI chat built for crypto users. Ask it about coins, market movements, or trading decisions, and it answers in a conversational interface you can drop into your own product.
Try it at chat.chatoshi.ai.
Display modes
| Mode | Usage | Peculiarities |
|---|---|---|
| default | Inline chat inside a container element on the page | Requires container; fills the element's box and stays visible; shows a splash screen while loading |
| popup | Floating button in a corner that opens a chat window | Window is 400×600 in the bottom-right corner by default; position and size configurable; supports a custom toggle button |
| drawer | Full-height side panel over a dimmed page | No built-in toggle: open it with chat.open(); resizable by default and the width is remembered; closes with the close button, an overlay click, or Escape |
| full | Full-screen chat that takes over the viewport | Visible immediately on init; no toggle button |
| core | Chat only, for embedding in your own layout | Strips the header, sidebar, and onboarding; can be embedded directly through an iframe URL |
Each mode is covered in detail in Display modes.
Quick start
Drop this into any HTML page:
<script src="https://aichat-sdk.chatoshi.ai/chatoshi-sdk.js"></script>
<script>
const chat = new Chatoshi({
partnerKey: 'your-partner-key',
mode: 'popup'
});
chat.on('app:ready', () => {
console.log('Chatoshi is ready');
});
</script>
That's it: a chat button appears in the corner of the page.
Where to go next
- Installation: add the SDK to your site and verify it works
- Configuration: every option, from modes to colors
- Display modes: pick the mode that fits your layout
- Event handling: react to messages and lifecycle events
- API reference: methods, events, and types