> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chatsistant.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Human Support Escalation

As powerful as AI chatbots can be, sometimes human accountability and expertise is still needed. Chatsistant's
built-in human support escalation feature allows you or your collaborators to step in during any ongoing chat
session and take over the conversation.

## Set up Human Escalation

Go to **Customizations** tab. Under the "Settings" section, Click "Human Support Handover".

<Frame>
  <img src="https://mintcdn.com/chatsistant/yov5SpV13MsfHmGS/images/human-support-escalation-25.png?fit=max&auto=format&n=yov5SpV13MsfHmGS&q=85&s=f9bd59007e4f9fdd81bb19e329044385" width="1600" height="769" data-path="images/human-support-escalation-25.png" />
</Frame>

Toggle on "Enable Human Escalation". Then a number of configuration options should appear.

<Frame>
  <img src="https://mintcdn.com/chatsistant/yov5SpV13MsfHmGS/images/human-support-escalation-26.png?fit=max&auto=format&n=yov5SpV13MsfHmGS&q=85&s=d88e5a09ceb2187b2816ed39c0f8d000" width="1916" height="863" data-path="images/human-support-escalation-26.png" />
</Frame>

You can configure what the AI says when human escalation request is detected during the conversation, as well as
what shows up when a human agent takes over or leaves the chat. For more advanced use cases, you can even define
custom phrases or intents that the AI should be looking out for. If the AI responds with that phrase, your
human agents will receive a notification immediately.

To test your human support escalation setup, you'll need to generate a public link to the chatbot and access it
using another browser tab. **The built-in "Preview" tab does NOT support human escalation testing.**

Go to "Go Live" tab, click "Share". You may need to change your chatbot visibility settings temporarily
in order to generate the link.

<Frame>
  <img src="https://mintcdn.com/chatsistant/yov5SpV13MsfHmGS/images/human-support-escalation-27.png?fit=max&auto=format&n=yov5SpV13MsfHmGS&q=85&s=97a812a2f5fb8630327c7e9cd8335bdd" width="1915" height="864" data-path="images/human-support-escalation-27.png" />
</Frame>

Once you have the link, open a new browser tab and navigate to it. Do not close the original chatsistant tab.
You should be taken to the chatbot as a typical user. You can then test it by submitting queries requesting human support.

<Frame>
  <img src="https://mintcdn.com/chatsistant/yov5SpV13MsfHmGS/images/human-support-escalation-5.png?fit=max&auto=format&n=yov5SpV13MsfHmGS&q=85&s=78188a4bc1406f3feca3c634fb7c0d2e" width="1915" height="864" data-path="images/human-support-escalation-5.png" />
</Frame>

To take over as a human agent, head over to **Inbox** on the left navigation bar from your chatsistant browser tab. You should see an orange dot
next to the session requesting human support. Click it and you will be able to engage directly with the user. Simply start
typing a response in the chat input text box at the bottom of the chat log.

<Frame>
  <img src="https://mintcdn.com/chatsistant/yov5SpV13MsfHmGS/images/human-support-escalation-28.png?fit=max&auto=format&n=yov5SpV13MsfHmGS&q=85&s=ab505c22be9dffe7ad1b472a49619d57" width="1915" height="864" data-path="images/human-support-escalation-28.png" />
</Frame>

As soon as you send the first message, AI Supervisor and all AI Agents will be disabled. You can have a direct conversation with your
user for as long as you'd like. Once you are done, you can end the live chat session and put your user back on to the AI chatbot by clicking
"End Live Chat".

<Frame>
  <img src="https://mintcdn.com/chatsistant/yov5SpV13MsfHmGS/images/human-support-escalation-29.png?fit=max&auto=format&n=yov5SpV13MsfHmGS&q=85&s=44927799e5e7e6bc5fcde43df2e29d0d" width="1600" height="769" data-path="images/human-support-escalation-29.png" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/chatsistant/_PfgpPLIz_t18KMO/images/end-live-chat.png?fit=max&auto=format&n=_PfgpPLIz_t18KMO&q=85&s=7640a3450c958bc9236a4d137935772e" width="1600" height="769" data-path="images/end-live-chat.png" />
