---
title: "What is Raven"
space: "Raven"
url: "https://docs.frappe.io/raven/getting-started/what-is-raven"
updated: "2026-11-07"
---

Raven is a chat app that runs on your Frappe site. It uses the site's users and roles, and any document from any Frappe app can be part of a conversation. It runs in the browser and as an app on iPhone and Android.

<picture>
  <source srcset="/files/raven-dark-intro-hero.webp" media="(prefers-color-scheme: dark)">
  <img src="/files/raven-light-intro-hero.webp" alt="A channel in Raven, with the files shared in it on the right">
</picture>

## Concepts

### Workspaces

A workspace holds a group of people and their channels: a company, a team, an office or a group of customers. A site can have one workspace or many, and a person can be in several. [Read more](wiki:9becd98e729c).

### Channels

A channel is the conversation about one topic, team or project. Every channel belongs to a workspace. An open channel includes everyone in the workspace, a public channel can be joined by anyone in it, and a private channel is for the people an admin adds. [Read more](wiki:1246dc2c43fc).

### Direct messages

A direct message is a private conversation between two people. Direct messages are not part of any workspace, so you see them from every workspace. [Read more](wiki:b1e16cc45b3c).

### Threads

A thread is a side conversation on one message. Replies stay in the thread and do not crowd the channel. [Read more](wiki:161cb577529e).

### Messages

A message carries text, files, links, a poll or a document from one of your Frappe apps. Messages can be formatted, scheduled, saved, pinned and turned into reminders. [Read more](wiki:98eab59bff0a).

### Agents

An agent is a user that other systems post as: incoming webhooks, document notifications and your own code. [Read more](wiki:6e7bbec94d65).

### Roles

Three roles on the site set what a person can do: Raven User, Raven Admin and System Manager. Each workspace and each channel also has its own admins. [Read more](wiki:696848e65f3a).

## Raven and your Frappe apps

Raven shares the site's users, roles and documents with your other Frappe apps. A message can carry [any document](wiki:393f10e81cdf) as a card with the document's main fields, and people can [take workflow actions](wiki:ff28074cd1f7) on it from the chat. [Document notifications](wiki:14f564810d8c) post to a channel or a person when a document changes.

## Next steps

- [Get started](wiki:f19c2f5ba5c6)
- [Find your way around](wiki:50eb43daf2f9)
- [Keyboard shortcuts](wiki:d93b54617d4e)