Perform automated actions with the chatbox
How can I open the chatbox on click on a custom button?
The Crisp chatbox can be opened and closed via your website JavaScript code. This allows you to create custom "Chat with us" buttons on your website, and trigger the Crisp chatbox to open when a visitor clicks on such buttons. You can use the following JavaScript code to open the Crisp chatbox: You can call it directly when an user clicks on a button:PopularHow can I automatically set user emails?
If you are using Crisp on a website where users are authenticated, you may want to set their email so that they don't have to specify it when they start a chat with you. This method uses the Crisp JavaScript API, that you can call from your own code. Given that you know the authenticated user's email from your code, you'll be able to set it for the Crisp chatbox. Here's how you would proceed to set the visitor's email:PopularHow can I hide and show the chatbox?
The Crisp chatbox can be hidden and shown back via your website JavaScript code. This allows you to precisely control where you want your chatbox to be visible and where you don't want to. You can use the following JavaScript code to hide the Crisp chatbox: You can use the following JavaScript code to show back the Crisp chatbox: Those operations are specific to the page you call them from,PopularHow can I reset a Crisp session when a user logs out?
If you are using Crisp on a website where users are authenticated, you should reset their Crisp session This method uses the Crisp JavaScript API, that you can call from your own code. Here's how you would proceed to reset the Crisp Session:Few readersHow can I automatically set my user's phone number?
If you are using Crisp on a website where users are authenticated, you may want to set their phone number. This method uses the Crisp JavaScript API, that you can call from your own code.Few readersHow can I use Google Tag Manager (GTM) to monitor Crisp event in Google Analytics 4 (GA4)?
This article will explain how you can listen for your Crisp's user events by using Google Tag Manager, and how to track these events in the new Google Analytics 4. Table of Content Introduction I. Setting up Google Analytics 4 with Google Tag Manager II. Deploying Event Listeners with Google Tag Manager III. Collecting Events in Google AFew readersHow can I restore a chat session with a token?
If your website shows the chatbox for authenticated users only - in other words: users for which you have an internal identification value, such as an user ID, an email or a token - you may want to ensure that the Crisp chat session associated to that user stays the same, whatever the device he is on and whether your user clears his cookies or not. This ensures you get chats from the same user in the same Crisp session.Few readersHow do I use the $crisp chatbox SDK?
$crisp ("dollar-crisp") lets you control the Crisp chatbox from your JavaScript code. This lets you listen to Crisp events, as well as open, close the chatbox or do fancy stuff with the chatbox.Few readers
Integrate with Crisp from your backend
How can I send messages from my backend?
Most Crisp users interact with you from the chatbox, email or integrations. You may want to develop bots or automation systems, for which messages get sent from your own backend. First of all, you need to connect your backend to the Crisp APIs. Read this introduction article on how to do it. Once you are done, you will follow this integration process (explained in details below): Your backend can reach the Crisp REST API for seSome readersHow can I push a user event from my backend?
Crisp lets you push events from the Crisp chatbox. If, however, you'd like to push those events from your backend instead, there's a way to do it via the Crisp REST API. This article explains how to do so. First of all, you need to connect your backend to the Crisp APIs. Read this introduction article on how to do it. Once you are done, you will follow this integration process (explFew readersHow do I use the REST API?
The REST API is the backbone of Crisp. It is used by all Crisp apps to let operators send messages, access their CRM, and more. As an integration developer, you have access to almost all of the features Crisp apps enjoy.Few readersHow do I use Web Hooks?
WebHooks are an easy and convenient way to receive events from a Crisp website. They can be configured in a few clicks and do not require you to build an integration. WebHooks are typically used for automation purposes, e.g., automating a task with Zapier.Few readersHow do I use the RTM API?
The RTM API lets integrations receive real-time notifications of all events happening in Crisp websites it has access to. This can be used in pair with the REST API to eg. send a message through the REST API, and receive responses from the other party through the RTM API.Few readers
Install Crisp plugins on your website
How can I setup the Contact Form plugin?
The Contact Form plugin lets you create a contact form linked to your Crisp, which you can include on your website contact page. This guide goes through how to setup the Contact Form plugin on your website. It is designed to be included on your website contact page. It protects your Crisp Inbox against spam bots using a CAPTCHA ran by hCaptcha .Few readersHow can I setup the Ticket Center plugin?
The Ticket Center plugin lets you create a ticket dashboard linked to your Crisp, which you can include in your website. This guide goes through how to setup the Ticket Center on your website. It is designed to be included in authenticated areas of websites, eg. dashboards, where users are authenticated. Their email address must be known and verified.Few readersHow can I embed Crisp inside a single-page app?
Crisp provides a Web SDK that provides Typescript bindings for the Crisp chatbox. This method is preferred when including Crisp in a single-page apps using Frameworks such as Angular, VueJS, React, NuxtJS or NextJS. Getting started Installation npm install --save crisp-sdk-web Basic Implementation To add Crisp on your website, you will firsFew readersHow can I build Crisp plugins?
The Crisp platform is open for business! We allow any developer to extend its capabilities by building new plugins to add more features to Crisp apps, or connect Crisp with external platforms. It can even be your own platform, which you'd want to connect with Crisp.Few readers
Technical and legal information
Crisp chatbox Cookie & IP policy
The Crisp chatbox, that is running on the websites of our users, uses cookies. Cookies are solely used in accordance with the points below. Cookies are necessary for chatbox functionalities; they are neededPopularWhat is Crisp's compliance with SOC2?
Information security is a reason for concern for all organizations, including those that outsource key business operation to third-party vendors (e.g., SaaS, cloud-computing providers). Rightfully so, since mishandled data—especially by application and network security providers—can leave companies vulnerable to attacks, such as data theft, extortion and malware installation. At Crisp we consider security very seriously, everything has been detailed over this article (https://docs.crisp.chat/gFew readersHow can I whitelist Crisp servers?
Companies operating over filtered networks may need to whitelist our systems in order to be able to access Crisp. This ranges from the user agents we use to perform HTTP requests, our server IP addresses (inbound and outbound) and our domain names (useful for CSP policies).Few readers
Guides on common use-cases
How do I prevent elements from being tracked by MagicBrowse?
MagicBrowse is built with privacy in mind and inputs are automatically hidden. You want to hide some elements to be tracked? here is how to do this Edit your HTML Page We build a data-browsing-ignore you can add to prevent an elements from being tracked by MagicBrowse. Example : Then you can implement the data-browsing-ignore attributeFew readersHow do I Create a Conversation Inside Crisp from a Form on a Website?
Nowadays, using a form to capture customer or lead data is common. Especially on pages like contact page or landing pages. The thing is, these forms are, most of the time, sending the information to an inbox that is not shared. Here is how you can centralize the form's data inside Crisp. Making it easier for teams to answer and acknowledge customer or lead messages is one of the goals that Crisp is targeting. Through this article, we will show you the main steps to let you catch the form'Few readersHow to track the UTM source
This article covers how to track UTM data and submit it to your Crisp customer's profile. As explained on Wikipedia, UTM Parameters are five variants of URL parameters used by marketers to track the effectiveness of online marketing campaigns across traffic sources and publishing media. Here is an example: https://www.example.com/page?utmcontent=buffercf3b2&utmmedium=social&utmsource=facebook.com&utmcampaign=buffer In this case it could bFew readers
Connect Crisp with external platforms
How can I create an AI chatbot with Dialogflow?
In this tutorial, you will learn how to connect Dialogflow with Crisp to create an AI chatbot that leverages the power of our chatbot API. If you are a complete novice about Dialogflow platform or new to the Crisp API, no worries, everything will be explained. ➡️ Want to know more about Crisp Chatbot pricing and features? Click here: Crisp Chatbot Software ➡️ Want to know more about Crisp Chatbot API pricing and features? Click here: Crisp Chatbot API (httFew readersHow can I set Google Ads (Adwords) data on Crisp users profile?
This article explains how you can send Google Adwords data to Crisp users' profile. We will cover an example but regarding Google adwords developpers docs you will be able to set a wide variety of use case. Depending on the way you use Crisp, you should be able to build users events for marketing & sales teams. If you want to have a look at all the events that are built in Crisp, you should have a look here (httFew readersHow can I push a conversion to Google Ads from a Live Chat via Google Tag Manager?
This article explains how you can send Live chat's interactions to Google Ads and mark it as a conversion in your Google Ads account. This tutorial is done with the help of Google Tag Manager (GTM) We will cover a few examples but regarding Google Ads developper documentation, you'll be able to set a wide variety of use case. Depending on the way you use Crisp, you should be able to create events that will be flagged as conversions in Google Ads. If you want to have a deeper look at all theFew readersHow to leverage contact data in Crisp thanks to Google Tag Manager
In this article, we're going to see how you can use the DataLayer to activate some features as for example a chat support, that you can only display to a specific user base. For example, at Crisp, we could choose to only offer live chat support to users that are not under the Free plan. (which will never be the case, don't worry). Through this article, we will guide you on how you can take advantage of user attributes (also known as custom data or conversation data) to display the chatbox basFew readersHow can I send events from Crisp to Facebook Pixel?
This article explains how you can send Crisp's users events to Facebook using Facebook Pixel We will cover a few examples but regarding Facebook Pixel documentation you will be able to set a wide variety of use case. Depending on the way you use Crisp, you should be able to build users events for support, marketing & sales teams. If you want to have a look at all the events that areFew readers