# Step 2: Create a Chat Room
An Amazon IVS chat room has configuration information associated with it (e.g., maximum message length).
The instructions in this section show you how to use the console or AWS CLI to set up chat rooms (including optional setup for reviewing messages and/or logging messages) and create rooms.
# Console Instructions for Creating an IVS Chat Room
These steps are divided into phases, starting with initial room setup and ending with final room creation.
Optionally, you can set up a room so messages are reviewed. For example, you can update message content or metadata, deny messages to prevent them from being sent, or let the original message through. This is covered in [Set Up to Review Room Messages (Optional)](#create-room-console-review-messages).
Also optionally, you can set up a room so that messages are logged. For example, if you have messages being sent to a chat room, you can log them to an Amazon S3 bucket, Amazon CloudWatch, or Amazon Kinesis Data Firehose. This is covered in [Set Up to Log Messages (Optional)](#create-room-console-log-messages).
## Initial Room Setup
1. Open the [Amazon IVS Chat console](https://console.aws.amazon.com/ivs/chat).
(You also can access the Amazon IVS console through the [AWS Management Console](https://console.aws.amazon.com/).)
1. From the navigation bar, use the **Select a Region** drop-down to choose a region. Your new room will be created in this region.
1. In the **Get started** box (top right), choose **Amazon IVS Chat Room**. The **Create room** window appears.
![\[Creating a Chat Room.\]](http://docs.aws.amazon.com/ivs/latest/ChatUserGuide/images/Chat_Create_Room.png)
1. Under **Setup**, optionally specify a **Room name**. Room names are not unique, but they provide a way for you to distinguish rooms other than the room ARN (Amazon Resource Name).
1. Under **Setup > Room configuration**, either accept the **Default configuration**, or select **Custom configuration **and then configure the **Maximum message length** and/or **Maximum message rate**.
1. If you want to review messages, continue with [Set Up to Review Room Messages (Optional)](#create-room-console-review-messages) below. Otherwise, skip that (i.e., accept **Message Review Handler > Disabled**) and proceed directly to [Final Room Creation](#create-room-console-final).
## Set Up to Review Room Messages (Optional)
1. Under **Message Review Handler**, select **Handle with AWS Lambda**. The **Message Review Handler** section expands to show additional options.
1. Configure the **Fallback result** to **Allow** or **Deny** the message if the handler does not return a valid response, encounters an error, or exceeds the timeout period.
1. Specify your existing **Lambda function** or use **Create Lambda function** to create a new function.
The lambda function must be in the same AWS account and the same AWS regions as the chat room. You should give the Amazon Chat SDK service permission to invoke your lambda resource. The resource-based policy will be automatically created for the lambda function you selected. For more information about permissions, see [Resource-Based Policy for Amazon IVS Chat](security-iam.md#security-chat-policy-examples).
## Set Up to Log Messages (Optional)
1. Under **Message logging**, select **Automatically log chat messages**. The **Message logging** section expands to show additional options. You can either add an existing logging configuration to this room or create a new logging configuration by selecting **Create logging configuration**.
1. If you choose an existing logging configuration, a dropdown menu appears and shows all logging configurations that you already created. Select one from the list and your chat messages automatically will log to this destination.
1. If you choose **Create logging configuration**, a modal window appears which allows you to create and customize a new logging configuration.
1. Optionally specify a **Logging configuration name**. Logging-configuration names, like room names, are not unique, but they provide a way for you to distinguish logging configurations other than the logging configuration ARN.
1. Under **Destination**, select **CloudWatch log group**, **Kinesis firehose delivery stream**, or **Amazon S3 bucket** to choose the destination for your logs.
1. Depending on your Destination, select the option to create a new or use an existing **CloudWatch log group**, **Kinesis firehose delivery stream**, or **Amazon S3 bucket**.
1. After reviewing, choose **Create** to create a new logging configuration with a unique ARN. This automatically attaches the new logging configuration to the chat room.
## Final Room Creation
1. After reviewing, choose **Create chat room** to create a new chat room with a unique ARN.
# CLI Instructions for Creating an IVS Chat Room
This document takes you through the steps involved in creating an Amazon IVS chat room using the AWS CLI.
## Creating a Chat Room
Creating a chat room with the AWS CLI is an advanced option and requires that you first download and configure the CLI on your machine. For details, see the [AWS Command Line Interface User Guide](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-welcome.html).
1. Run the chat `create-room` command and pass in an optional name:
```
aws ivschat create-room --name test-room
```
1. This returns a new chat room:
```
{
"arn": "arn:aws:ivschat:us-west-2:123456789012:room/g1H2I3j4k5L6",
"id": "string",
"createTime": "2021-06-07T14:26:05-07:00",
"maximumMessageLength": 200,
"maximumMessageRatePerSecond": 10,
"name": "test-room",
"tags": {},
"updateTime": "2021-06-07T14:26:05-07:00"
}
```
1. Note the `arn` field. You will need this to create a client token and connect to a chat room.
## Setting Up a Logging Configuration (Optional)
As with creating a chat room, setting up a logging configuration with the AWS CLI is an advanced option and requires that you first download and configure the CLI on your machine. For details, see the [AWS Command Line Interface User Guide](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-welcome.html).
1. Run the chat `create-logging-configuration` command and pass in an optional name and a destination configuration pointing to an Amazon S3 bucket by name. This Amazon S3 bucket must exist before creating the logging configuration. (For details on creating an Amazon S3 bucket, see [Amazon S3 Documentation](https://docs.aws.amazon.com/AmazonS3/latest/userguide/create-bucket-overview.html).)
```
aws ivschat create-logging-configuration \
--destination-configuration s3={bucketName=demo-logging-bucket} \
--name "test-logging-config"
```
1. This returns a new logging configuration:
```
{
"Arn": "arn:aws:ivschat:us-west-2:123456789012:logging-configuration/ABcdef34ghIJ",
"createTime": "2022-09-14T17:48:00.653000+00:00",
"destinationConfiguration": {
"s3": {"bucketName": "demo-logging-bucket"}
},
"id": "ABcdef34ghIJ",
"name": "test-logging-config",
"state": "ACTIVE",
"tags": {},
"updateTime": "2022-09-14T17:48:01.104000+00:00"
}
```
1. Note the `arn` field. You need this to attach the logging configuration to the chat room.
1. If you are creating a new chat room, run the `create-room` command and pass the logging-configuration `arn`:
```
aws ivschat create-room --name test-room \
--logging-configuration-identifiers \
"arn:aws:ivschat:us-west-2:123456789012:logging-configuration/ABcdef34ghIJ"
```
1. If you are updating an existing chat room, run the `update-room` command and pass the logging-configuration `arn`:
```
aws ivschat update-room --identifier \
"arn:aws:ivschat:us-west-2:12345689012:room/g1H2I3j4k5L6" \
--logging-configuration-identifiers \
"arn:aws:ivschat:us-west-2:123456789012:logging-configuration/ABcdef34ghIJ"
```