# Connet to Custom Channel

Custom Channel can be used when you want to integrate Amity Bots to any API-based external. This allows Amity Bots to be connected to virtually any chat platform in the world, including Microsoft Team, Slack, WeChat, etc. 

To integrate a new Custom Channel, follow the following steps:

## **1. Prepare the Custom Endpoint for Challenge Responses**

Before you begin, it's essential to set up a custom endpoint on your side that can respond to challenges initiated by the Amity Bots. For a comprehensive understanding and details about this step, please refer to our **Challenge Webhook URL** documentation.

## **2. Create a Custom Channel in Amity Bots**

* Navigate to the **Channels** on the Amity Bots Platform.
* Choose the option to create a **Custom Channel**.
* You'll be prompted to input the following parameters:
  * **Channel Name**: A unique identifier for your custom channel.
  * **Webhook URL**: The URL where Amity Bots will send requests and receive responses.
  * **Channel ID**: A unique ID associated with your custom channel.
* Click **Create,** Amity Bots will send challenge request to your Webhook URL and verify whether a correct response is received. The channel is then created and added to your Channel page.

## **3. Establish Connection for Incoming Messages**

To ensure messages from your external channel are accurately directed into Amity Bots, you need to connect them. Detailed information about this procedure, including required parameters and request/response formats, can be found in our **Custom Inbox API** documentation.

## **4. Set up the Enrich Message Webhook**

The enrich message webhook allows Amity Bots to gather specific user details, enhancing the bot's understanding and personalization capabilities. Here's what you need to know:

* The **Enrich Webhook** is designed for your backend system to attach additional user information for the bots to utilize.
* This webhook gets triggered whenever Amity Bots receives a message from a new user. However, it won't be triggered again for the same user within a 10-minute interval.
* If the same user interacts with the bot after 10 minutes, the webhook activates again, ensuring the bot has the most up-to-date user information.
* For in-depth details, please consult the **Enrich Webhook URL** documentation.

## **5. Configure the Outgoing Message Webhook**

Lastly, to ensure messages from Amity Bots are correctly relayed to your custom channel:

* Establish a connection between the **Outgoing Message Webhook** from Amity Bots and your custom endpoint.
* For a thorough understanding of this webhook, its functionalities, and how to integrate it, please refer to the **Send Webhook URL** documentation.

By carefully following the above steps, you'll seamlessly integrate Amity Bots with your custom channels, ensuring an enhanced and personalized user experience.


---

# 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.amitysolutions.com/amity-solutions/amity-bots-platform/channels/connet-to-custom-channel.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.