create-a-federated-rooms.md

Create federated rooms

Creating a channel/group

You can create federated channels having both Rocket.Chat and other federated users.

To create a federated channel,

• Start by creating a channel within your Rocket.Chat workspace.
• Enable Federated.
• Add members (optional) and click Create. See invite-external-users-to-your-rocket.chat-server.md for the syntax to add users from other federated servers to your room.

{% hint style="info" %}

• Federated Channels can not be Encrypted, Read-Only, or Broadcasted for now.
• You cannot create Discussions within federated Channels. {% endhint %}

Whenever your user is invited to participate in a federated room created in an external server, the server name is displayed at the top of that room. This helps the user to differentiate when there are multiple rooms with the same name but all from different servers.

Creating a 1:1 Direct Message

You can create a Direct Message with other federated users in your workspace.

Create a federated DM with these steps:

• Create a 1:1 Direct Message
• Set the federated user you wish to message following the syntax to invite external users.

Creating a Multi-user Direct Message

Using Multi Direct Message, you can send Direct Messages to multiple users(federated or not) at once.

To create a federated Multi Direct Message:

• Create a Multi-user Direct Message
• Select the users to whom you want to send messages following the syntax to invite external users.

Slash commands

You can also use an available slash command to create and invite users for Direct Messages rooms. The general syntax for the available slash command is:

/federation dm @username:server.com

Where:

• /federation: The slash command itself.
• dm: The command you want to execute, dm is the only one available now.
• @username:server.com: The external user you want to invite, using the syntax to invite external users.

Creating a Multi-user Direct Message using slash command

To create Multi-user Direct Messages using slash commands, you need to open the message box in any channel and type the following command using the syntax to invite external users:

/federation dm @username1:server.com @username2:server2.com

Editing a federated room

Only the name and topic of a federated room can be edited after it is created.

Deleting a federated room

Deleting federated rooms are not supported for now.

{% hint style="warning" %} Federation does not support sending invite links for now. {% endhint %}