# Channels

Channels are communications applications that your virtual assistant can integrate with and open from within. For instance, if you're already using an application like MS Teams or Slack, you can integrate your virtual assistant as a feature within those applications.

Like **Integrations/Data Sources**, you add **Channels** to your tenant platform first, and then you can choose to add one of these channels to an application/bot within the tenant.

{% hint style="info" %}
The Markdown text format is supported only in Webchat, Webex, and Co-Pilot; other channels treat content as HTML. Therefore, LLM responses are formatted as HTML for all channels where the Markdown format is not supported.
{% endhint %}

### **To Add a Channel to Your Tenant:**

1. Navigate to **Settings > Channels**.
2. Click the **+ New Channel** button.

<div align="left"><figure><img src="https://3281977978-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvBFXjH9S1CAy9f5hzg5Q%2Fuploads%2FqxEOSChU1gygio4z16xx%2Fnew_tenant_channel.png?alt=media&#x26;token=5cd89feb-7102-4556-85bb-c0c71a215393" alt="" width="263"><figcaption></figcaption></figure></div>

3. Choose a channel from the icon list. In this example, we have chosen Webchat, which is the default channel for applications/bot created with the Aisera Gen AI platform.
4. Create a **Name** for your new channel, so you can identify it when you're creating applications/bots.&#x20;

<div align="left"><figure><img src="https://3281977978-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvBFXjH9S1CAy9f5hzg5Q%2Fuploads%2FzXmtE07JLnlhFWettcnh%2Fnew_tenant_channel2.png?alt=media&#x26;token=5bde469d-3b3f-4209-a723-7ff4708b2a07" alt="" width="432"><figcaption></figcaption></figure></div>

5. Modify the rest of the parameters as needed. Click **Next**.

<div align="left"><figure><img src="https://3281977978-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvBFXjH9S1CAy9f5hzg5Q%2Fuploads%2F8YWksvtwThzGITBY7me5%2Fnew_tenant_channel3.png?alt=media&#x26;token=47a63ef1-61f5-4b48-9e98-29f25f2593f6" alt="" width="431"><figcaption></figcaption></figure></div>

6. Choose an **Authentication Type** and parameters for login to your application/bot.

<div align="left"><figure><img src="https://3281977978-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvBFXjH9S1CAy9f5hzg5Q%2Fuploads%2FSdkHRY2KiNdqjcPiMW62%2Fnew_tenant_channel_allowlist.png?alt=media&#x26;token=11e10770-eb6a-4287-8a2e-7fa7139e3bcb" alt="" width="432"><figcaption></figcaption></figure></div>

7. Add any endpoints/domains that you want to allow to host your applications/bots. If you leave this field blank, applications/bots that are associated with this channel can be hosted on any domain.

### Channel API Token

Just after the channel is created, it will display a **Channel API Token** that will go away after a few questions. If you plan to use API calls with this channel, copy and paste the ID while it is displayed.

<figure><img src="https://3281977978-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvBFXjH9S1CAy9f5hzg5Q%2Fuploads%2F8BpuaPBJ9YHGgYIbovuv%2Ftoken.gif?alt=media&#x26;token=d8d4098b-9af3-42d2-9fda-8771721fff02" alt=""><figcaption></figcaption></figure>

If you don't copy the **Channel API Token** soon enough, you will have to create a different new channel to get a Channel API Token, since there is no way to retrieve the previously created channel.

