> For the complete documentation index, see [llms.txt](https://docs.notionapps.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.notionapps.com/video-tutorials/create-a-conversation-screen-for-team-messaging.md).

# Create a Conversation screen for team messaging

## Before you watch

**Outcome:** Build a simple app with one **Conversation** screen and a messaging channel so authenticated users can send messages to each other.

**Time:** about 2 minutes

**Docs (canonical):**

* [Conversation Screen](https://docs.notionapps.com/screens-and-components/types-of-screens/native-automation-and-operational-screen-guides/conversation-screen)
* [Messaging and Notifications](https://docs.notionapps.com/automation/messaging-and-notifications)

Watch the video for orientation, then finish the checklist below — UI chrome in videos may lag the current builder.

## Watch the tutorial

{% embed url="<https://4233028229-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5ZqDXcVVffWUqEIZVhmn%2Fuploads%2F1JP3eGGbEcXSd00r8zgL%2Fmessaging-conversation-tutorial.mp4?alt=media>" %}

If the embed does not play in your browser, open the file attachment or download the MP4:

[messaging-conversation-tutorial.mp4](https://4233028229-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5ZqDXcVVffWUqEIZVhmn%2Fuploads%2F1JP3eGGbEcXSd00r8zgL%2Fmessaging-conversation-tutorial.mp4?alt=media)

## What this video covers

This walkthrough shows the shortest path from a simple app to in-app chat:

1. Open a simple People-based app in the builder.
2. Go to **Automate → Messaging → Channels**.
3. Create a channel named `team-chat` for direct messages between app users.
4. Add a **Conversation** native screen from **+ New Screen**.
5. Configure the screen to listen to conversation threads and bind the `team-chat` channel.
6. **Publish** so users can message each other in the live app.

## Why Conversation + a channel

| Piece               | Role                                                                  |
| ------------------- | --------------------------------------------------------------------- |
| Messaging channel   | Names the message stream (`team-chat`) and controls visibility/topics |
| Conversation screen | The live chat UI: threads, contacts, reply composer, new chat         |
| Publish             | Turns builder draft into the live app experience                      |

Conversation is for back-and-forth communication between authenticated users (or workflow-aware threads). It is not a public comment wall and not a broadcast inbox — use Notification Center for announcements.

## Prerequisites

* Messaging Foundation enabled for the app (Automate → Messaging shows as available).
* A private (or authenticated) app with users is strongly recommended so people can start direct chats.
* Live publish permission for messaging so replies and new chats work after publish.

## After the video — checklist

1. Confirm the channel appears under **Messaging → Channels** as **active**.
2. Open the Conversation screen and set:
   * **Listen scope:** Conversation or message thread
   * **Messaging channel:** your channel (for example `team-chat`)
   * Screen title users will recognize (for example **Messages**)
3. Keep **Send reply** available; enable start-chat behavior when users should message each other directly.
4. Publish the app.
5. Sign in as two different users and verify one can start a chat / reply to the other.

## Related written guides

* [Conversation Screen](https://docs.notionapps.com/screens-and-components/types-of-screens/native-automation-and-operational-screen-guides/conversation-screen)
* [Create a Messaging Route](https://docs.notionapps.com/video-tutorials/create-a-messaging-route-video)
* [Private apps](https://docs.notionapps.com/users/private-apps)