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

# Agent Channels

> Where an agent runs — web widget, email mailbox, Slack workspace, help center.

## What a channel is

A **channel** is a deployment of an agent. The same agent can run on multiple channels, or you can dedicate one agent per channel. Channels are where messages arrive; the agent is what handles them.

You configure channels at **AI Agents > \[Your Agent] > Channels**.

## Available channels

| Channel         | What it does                                                                                                                    |
| --------------- | ------------------------------------------------------------------------------------------------------------------------------- |
| **Chat Widget** | Embedded chat on your site/app via the script tag. Includes chat, voice, and Live Help modes.                                   |
| **Email**       | A mailbox the agent owns. Customers email it (or your forwarded support address) and the agent replies via real threaded email. |
| **Slack**       | The agent answers in mapped Slack channels in your team's workspace.                                                            |

Each channel card on the Channels tab links to that channel's editor.

## Chat Widget

This is the floating chat bubble customers see on your site. To configure:

1. **AI Agents > \[Your Agent] > Channels > Chat Widget**
2. Toggle which **modes** the widget exposes: chat, voice, Live Help (real-time video avatar).
3. Set greeting, suggested messages, and post-response actions in the **Configure** tab.
4. Style colors, trigger icon, and header avatar in the **Style** tab.

A single widget can show multiple agents using **page URL filters** or **visibility filters** — see [AI Agents Overview](/agents/overview) for routing patterns.

The widget itself is installed via the [Web Widget script tag](/web-widget/installation). Once installed, every page where the script loads serves the agent assigned to the chat widget channel for that org.

### Modes inside the widget

Modes determine what the user can do inside the widget:

| Mode          | UX                                                                                                                                                                                            |
| ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Chat**      | Standard text chat. Always available.                                                                                                                                                         |
| **Voice**     | Speech-to-text input + text-to-speech output via ElevenLabs. Configure voice on the agent's Configure tab.                                                                                    |
| **Live Help** | Real-time video avatar via HeyGen. The user sees and hears a streaming avatar. Configure avatar selection in the agent's Configure tab. See [Voice & Live Help](/agents/voice-and-live-help). |

Each mode can be turned on independently per agent. Customers see whichever modes you've enabled as buttons on the widget header.

## Email

Every workspace has at least one **inbound email address** (e.g. `acmecorp@haloagents-mail.com`). When a customer emails it (or you forward your support address into it), Halo creates a ticket and assigns it to the agent on the email channel.

To configure:

1. **AI Agents > \[Your Agent] > Channels > Email**
2. Pick the mailbox this agent owns. (Most workspaces have one mailbox; multi-mailbox setups can route different addresses to different agents.)
3. Enable **AI auto-reply** so the AI responds to incoming emails automatically.

Custom outbound domains, forwarding setup, sending settings, and reply behavior are configured workspace-wide at **Settings > Emails**. See:

* [Email Overview](/channels/email-overview)
* [Receiving Emails](/channels/receiving-emails)
* [Custom Sending Domain](/channels/custom-domain)
* [Sending Settings](/channels/sending-emails)

## Slack

Connect a Slack workspace and the agent answers in any channel you map.

To set up:

1. **AI Agents > \[Your Agent] > Channels > Slack**
2. Install the Halo Slack app for your workspace (one-time per org).
3. Map the channels where the agent should answer. The agent only responds in mapped channels — DMs are blocked by design.

The Slack agent uses the same instructions, knowledge, and skills as your other agents but adapts the tone for Slack's conversational style.

For the full Slack integration setup (notifications, channel ingestion, etc.), see [Slack Integration](/integrations/slack).

## Help Center channel

When you publish a help center, it includes an embedded chat widget. By default, this widget uses the org's default support agent, but you can assign a specific agent for help center chat:

* Go to your help center's settings and pick which agent answers help-center chat.
* Customize the greeting, suggested messages, and color in the help center's design tab.

The help center channel is conceptually the same as the web widget but scoped to your help center's URL. See [Help Center Overview](/help-center/overview).

## Multiple agents on one channel

When you have multiple agents that *could* answer on the same channel, Halo picks based on:

1. **Visibility filters** — user/company/page URL filters on each agent.
2. **Active status** — inactive agents are skipped.
3. **Default fallback** — the oldest active customer-facing agent.

Use this to set up sales-vs-support routing on the widget, region-specific agents, or product-specific agents.

## Where to go next

<CardGroup cols={2}>
  <Card title="Email Overview" icon="envelope" href="/channels/email-overview">
    Set up email forwarding and a custom sending domain.
  </Card>

  <Card title="Web Widget Installation" icon="window-maximize" href="/web-widget/installation">
    Install the chat widget on your site.
  </Card>

  <Card title="Slack Integration" icon="hashtag" href="/integrations/slack">
    Connect Slack and map agent channels.
  </Card>

  <Card title="Help Center" icon="book" href="/help-center/overview">
    Publish a help center with embedded chat.
  </Card>
</CardGroup>
