Divjoy

Create a Next.js app with Crisp

a dev guide by Divjoy ✨

About this guide

This development guide walks you through everything you need to do to build a high-quality Next.js app integrated with Crisp. Check out the tasks below to get started. To save time, you can also use our boilerplate, which gives you a complete React codebase with all of these tasks done for you. Okay, let's dive in!

Tasks

  • ⚛Setup your Next.js app

    Create a Next.js app using npx create-next-app and then run your project locally with the npm run dev command.
  • 💬Create a component that adds the Crisp script

    Create a custom Chat component that handles adding the Crisp script to the head of your web app. You'll want to render this component in your App component so that it's included on all pages. Internally this component should execute the Crisp chat script within a Next.js Script component so that it runs after Next.js hydrates the page.
  • 🙋Update Crisp with user data

    If using authentication then you'll want to update Crisp with the authenticated user's email and name. If you're utilizing an authentication hook, such as useAuth, to listen to the user's authentication state then you can simple fire off a useEffect whenever the user object changes. The effect should update the email and name fields using window.$crisp.push, as explained further in the Crisp docs. This method ensures that user data gets populated after signin as well as when the user changes their info within your app.

Get the code

You can get the code for this guide with our Next.js and Crisp Boilerplate. You'll get a complete Next.js codebase with Crisp integration, all the tasks listed above done for you, and a responsive multi-page template. It should save you about two weeks of development time.

127 downloads today

Related Guides