> For the complete documentation index, see [llms.txt](https://docs.maiagent.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.maiagent.ai/maiagent-user-guide/en/build/choose-channel/web-chat/website.md).

# Connect a Conversation Platform: Website

Connect a website chat channel: create a Website channel, configure its name and Agent, auto-replies and login settings, and obtain the website embed code.

## <mark style="color:blue;">1. Open the Settings Page</mark> <a href="#navigate-to-settings" id="navigate-to-settings"></a>

### 1. Option 1: Add a Web Chat Channel <a href="#path-add-web-chat" id="path-add-web-chat"></a>

In the left menu, click “ <mark style="color:blue;">Customer Service Conversations > Chat Channels</mark> ”, click “<mark style="color:blue;">＋Connect Chat Channel</mark>” in the upper right, and select “ <mark style="color:blue;">Website</mark> ”.

<figure><img src="https://1360999650-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6v6TNkkOQVfRYfcNirHL%2Fuploads%2Fgit-blob-b363369406b30ab309948bb844041f929a0d865b%2Fwebsite-channel-list-add.png?alt=media" alt="Chat channel list with the Connect Chat Channel button in the upper right outlined in red"><figcaption><p>Chat channel list: click “Connect Chat Channel” in the upper right</p></figcaption></figure>

<figure><img src="https://1360999650-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6v6TNkkOQVfRYfcNirHL%2Fuploads%2Fgit-blob-8c14c3191ba03e76504cdd15fda7ba3e2491cabd%2Fwebsite-new-channel-select.png?alt=media" alt="The Select Platform step for connecting a chat channel, with Website outlined in red alongside LINE, Messenger, Instagram, and other platforms"><figcaption><p>“Select Platform” step: select Website</p></figcaption></figure>

### 2. Option 2: Access Channels Linked to an Agent <a href="#path-ai-agent-link-channel" id="path-ai-agent-link-channel"></a>

Go to <mark style="color:blue;">AI Features</mark> → <mark style="color:blue;">AI Assistants</mark> in the left sidebar, select the Agent you want to configure, and switch to the <mark style="color:blue;">Chat Channels</mark> tab. Find the website chat channel you want to adjust and click <mark style="color:blue;">Platform Settings</mark>.

<figure><img src="https://1360999650-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6v6TNkkOQVfRYfcNirHL%2Fuploads%2Fgit-blob-5e4cbe8c4ddea1cd989636458fe4d4b495d9b6d9%2Fai-agent-channel-platform-settings-prod.png?alt=media" alt="The Agent&#x27;s Chat Channels tab, with a Platform Settings button on each channel card"><figcaption><p>Click “Platform Settings” on the Agent's Chat Channels tab.</p></figcaption></figure>

When you finish configuring the channel, click <mark style="color:blue;">Back to AI Assistant Settings</mark> at the top of the page to return to the original Agent's <mark style="color:blue;">Chat Channels</mark> tab. This return link remains available when you switch between <mark style="color:blue;">Basic</mark>, <mark style="color:blue;">Quota</mark>, and <mark style="color:blue;">Auto-Reply Settings</mark>.

<figure><img src="https://1360999650-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6v6TNkkOQVfRYfcNirHL%2Fuploads%2Fgit-blob-23b4840e7805af70d9060e4db1f4166b1fc2020a%2Finbox-back-to-ai-agent-settings-prod.png?alt=media" alt="The button to return to Agent settings at the top of the chat channel settings page"><figcaption><p>After configuring the channel, return directly to the original Agent's settings page.</p></figcaption></figure>

{% hint style="info" %} <mark style="color:blue;">Back to AI Assistant Settings</mark> appears only when you enter from the Agent's <mark style="color:blue;">Chat Channels</mark> tab. If you enter directly from <mark style="color:blue;">Chat Channels</mark> in the left menu, the page retains its usual navigation.
{% endhint %}

#### Scenario: Return to the Agent After Adjusting Website Customer Service <a href="#scenario-return-to-agent" id="scenario-return-to-agent"></a>

A customer service manager needs to update website customer service settings for the “Product Inquiry Assistant.” She clicks <mark style="color:blue;">Platform Settings</mark> on this Agent's <mark style="color:blue;">Chat Channels</mark> tab. After making her changes, she clicks <mark style="color:blue;">Back to AI Assistant Settings</mark> to return to the same Agent's channel list and continue checking other customer service entry points, without having to find the Agent again in the Agent list.

### 3. Option 3: Use Chat Channel Actions <a href="#path-channel-management" id="path-channel-management"></a>

In “ <mark style="color:blue;">Customer Service Conversations > Chat Channels</mark> ” in the left sidebar, find the channel you want to configure and click the <mark style="color:blue;">Edit</mark> icon in that row's “ <mark style="color:blue;">Actions</mark> ” column to open its configuration.

<figure><img src="https://1360999650-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6v6TNkkOQVfRYfcNirHL%2Fuploads%2Fgit-blob-2c01ec9accadb8f7ca338ef2b14162e7bdbfbb8a%2Fwebsite-channel-list-actions.png?alt=media" alt="Chat channel list with the edit, analytics, and delete icons in the first row&#x27;s Actions column outlined in red"><figcaption><p>The first icon in the “Actions” column is “Edit”</p></figcaption></figure>

## <mark style="color:blue;">2. Basic Settings</mark> <a href="#basic-settings" id="basic-settings"></a>

Each of the five categories in the “General” group on the “Basic” tab has a dedicated page with detailed instructions:

### 1. General Settings <a href="#general-settings" id="general-settings"></a>

For the channel name, Agent, return URL, custom domain, allowed embed domains, public access URL, and three embedding methods, see [General Settings](https://docs.maiagent.ai/maiagent-user-guide/en/build/conversation-settings/platform-settings/basic-settings.md).

#### Allowed Embed Domains <a href="#allowed-embed-origins" id="allowed-embed-origins"></a>

For how the embed allowlist works, setup steps, and a checklist before enabling it, see [General Settings: Allowed Embed Domains](https://docs.maiagent.ai/maiagent-user-guide/en/build/conversation-settings/platform-settings/basic-settings.md#allowed-embed-origins).

### 2. Appearance Settings <a href="#appearance-settings" id="appearance-settings"></a>

For the logo, avatar, display settings, and light/dark theme colors, see [Appearance Settings](https://docs.maiagent.ai/maiagent-user-guide/en/build/conversation-settings/platform-settings/appearance-settings.md).

### 3. Feature Settings <a href="#feature-settings" id="feature-settings"></a>

For enabling the channel, allowing file uploads, document citations, OCR, question set option display modes, and AI perception settings, see [Feature Settings](https://docs.maiagent.ai/maiagent-user-guide/en/build/conversation-settings/platform-settings/function-settings.md). Configure the tool display mode in [Reply Loading Style](https://docs.maiagent.ai/maiagent-user-guide/en/build/conversation-settings/platform-settings/loading-display.md#narrative-tool-display).

### 4. Interaction Settings <a href="#interaction-settings" id="interaction-settings"></a>

For the greeting, conversation starter questions, including greeting options in the Agent context, conversation display settings, satisfaction surveys, and the quota exhaustion message, see [Interaction Settings](https://docs.maiagent.ai/maiagent-user-guide/en/build/conversation-settings/platform-settings/interaction-settings.md).

#### Include Greeting Options in the Agent Context <a href="#include-greeting-in-context" id="include-greeting-in-context"></a>

For behavior before and after enabling this option, use cases, and considerations, see [Interaction Settings: Include Greeting Options in the Agent Context](https://docs.maiagent.ai/maiagent-user-guide/en/build/conversation-settings/platform-settings/interaction-settings.md#include-greeting-in-context).

### 5. Login Settings <a href="#login-settings" id="login-settings"></a>

**Configure the SSO Login Source**

* MaiAgent currently supports SSO (Single Sign-On)through Keycloak integration.
* Switch sources using the “ <mark style="color:blue;">Login Source</mark> ” dropdown.
* After turning on “ <mark style="color:blue;">Enable Login</mark> ”, select an authentication method such as AD, MaiAgent, or Keycloak under “ <mark style="color:blue;">Login Source</mark> ”. For details on each method, see [Web Chat: Login Methods](https://docs.maiagent.ai/maiagent-user-guide/en/build/choose-channel/web-chat.md#login-methods).

<figure><img src="https://1360999650-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6v6TNkkOQVfRYfcNirHL%2Fuploads%2Fgit-blob-315142127e60be714106184a853579214e465358%2Fwebsite-login-source.png?alt=media" alt="Login settings with Enable Login turned on and the Login Source dropdown expanded to show AD, MaiAgent, and Keycloak"><figcaption><p>After turning on “Enable Login,” select an authentication method under “Login Source”</p></figcaption></figure>

**Chat Without Logging In from an Embedded Client**

If you embed Web Chat on your own website and users have already logged in to your website, turn on “ <mark style="color:blue;">Allow Embedded Clients to Chat via Source ID Without Login</mark> ” so they can start chatting directly. For setup and signature integration instructions, see [Chat Without Login Using a Contact's Source ID](https://docs.maiagent.ai/maiagent-user-guide/en/build/choose-channel/web-chat/source-id-access.md).

**Use the Keycloak Login Identity for Tool Calls**

When Keycloak is selected as the login source, turn on “ <mark style="color:blue;">Use Keycloak Login Identity for Tool Calls</mark> ” to automatically include the visitor's own Keycloak login credentials when the Agent calls MCP/API tools. For setup instructions and considerations, see [Use the Keycloak Login Identity for Tool Calls](https://docs.maiagent.ai/maiagent-user-guide/en/build/choose-channel/web-chat.md#keycloak-token-passthrough).

## <mark style="color:blue;">3. Auto-Reply Settings</mark> <a href="#auto-reply-settings" id="auto-reply-settings"></a>

Set the bot's reply schedule here.

* Click the toggle beside each day to choose which days of the week replies are enabled.
* Set a time slot: choose the start and end times.
* Add a time slot: if you need multiple time slots, click “ <mark style="color:blue;">+Add Time Slot</mark> ” and configure each one.
* When you finish, click <mark style="color:blue;">Update</mark> to save.

<figure><img src="https://1360999650-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6v6TNkkOQVfRYfcNirHL%2Fuploads%2Fgit-blob-573a60f91909a7ed0d8b9ad2abaa3fc28abc1033%2Fwebsite-auto-reply-settings.png?alt=media" alt="Auto-Reply Settings tab with a toggle, a 00:00 to 00:00 time slot, and Add Time Slot for each day from Monday to Sunday, and an Update button at the lower right"><figcaption><p>“Auto-Reply Settings” tab: configure the toggle and reply hours for each day</p></figcaption></figure>

Each chat channel has its own auto-reply schedule. Channels for messaging platforms such as LINE, Messenger, and Instagram also use this tab. New channels default to all-day auto-replies seven days a week, and the <mark style="color:blue;">Auto-Reply Hours</mark> column in the channel list displays “24-Hour Replies.”

### What Happens Outside Auto-Reply Hours <a href="#outside-auto-reply-hours" id="outside-auto-reply-hours"></a>

The schedule only determines whether AI replies automatically; customer service staff can reply at any time. For messages received outside these hours, if the conversation has no assigned staff member, is not queued for human support, and still has auto-replies enabled:

* **AI does not reply**: messages still appear in <mark style="color:blue;">All Conversations</mark>, but the Agent does not answer.
* **No human handoff or offline message**: human handoff is evaluated only when AI processes a message. Outside auto-reply hours, this evaluation does not run, so no staff member is automatically assigned and the <mark style="color:blue;">Offline Message</mark> in [Human Handoff Settings: Service Hours](https://docs.maiagent.ai/maiagent-user-guide/en/build/conversation-settings/human-handoff.md#service-hours) is not sent.
* **The conversation stays “Unassigned” until a staff member takes over**: the status bar displays “Outside AI Reply Hours・Awaiting Staff,” and the conversation list shows an icon indicating that staff action is needed (hover text: “Outside AI reply hours. AI will not reply; staff action is required.”). Staff can click <mark style="color:blue;">Take Over</mark> or <mark style="color:blue;">Assign Staff</mark>; see [Human Support Takeover and Replies: Unassigned Conversations](https://docs.maiagent.ai/maiagent-user-guide/en/serve/daily-operations/human-handoff-operations.md#unassigned-queue).

Conversations already assigned to a staff member remain assigned to that person when messages arrive outside these hours. Conversations queued for human support also stay in the queue and do not become “Unassigned.”

For example, a LINE channel is set to auto-reply on weekdays from 09:00–18:00. A customer messages on Saturday morning to ask about business hours. The Agent does not answer, and the conversation appears under <mark style="color:blue;">Unassigned</mark> with the status “Outside AI Reply Hours・Awaiting Staff.” The staff member on duty clicks <mark style="color:blue;">Take Over</mark> and replies. After 09:00 on Monday, the Agent replies to other new conversations as usual. For the conversation that staff have taken over, the Agent resumes replying only after staff click <mark style="color:blue;">Resolve</mark> or <mark style="color:blue;">Transfer Back to AI Agent</mark>.

{% hint style="info" %}
Conversations that call the Agent directly through the [API](https://docs.maiagent.ai/api) are not restricted by the auto-reply schedule.
{% endhint %}

### Scenario: Use Only Human Support with AI Disabled <a href="#human-only-mode" id="human-only-mode"></a>

To have customer service staff reply in MaiAgent while temporarily keeping AI from answering (for example, just after migrating from another customer service system), turn off the channel's auto-reply schedule for all seven days:

1. Open the channel's <mark style="color:blue;">Auto-Reply Settings</mark> tab.
2. Turn off the toggles for Monday through Sunday.
3. Click <mark style="color:blue;">Update</mark>.

If you have not created the channel yet, leave <mark style="color:blue;">AI Assistant</mark> unselected during creation, then turn off the schedule after creating it. This prevents AI from replying from the moment the channel is created (a LINE channel switches its Webhook as soon as it is created; see [Migrate from Another Management Console to MaiAgent](https://docs.maiagent.ai/maiagent-user-guide/en/build/choose-channel/line.md#migrate-from-other-line-service)).

After saving, the <mark style="color:blue;">Auto-Reply Hours</mark> column in the channel list displays “-”. All subsequent incoming messages are handled as described in [Outside Auto-Reply Hours](#outside-auto-reply-hours):

* **No automatic assignment**: each new conversation stays <mark style="color:blue;">Unassigned</mark>. Arrange for staff to check regularly and click <mark style="color:blue;">Take Over</mark> in the conversation before replying, or use <mark style="color:blue;">Assign Staff</mark> to assign it to a specific colleague.
* **The status bar displays “Outside AI Reply Hours・Awaiting Staff”**: this indicates that AI will not reply and someone needs to handle the conversation. It is not marked as being handled by AI.
* **To enable AI later**: return to <mark style="color:blue;">Auto-Reply Settings</mark>, enable the desired days and time slots, and click <mark style="color:blue;">Update</mark>. The channel must have an AI Assistant selected. The Agent replies to new conversations; conversations already taken over by staff remain their responsibility until they click <mark style="color:blue;">Resolve</mark> or <mark style="color:blue;">Transfer Back to AI Agent</mark> to hand them back to the Agent.

For example, a retail brand migrates its LINE Official Account to MaiAgent. While AI answers are still being refined, only staff should reply. When creating the LINE channel, the brand leaves AI Assistant unselected, then immediately turns off auto-reply hours for all seven days. Subsequent customer messages appear under <mark style="color:blue;">Unassigned</mark>, and staff click <mark style="color:blue;">Take Over</mark> before replying. Two weeks later, once AI configuration is complete, the brand selects an AI Assistant for the channel and enables weekday auto-reply hours. The Agent then replies to new conversations.

{% hint style="warning" %}
Auto-reply hours control only MaiAgent's AI. Native platform auto-replies, such as LINE Official Account auto-response messages and Meta Business Suite offline auto-replies, are unaffected. Disable them in the respective platform's management console; see [Receiving LINE Auto-Response Messages](https://docs.maiagent.ai/maiagent-user-guide/en/build/choose-channel/line.md#line-auto-response) and [FB Messenger: Customers Still Receive Automated Messages](https://docs.maiagent.ai/maiagent-user-guide/en/build/choose-channel/fb.md#faq-meta-auto-reply).
{% endhint %}

### Silently Skip Specific Phrases <a href="#silent-skip-phrases" id="silent-skip-phrases"></a>

You may want AI to leave certain customer messages completely unanswered so staff can handle them when they see them, such as “I have an issue that needs a real person.” Add these phrases to the <mark style="color:blue;">Silent Skip</mark> section at the bottom of the <mark style="color:blue;">Auto-Reply Settings</mark> tab. When a customer's message matches:

* **AI does not reply**, and no system notice is sent. The customer receives nothing.
* **Human handoff is not evaluated**, and no Credits are deducted.
* **The message remains in the conversation history**. In the internal conversation view, “Skipped by Rule” appears below the message, along with the match type and matched phrase.
* **The conversation remains in AI auto-reply mode**: the customer's next message follows the normal process, receiving a reply or being handed off to human support as appropriate.

This list is independent of <mark style="color:blue;">Enable Human Handoff</mark> and also applies to channels where human handoff is disabled.

<figure><img src="https://1360999650-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6v6TNkkOQVfRYfcNirHL%2Fuploads%2Fgit-blob-9e40d1d7bf5fb7374d7e0bc51e9bcc5e9113e35c%2Fconversation-skip-phrase-markers.png?alt=media" alt="In the internal conversation view, skipped customer messages are labeled “Skipped by Rule · Exact Match ‘I have an issue that needs a real person’” and “Skipped by Rule · Contains ‘talk to a person’”; a third message is labeled “Handoff Check Skipped” and receives an AI reply"><figcaption><p>Internal conversation view: the match type and matched phrase appear below skipped messages</p></figcaption></figure>

#### Scenario: Wait to Respond and Hand Off Only When the Customer Requests Human Service <a href="#silent-skip-scenario" id="silent-skip-scenario"></a>

A hotel uses LINE to assist guests and wants a two-step process: when a guest says “I have an issue that needs a real person,” AI should stay silent so staff can see the message internally. Only when the guest then says “I want human service” should the conversation be handed off to human support. The administrator adds “I have an issue that needs a real person” to <mark style="color:blue;">Silent Skip</mark> with an exact match, then writes “Transfer when the customer explicitly requests human service” in the role instructions under [Human Handoff Settings](https://docs.maiagent.ai/maiagent-user-guide/en/build/conversation-settings/human-handoff.md#transfer-conditions). When the guest sends the first phrase, no reply appears on LINE, and staff see “Skipped by Rule” on the message in <mark style="color:blue;">All Conversations</mark>. When the guest then sends “I want human service,” the conversation is transferred to staff according to the handoff conditions.

{% hint style="warning" %}
Do not write “Do not reply when you encounter a certain phrase” in the Agent's instructions. When AI follows this instruction, it generates an empty reply, and the platform sends the system notice “No response received from the LLM” instead, which the customer will see. Use Silent Skip to leave specific phrases unanswered.
{% endhint %}

#### Setup Steps <a href="#silent-skip-setup" id="silent-skip-setup"></a>

1. Open the channel's <mark style="color:blue;">Auto-Reply Settings</mark> tab and scroll down to the <mark style="color:blue;">Silent Skip</mark> section.
2. Click <mark style="color:blue;">Add Phrase</mark>, enter a phrase, and select the match type: <mark style="color:blue;">Exact Match</mark> or <mark style="color:blue;">Contains</mark>.
3. Click <mark style="color:blue;">Save</mark> in the lower right of the section. This button saves only the phrase list; use <mark style="color:blue;">Update</mark> to save the auto-reply schedule above.

<figure><img src="https://1360999650-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6v6TNkkOQVfRYfcNirHL%2Fuploads%2Fgit-blob-a374a6795608fcc79021183ba046e1249e9c307a%2Fchannels-silent-skip-phrases.png?alt=media" alt="Silent Skip section with Exact Match selected for the first phrase, ‘I have an issue that needs a real person,’ and Contains selected for the second, ‘talk to a person,’ with a short-phrase warning; Add Phrase and Save appear below"><figcaption><p>Silent Skip: select a match type for each phrase; a warning appears for short phrases</p></figcaption></figure>

#### Matching Rules <a href="#silent-skip-matching" id="silent-skip-matching"></a>

* **Exact Match**: the entire message must match the phrase.
* **Contains**: the message matches if it includes the phrase. A phrase shorter than 4 characters triggers the warning “This phrase is very short. Customers' ordinary questions may also contain it and be skipped,” but can still be saved.
* Matching ignores leading and trailing whitespace, full-width/half-width character differences, punctuation, and English letter case. For example, “I have an issue that needs a real person!” matches “I have an issue that needs a real person.” It does not recognize synonyms or typos, or convert between Traditional and Simplified Chinese.
* Only plain text messages are matched. Messages with images or files follow the normal process.
* Rules apply only to conversations in AI auto-reply mode. Conversations being handled by staff, queued for human support, or outside auto-reply hours follow the normal process and are not labeled.
* Up to 20 phrases are allowed, with a maximum of 100 characters each. Duplicate phrases are not allowed in the same list (phrases that differ only in punctuation also count as duplicates).
* Members without edit permission for this channel can only view the list.

Human Handoff Settings has a separate [Skip Handoff Check](https://docs.maiagent.ai/maiagent-user-guide/en/build/conversation-settings/human-handoff.md#skip-handoff-check) list that serves a different purpose: it only prevents phrases from triggering human handoff, while AI continues to reply normally. If the same phrase appears in both lists, AI neither replies nor transfers the conversation.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.maiagent.ai/maiagent-user-guide/en/build/choose-channel/web-chat/website.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
