# Setting up your connection

## Creating a connection

To create your connection, all you have to do is use the `/create` command, specifying your desired connection name, then press the Confirm button to confirm its creation. Make sure the name is correct before pressing confirm!

{% hint style="warning" %}
You can create a connection every 10 minutes, this is reduced to 1 minute for [patrons](https://www.patreon.com/soupcreations) 
{% endhint %}

### Connection name specifications

* Must be unique across Discord, you can't share the same name with someone else
* ~~Must be at least 2 characters in length (Ex: `c` is invalid)~~
* Must be at most 16 characters in length (Ex: `myfirstconnection` is invalid)
* Must be alphanumerical (Ex: `my-con` and `mycôn` are invalid)

### Example

![ ](https://569524371-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeX5pvJYI2SPSUPHkxu9p%2Fuploads%2FnRwkSiZQq1TviYO0cjbD%2Fimage.png?alt=media\&token=a62919d9-7cf3-4419-b473-cdd90c76c1f5)

## Selecting your connection

Each time you want to manage a different connection you will need to select it using `/select <name>` or specify it in the command.  If you did not select a connection, ComBot will select one for you instead, but this may not be the one you are looking for.

![](https://569524371-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeX5pvJYI2SPSUPHkxu9p%2Fuploads%2FDYTwt3VdLIEnVJwKTNST%2Fimage.png?alt=media\&token=ff99f0b3-316e-4efa-99cf-e3afffb33c2d)

## Connecting a channel

{% hint style="danger" %}
Make sure to [select the right connection](#undefined) before continuing, otherwise, you might be modifying the wrong connection.
{% endhint %}

Once you've got your [connection ready](#creating-the-connection) you can connect a channel to it! This will create a webhook in that channel which will allow messages to look realistic. The bot needs `Manage Webhooks` permissions for this next step.

{% hint style="info" %}
You probably have to connect 2 channels for this to do what you expect it to do. Repeat the following steps twice!
{% endhint %}

To connect a channel we will use the `cb connect <#channel>` command. Make sure to replace `<#channel>` with a mention of the channel you wish to add/connect. You can mention a channel using #`<channel-name>`. You can also use its ID instead of a mention. [How to get a channel ID](https://support.discord.com/hc/en-us/articles/206346498-Where-can-I-find-my-User-Server-Message-ID).\ <mark style="color:red;">This command might take a few seconds to complete</mark>

### Examples

![Connecting #demo1](https://569524371-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeX5pvJYI2SPSUPHkxu9p%2Fuploads%2FZN97TYyXdGrvIPrLXJ93%2Fimage.png?alt=media\&token=ca07fa92-b8ad-4ac9-98a9-acb6f7175626) ![Connecting #demo2](https://569524371-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeX5pvJYI2SPSUPHkxu9p%2Fuploads%2FvcpxiwhaCO92n19MGU5h%2Fimage.png?alt=media\&token=e1b45f12-cc4a-4514-ad64-9085e0d9c76b)

{% hint style="info" %}
These demo channels are in the support server! [Join us](https://discord.gg/VdT64GM) if you have any questions/suggestions or you just wanna chat!
{% endhint %}

## Congratulations!

You just set up your first connected channels! If you want to customize the chat, go to the next guide!

![](https://569524371-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FeX5pvJYI2SPSUPHkxu9p%2Fuploads%2F8FCnubw6WEZp1cEhXbWK%2Fimage.png?alt=media\&token=6ff6a7fc-834a-496c-89d9-d314879d0e44)