How-to guide

Channels

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

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.

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. 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 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.

SectionWhat it does
Agent mailboxesAdd 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 domainsAdd 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 emailsYour business name and a postal address you can receive mail at.
Saved repliesReplies your agent can send as written.
Held mailMail 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.

Common problems

ProblemFix
A row says it needs an agentPick one in Answered by.
Discord setup keeps waitingCheck the Interactions Endpoint URL is saved in the Developer Portal, then continue.
A domain stays on Waiting for your DNS recordsCheck the records at your DNS host match the table, and wait for DNS to update.

Next steps

On this page