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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.combot.xyz/guides/setting-up-your-connection.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.