</Frame>

You may stay and continue to monitor the user's interaction with the chatbot as the AI regains control over response generation.

Depending on your use case, you may wish to fine tune the circumstances when the user should be redirected to a human agent. To do so, please
review our documentation on [Fine Tuning Agent Intents](fine-tuning-agent-intents).

## Updating Your Human Agent Avatar

Each user account can have a single human avatar. This avatar shows up when that human agent takes over the chat session. Since
Chatsistant supports multiple collaborators, many human agents can monitor the same chatbot and have their own avatars when responding
to a user.

To set up your own avatar, click the profile icon on the top right. You should see a dropdown menu:

<Frame>
  <img src="https://mintcdn.com/chatsistant/yov5SpV13MsfHmGS/images/human-support-escalation-30.png?fit=max&auto=format&n=yov5SpV13MsfHmGS&q=85&s=097168c2118640d187a8940c68aa9317" width="321" height="269" data-path="images/human-support-escalation-30.png" />
</Frame>

Next, click "Account", followed by the pencil icon next to the avatar picture. You will be asked to select a photo from your computer.

<Frame>
  <img src="https://mintcdn.com/chatsistant/yov5SpV13MsfHmGS/images/human-support-escalation-31.png?fit=max&auto=format&n=yov5SpV13MsfHmGS&q=85&s=05d1d8e699a9e6598b7cfd2441013064" width="810" height="832" data-path="images/human-support-escalation-31.png" />
</Frame>

## Enable Human Support Notifications

To receive alerts on human support requests, follow the steps below.

### Turn on Alert Modes

1. Go to **Customizations** tab on the left navigation bar.
2. Enable Human Escalation Notifications toggle - This ensures that notifications related to user support requests are activated.
3. Enable Notification Sound - Activate this option if you wish to receive an audible alert along with the notifications.

<Frame>
  <img src="https://mintcdn.com/chatsistant/yov5SpV13MsfHmGS/images/human-support-escalation-32.png?fit=max&auto=format&n=yov5SpV13MsfHmGS&q=85&s=72ee4391982dfc27d414bc3999df9b63" width="1249" height="827" data-path="images/human-support-escalation-32.png" />
</Frame>

### Browser Permissions

Each web browser manages permissions for notifications and sounds on a per-website basis. To ensure that you receive notifications
properly, you'll need to enable both permissions within your browser settings. To proceed forward:

1. Launch your browser where you will use [Chatsistant platform](https://app.chatsistant.com).
2. Enable your browser permissions by choosing option bellow:

<AccordionGroup>
  <Accordion icon="chrome" title="Google Chrome" iconType="duotone">
    <Steps>
      <Step title="Settings">
        Click on the button near url in the top-left corner, then select "Site
        settings".

        <Frame>
          <img src="https://mintcdn.com/chatsistant/cqQo3vlCWcOFuvWd/images/human-support-escalation-9.png?fit=max&auto=format&n=cqQo3vlCWcOFuvWd&q=85&s=2e7ae53ec3e91c0d772955e8aa667597" width="1600" height="769" data-path="images/human-support-escalation-9.png" />
        </Frame>
      </Step>

      <Step title="Enable permissions">
        Make sure that "Notifications" and "Sound" are set to Allow in
        "Permissions settings".

        <Frame>
          <img src="https://mintcdn.com/chatsistant/yov5SpV13MsfHmGS/images/human-support-escalation-10.png?fit=max&auto=format&n=yov5SpV13MsfHmGS&q=85&s=68ddec210e2678c475f67c74e9b1fc2c" width="1600" height="769" data-path="images/human-support-escalation-10.png" />
        </Frame>
      </Step>
    </Steps>
  </Accordion>
</AccordionGroup>
