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

---

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

---

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