LogoMkSaaS Docs
LogoMkSaaS Docs
HomepageIntroductionGetting StartedEnvironment Setup
Configuration

Integrations

DatabaseAuthenticationEmailNewsletterStoragePaymentCreditsCron JobsAIAnalyticsNotificationCaptchaChatboxAffiliates

Customization

MetadataFontsThemesImagesi18nBlogDocsComponentsCustom PagesLanding PageUser Management

Codebase

CodebaseIDE SetupProject StructureFormatting & LintingUpdating the Codebase
X (Twitter)

Chatbox

Learn how to set up and use Crisp Chatbox in MkSaaS

MkSaaS supports integrating Crisp Chatbox for real-time website messaging, allowing users to leave feedback or contact support directly from your site.

Setup

  1. Create a Crisp account.
  2. Go to Crisp Dashboard > Settings > Workspace Settings > Setup & Integrations.
  3. Copy Website ID and paste it into .env file as NEXT_PUBLIC_CRISP_WEBSITE_ID.
.env
NEXT_PUBLIC_CRISP_WEBSITE_ID=your_crisp_website_id
  1. Set enableCrispChat to true in website.tsx config (default is false):
src/config/website.tsx
export const websiteConfig: WebsiteConfig = {
  features: {
    enableCrispChat: true,
  },
}

For more details, see the Crisp Documentation.

If you are setting up the environment, now you can go back to the Environment Setup guide and continue. The rest of this guide can be read later.

Environment Setup

Set up environment variables


Chatbox System Structure

crisp-chat.tsx
  • src/components/layout/crisp-chat.tsx: The Crisp chat integration component.

Usage

The Crisp chatbox is automatically loaded on your website when enableCrispChat is enabled and the environment variable is set.

No additional code is required to use the chatbox. Users will see a chat widget on all pages, allowing them to send messages or feedback.

If you want to customize or conditionally render the chatbox, you can import and use the component directly:

src/app/layout.tsx
import CrispChat from '@/components/layout/crisp-chat';

export default function RootLayout({ children }) {
  return (
    <html lang="en">
      <CrispChat />
      <body>{children}</body>
    </html>
  );
}

Reference

  • Crisp Official Website
  • How do I install Crisp Live Chat on Next.js?

Video Tutorial

Next Steps

Now that you have enabled the chatbox, you may want to explore these related integrations:

Email

Configure email services

Authentication

Configure user authentication

Analytics

Configure analytics

Storage

Configure storage

Table of Contents

Setup
Chatbox System Structure
Usage
Reference
Video Tutorial
Next Steps