> For the complete documentation index, see [llms.txt](https://wiki.staffplusplus.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.staffplusplus.org/features/reporting/chat-channels.md).

# Chat channels

Staff++ has the possibility to open chat channels linked to reports.

### Configuration

```yaml
reports-module:
  chatchannels:
      enabled: false
      open-on: IN_PROGRESS
      close-on: REJECTED;RESOLVED;DELETED
```

With the above configure when a report channel should be automatically opened and closed.\
In the default configuration the channel gets opened as soon as the report is picked up by a staff member. And the chat channel is closed automatically when the report gets resolved, rejected or deleted.

### Permissions

```yaml
chatchannels:
    join: "staff.chatchannels.join.report"
    leave: "staff.chatchannels.leave.report"
    open: "staff.chatchannels.open.report"
    close: "staff.chatchannels.close.report"
```

### Commands

| description                | Description                                                                                                            |
| -------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
| /rc \<reportId> \<message> | Send a message to a report channel                                                                                     |
| /join-channel \<channelId> | Join this chatchannel. You will see the messages send on this channel and will be able to send message to this channel |
| /leave-channel \<reportId> | Leave the chat channel                                                                                                 |
| /close-channel \<reportId> | The chat channel will be closed. This forces all players to leave the channel and the channel gets deleted             |

### GUI

There are 2 buttons on the report GUI that allow staff members to open/close/join/leave the chatchannel manually.

![](/files/JK8V4IqHtLhzCf701xD0)
