> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.crisp.chat/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# 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.

---

# ${color}[#0080dd](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**](https://app.crisp.chat) in **Settings → Website Settings → Advanced Configuration → Webhooks**
* **Plugin Hooks** → configured from a private or public plugin in the [Crisp Marketplace](https://marketplace.crisp.chat/)

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.

---

# ${color}[#0080dd](When to use each option)

#### ${color}[#445055](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.

#### ${color}[#445055](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.

---

# ${color}[#0080dd](Developer documentation)

| Read the [Web Hooks quickstart](https://docs.crisp.chat/guides/web-hooks/quickstart/) to configure your endpoint, compare Website Hooks and Plugin Hooks, and review the available event namespaces.