> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.chrisp.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 the RTM API

__This article explains when to use the Crisp RTM API for real-time integration events.__

The RTM API runs over WebSocket and lets integrations receive asynchronous events from Crisp. It is often used together with the REST API: REST performs actions, while RTM receives real-time events and acknowledgements.

---

# When to use the RTM API

Use the RTM API when your integration needs a live event stream, such as receiving new messages, tracking asynchronous confirmations, or reacting immediately to conversation changes.

__A common architecture is:__

* ****REST API**** → sends requests and changes Crisp data
* ****RTM API**** → receives real-time events and acknowledgements
* ****Web Hooks**** → provide a simpler HTTP alternative for many event-driven workflows

|| For most simple automations, Web Hooks are easier to operate. Use RTM when you specifically need a persistent real-time connection.

---

# Developer documentation

__Use these Developer Hub resources:__

* [RTM API quickstart](https://docs.crisp.chat/guides/rtm-api/quickstart/) → setup and authentication
* [RTM API reference](https://docs.crisp.chat/references/rtm-api/v1/) → endpoints, namespaces, scopes, and event details
* [Web Hooks quickstart](https://docs.crisp.chat/guides/web-hooks/quickstart/) → compare with HTTP-based event delivery