Articles on: Developers

How to use Webhooks

This article explains how Web Hooks help you receive real-time Crisp events on your own endpoint.


Web Hooks are useful when you want Crisp to notify another system whenever something happens in your workspace, for example when a visitor sends a message or a conversation changes. For developer-heavy integrations, start from the Developer Hub so you can pick the right hook type and event namespaces.



How Crisp Web Hooks work


Crisp sends Web Hooks as JSON payloads over HTTP POST. Instead of polling the REST API repeatedly, your endpoint receives an event when Crisp has something to report.


Crisp supports two Web Hook families:

  • Website Hooks → configured for one workspace from Crisp in Settings → Website Settings → Advanced Configuration → Webhooks
  • Plugin Hooks → configured from a private or public plugin in the Crisp Marketplace


Plugin Hooks are generally the best option for integrations that need reliability or distribution across multiple workspaces, as they support more event namespaces, retries, and signed payloads.



When to use each option


Use Website Hooks for simple internal automation


Website Hooks are the quickest way to connect a single Crisp workspace to your own endpoint, a no-code automation tool, or an internal system.


Use Plugin Hooks for production integrations


Plugin Hooks are designed for integrations built on top of the Crisp Marketplace. They are a better fit when your service is installed by multiple Crisp workspaces, or when you need stronger delivery and authentication guarantees.



Developer documentation


Read the Web Hooks quickstart to configure your endpoint, compare Website Hooks and Plugin Hooks, and review the available event namespaces.


Updated on: 03/05/2026

Was this article helpful?

Share your feedback

Cancel

Thank you!