> For the complete documentation index, see [llms.txt](https://docs.combot.xyz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.combot.xyz/guides/setting-up-your-connection.md).

# 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

![ ](/files/yOXF4ADxp7NfolWuhAhJ)

## 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.

![](/files/turUIJXf7E38l4hGMCxA)

## 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](/files/ckXSpHRfhs3KtRPd1SS5) ![Connecting #demo2](/files/Wi9lVlWq4YAdNMxWamQI)

{% 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!

![](/files/Xs8tCU1hKmVkbxuxH51Q)