create-a-federated-rooms.md

Create federated rooms

{% hint style="danger" %} We don't support encrypted rooms yet. {% endhint %}

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, if any, or keep empty
• Create

{% hint style="info" %} Important:

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

Whenever your user is invited to participate in a federated room, if that room was created in an external server, you can see from which server (server name) the room is originally from. This helps the user to differentiate when there are multiple rooms with the same name but all from different servers.

Badge indicating from where the room is coming from (server name)

Creating a Direct Message 1:1

You can create a Direct Message with other federated users.

Create a federated DM with these steps:

• Start- by creating 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 users you want to send messages to 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

Creating a Direct Message 1:1 using slash command

To create a 1:1 Direct Message 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

Editing a federated room

Currently, we support name and topic editions after a room was created.

Deleting a federated room

We don't support federated room deletions at this point.

Invite links

They are not supported yet.