See also: [**API Setup and Authorization**](https://docs.aisera.com/apis/apis/conversation-api-and-websocket/setup-and-authorization).

### **Channel Metadata Filters**

You may now specify metadata tags as key-value pairs during channel configuration for use in RAG searches. When a RAG search is invoked, the metadata tags are appended to the end of the user’s query, allowing different channels to return tailored results while still utilizing the same bot.

**To configure Metadata Filters:**

1. Navigate to **Settings > Channels** in the Aisera Admin UI.
2. Select the desired channel or create a new channel.
3. On the **Channel Details** page, select the **pencil icon** in the top right corner to begin editing the channel.
4. Select **Metadata Filters** in the **Edit Channel** window.
5. Click **+ Add Metadata Filter** to add a blank metadata filter. <br>

   <figure><img src="https://docs.aisera.com/~gitbook/image?url=https%3A%2F%2F2983236984-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FiZkLJr3EjXkd2tHYiQJP%252Fuploads%252FAF53QYrF4YzfPrW9n8S6%252Funknown.png%3Falt%3Dmedia%26token%3Db8a376f1-02c6-4e75-b338-5b9cb34896a9&#x26;width=300&#x26;dpr=3&#x26;quality=100&#x26;sign=ecfc24de&#x26;sv=2" alt=""><figcaption></figcaption></figure>
6. Input metadata filters and select **OK** to save changes to the channel.

## To associate a channel with an Application/Bot:

1. Navigate to **Settings > AiseraGPT** in the Aisera Admin UI.
2. Choose the application/bot that you want to associated with a channel.
3. On the application/bot **Details** page, scroll down to the **+ Add a Channel** button.

<div align="left"><figure><img src="https://3281977978-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvBFXjH9S1CAy9f5hzg5Q%2Fuploads%2FgnWAlsNXM0fevSG9q1IW%2Fadd_app_channel.png?alt=media&#x26;token=842be6e0-68e9-47f1-adb8-f8877208d102" alt=""><figcaption></figcaption></figure></div>

4. Follow the steps in the [**Add a Channel**](https://docs.aisera.com/aiseragpt/how-to-setup-aiseragpt/add-a-channel) section.

### **Webchat, Copilot, Webex, MS Teams and Slack Channels Support Markdown**

Markdown support is enabled by default for the Webchat, Webex, MS Teams, and Slack Channels. You can disable the Markdown default using you bot **Details** settings.

Therefore, **LLM Responses** are formatted as **HTML** for all channels where the Markdown format is not supported.

**To disable the Markdown Support:**\
\
**NOTE:** Ensure the channel is not open when editing the configuration.

1. Navigate to **Settings > AiseraGPT.**
2. Open an existing application or bot.
3. Choose the **pencil icon** to see the **Details** page for that bot.
4. Scroll down to the **Channel** section.
5. Double-click on the line of the Channel that you want to modify.
6. Uncheck the **Enable Markdown Syntax** field (while the channel is not open).

## Two Special Channels

Two of the supported channels require extra description.&#x20;

1. The AiseraGPT application (bot) comes with a default channel called [**Aisera Webchat**](https://docs.aisera.com/aisera-platform/channels/aisera-webchat) that serves as the bot UI.\
   \
   You can use this channel (and the JavaScript snippet that gets automatically generated for it) to embed your bot in your portal or web site.

<div align="left"><figure><img src="https://3281977978-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvBFXjH9S1CAy9f5hzg5Q%2Fuploads%2FD5SUPeuEhaH9Xj73tCR4%2Fwebchat_channel3.png?alt=media&#x26;token=468f15ee-43e9-4e33-bb7e-9a4b830b9da1" alt="" width="563"><figcaption></figcaption></figure></div>

2. Use the **API Channel** if you are creating your own UI or customizing another UI using the Aisera APIs.

<div align="left"><figure><img src="https://3281977978-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvBFXjH9S1CAy9f5hzg5Q%2Fuploads%2Fm2uVsE1EPw3fKs5NAycG%2Fuse_api_channel.png?alt=media&#x26;token=4143d0c1-77d9-4438-a656-cd2718e59657" alt="" width="375"><figcaption></figcaption></figure></div>

## Third Party Channels

The rest of the topics in this section contain step-by-step instructions that describe how to integrate channels with your Aisera platform.

<div align="left"><figure><img src="https://3281977978-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvBFXjH9S1CAy9f5hzg5Q%2Fuploads%2FO0XyNCf2ajl1oHP6Uah1%2Fchannels.png?alt=media&#x26;token=fa269b50-2dce-4efe-9dbe-7600d1064cbd" alt="" width="375"><figcaption></figcaption></figure></div>

## Channel ID

When you are viewing your Bot/Application **Details** page, you can see the **ID** for your Bot/Application in the top left corner of the window.&#x20;

<figure><img src="https://3281977978-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvBFXjH9S1CAy9f5hzg5Q%2Fuploads%2FHOxPhxTQA7szuqGqkQdf%2Frel_notes3.png?alt=media&#x26;token=d06cd231-7cab-489a-bde2-9d6bf24426e1" alt=""><figcaption><p>Application/Bot ID</p></figcaption></figure>

When you choose one of your **Channels** on the Bot/Application **Details** page, you will see the **Channel Details** page.&#x20;

<figure><img src="https://3281977978-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvBFXjH9S1CAy9f5hzg5Q%2Fuploads%2FbHuhLsucFBFPnoCwj4Yx%2Frel_notes4.png?alt=media&#x26;token=c418a761-4ddf-47a3-b583-539e97f68409" alt=""><figcaption><p>Channel ID on Channel Details Page</p></figcaption></figure>

This page now contains a **Channel ID**.&#x20;

## Application Messaging

For channels where the streaming is enabled, you can see the processing steps that the application performs during a request. The new messages provide details on the number of sources searched, the number of documents validated, and other relevant metrics.

You can see the the processing is performed in four steps:

1. The first step acknowledges the search of the user's query.
2. The second step presents the search results found from various sources.
3. The third step displays the results after validation of the search results.
4. The fourth step summarizes the validated information to produce the final answer.

The messages you see within the application resemble the following screenshot:

<div align="left"><figure><img src="https://3281977978-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvBFXjH9S1CAy9f5hzg5Q%2Fuploads%2FnTGzs4xwk7PnZhUpM3Zk%2Fimage.png?alt=media&#x26;token=d8fbc158-947b-40af-89b5-53374e53abe9" alt="" width="563"><figcaption></figcaption></figure></div>

See also: Workflows - [**Use Message Node for Markdown Variables with Copilot**](https://docs.aisera.com/aisera-platform/ai-automation-optimize-flow/ai-workflow-studio/building-workflows/use-message-node-for-markdown-variables-with-copilot)
