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

# Channels

> Connect WhatsApp, Instagram, Telegram, RCS, a website chat widget, an AI voice widget or a phone line, and choose which agent answers on each.

A channel is a way customers reach you. Each channel points at an agent, normally the [front desk](https://agent-docs.magicwebs.ai/build/agents.md).

Open them from **Build → Channels**.

![The Channels page with connect buttons and the website chat channel](https://mintcdn.com/magicwebs/lXS3DuVdQz1WpiFT/images/console/channels.png?fit=max\&auto=format\&n=lXS3DuVdQz1WpiFT\&q=85\&s=fd6178734266d608efdb1067c8116fe3)

Filter by channel type, switch between grid and cards, and sort by last updated, most messages or name. Each card shows the channel's status, which agent answers, its number or handle, and message and customer counts.

> [!NOTE]
>
> Create at least one agent before connecting a channel.

## Website chat widget

The quickest channel to set up: live as soon as you paste one line onto your website.

**1. Choose Create Web Widget**

Give it a **Widget name** and leave **Agent that answers** on the front desk unless one agent should take everything.

**2. Choose how visitors give their details**

**In the chat**: the agent asks for a name and number. **Sign-in page first**: a short form before the chat opens.

**3. Style the button**

Pick the icon, colour, position (bottom left or right), size and animation (none, pulse, bounce, wiggle or breathe), the tooltip, a **Teaser bubble**, and whether it **opens by itself after** a number of seconds. The preview updates as you go.

**4. Add it to your website**

Copy the **Embed code** from the channel card and paste it before `</body>` on your site. Or share the **Direct link** or **QR code**. Later style changes reach your site within a few minutes; you don't need to paste anything again.

This is what visitors see:

![The Skyline Habitat website chat asking the visitor's name](https://mintcdn.com/magicwebs/lXS3DuVdQz1WpiFT/images/console/widget.png?fit=max\&auto=format\&n=lXS3DuVdQz1WpiFT\&q=85\&s=32d3a7a3befe6238cd8ce99b43c6a14b)

## WhatsApp

You need a number on the WhatsApp Business Platform (Meta), or through a BSP.

![Connect a WhatsApp number dialog](https://mintcdn.com/magicwebs/lXS3DuVdQz1WpiFT/images/console/channels-connect-whatsapp.png?fit=max\&auto=format\&n=lXS3DuVdQz1WpiFT\&q=85\&s=1a920c59d567ec655d79f13b30401149)

1. Choose **Connect WhatsApp**.
2. Fill in **Channel name**, **Agent that answers** (or *No agent — your team replies from the inbox*), **Phone number ID**, **Display number**, **WABA ID**, **Business ID** and **Access token**. Change **API base URL** only if you send through a BSP proxy.
3. Choose **Create channel**, then copy the channel's **Callback URL** into your Meta app under **WhatsApp → Configuration → Webhooks**.

A new WhatsApp channel starts paused until the callback is configured. Once it is live, the card shows a QR code and wa.me link for your number.

## Instagram

1. Choose **Connect Instagram**, name the channel and pick the agent.
2. Choose **Continue with Instagram** and sign in. Only business and creator accounts can be connected.
3. In the Instagram app, turn on **Settings → Messages and story replies → Connected tools → Allow access to messages**.

Replies go out within 24 hours of the customer's last message. Access renews automatically. Once connected, an **Instagram** section appears in the sidebar for [comment rules and moderation](https://agent-docs.magicwebs.ai/marketing/instagram.md).

## Telegram

Create a bot with **@BotFather**, choose **Connect Telegram** and paste the **Bot token**. Magic Agent connects the bot for you, so there is nothing else to set up. Only private chats are answered; groups are ignored.

## RCS

Choose **Connect RCS**, paste the token from your RCS provider with the **Sender number**, then set the channel's **Callback URL** as the inbound webhook with your provider.

## AI voice widget

A glowing sphere on your website that visitors tap to talk out loud, with no chat window. Choose **Create AI Voice Widget**, pick the agent, animation, position, size, colours, voice, greeting and captions, then paste the embed code. Your site must use https for the microphone to work.

## Phone line

Connect a Plivo number so callers talk to an agent. Choose **Connect Phone Line**, enter the number, agent, voice and greeting, then paste the **Answer URL** and **Hangup URL** into an XML application in Plivo (method POST) and assign it to the number.

## Manage a channel

* **Accept inbound messages**: switch a channel off and on.
* **Edit**: change the name, agent or appearance.
* **Rotate embed code** / **Rotate callback URL**: issue a new one. The old one stops working until you replace it.
* **Delete channel**: customers can no longer reach you there. Conversations already received are kept.

If a channel has delivery trouble, its card shows **Last delivery problem** with the reason.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.