# Channels

> Connect phone numbers, SMS, WhatsApp, Telegram, Discord and email, and choose which agent answers each one.

Source: https://docs.vlayers.ai/build/channels

Kind: How-to guide

## What you'll learn

How to connect the places people reach your agents, and how to choose the agent that answers each one. A channel is one way in (voice, SMS, WhatsApp, Telegram, Discord, email). An address is one number, bot, server or mailbox on a channel.

## The Channels page

Open **Channels** in the sidebar. You see:

- **Needs your attention** at the top, when an address has no agent or has a problem. Each line has a link (**Choose an agent** or **Open**).
- One card per channel you have set up, with a row per address. Each row shows **Answered by**, its status, and two buttons: **Manage** opens that address's conversations, **Configure** opens its settings.
- **Add a channel**: a tile for each channel you have not set up. Choose **Configure →** to start.
- A **Custom** tab next to **Built-in**, once you have a [custom channel](https://docs.vlayers.ai/developers/sdks/custom-channels).

To change who answers an address, pick another agent in **Answered by**. The change applies from the next conversation, and **Undo** puts the earlier agent back. The same choice is on the agent's **Channels** tab.

## Phone numbers

1. Under **Voice**, choose **Add number**, then **Buy a number**.
2. Choose the country (US or Canada), type an area code, and pick a number from the list.
3. Choose **Buy**. **This spends money.** The monthly price shows before you click; the first month is charged from your wallet now, then each month.
4. Set **Answered by** to an agent.

To use a number you already own with Twilio, choose **Bring your own Twilio number** instead and connect the account under [SMS registration](#sms). A number's page has **Test call**: enter your phone and choose **Call me** to place a real call to it. **Release** gives a number back; it cannot be recovered. See [Phone numbers](https://docs.vlayers.ai/build/numbers) for more.

## SMS

Texting from a US number needs a carrier registration. Open **SMS registration** (press Cmd+K and search for it).

1. Choose to connect Twilio and enter your **Account SID**, **API Key SID** and **API Key Secret**. VoiceLayer checks them and stores the secret. Connecting creates nothing on Twilio.
2. Open the connection and answer the registration screens about your business and your messages. Your answers are saved when you choose **Continue**.
3. On **Review**, choose to submit. **This sends your registration to the carriers**, and carrier fees may need an admin to approve them.

## WhatsApp

Choose **Configure →** on the WhatsApp tile. The setup opens Meta's sign-in dialog, where you choose or create your WhatsApp business account and phone number. When you return, choose the agent that answers and turn the channel on.

## Telegram

1. In Telegram, ask @BotFather to create a bot. It gives you a token that looks like `123456:ABC...`.
2. Choose **Configure →** on the Telegram tile, paste the token, and continue.
3. Choose the agent that answers and turn the channel on.

## Discord

1. In the Discord Developer Portal, create an application. Under **Bot**, choose **Reset Token** and copy it.
2. Choose **Configure →** on the Discord tile and paste the token.
3. Add the bot to your server (Developer Portal, **OAuth2**, **URL Generator**, scope `bot`), then continue.
4. VoiceLayer shows an address. In the Developer Portal, **General Information**, set **Interactions Endpoint URL** to it and save. Discord checks it.
5. Choose the agent that answers and turn the channel on.

## Email

Email is managed as settings, not a single connection. Press Cmd+K and open **Email**.

| Section | What it does |
|---|---|
| **Agent mailboxes** | **Add mailbox**: choose who answers it (one of your agents, or your connected app), the first part of the address, and which domain. A switch lets a person approve each message before it is sent. Each mailbox can be paused, resumed or released. |
| **Sending domains** | **Add domain**, then add the DNS records shown at your DNS host. The status reads **Waiting for your DNS records**, then **Verified**, or **Couldn't verify** if something is wrong. |
| **Business details for follow-up emails** | Your business name and a postal address you can receive mail at. |
| **Saved replies** | Replies your agent can send as written. |
| **Held mail** | Mail kept back from your agent. **Release to my agent** lets it read one message. |

Releasing a mailbox frees the address for anyone to claim; conversations already received stay where they are.

## Guided setup

Telegram, Discord, WhatsApp and similar channels share one guided setup. It shows the steps for that channel, one at a time, and waits when you need to do something elsewhere. You can leave and come back: an unfinished setup stays on the channel's page. **Remove unfinished setup** discards it. On a connected channel, **Disconnect** stops it (you confirm first).

## Custom channels

If a channel is not listed, you can write one in code and publish it. It appears on the **Custom** tab, where **Configure** connects it to your workspace and an agent. How to write one: [Custom channels](https://docs.vlayers.ai/developers/sdks/custom-channels).

## Common problems

| Problem | Fix |
|---|---|
| A row says it needs an agent | Pick one in **Answered by**. |
| Discord setup keeps waiting | Check the **Interactions Endpoint URL** is saved in the Developer Portal, then continue. |
| A domain stays on **Waiting for your DNS records** | Check the records at your DNS host match the table, and wait for DNS to update. |

## Next steps

- [Conversations](https://docs.vlayers.ai/build/conversations): Read and answer what arrives on each channel.
- [Phone numbers](https://docs.vlayers.ai/build/numbers): More on numbers and assigning them.
