Concept

Conversations and channels

How your workspace's channels, conversations and messages fit together, and how test mode fits in.

People reach you through channels. Each person you talk to, on one of your addresses, has one conversation, and everything said is a message in it.

Inside a dashed workspace, three boxes left to right. Channels hold phone numbers, bindings for WhatsApp, Telegram and Discord, and mailboxes. Conversations are one sender with one person, have a controller, and are test or live. Messages are inbound or outbound with a status of queued, sent, delivered, read or failed.
Workspace, channels, conversations and messages.

Channels and what you connect to them

A channel is a way in: voice, sms, mms, whatsapp, telegram, discord or email. The thing people write to is an address on that channel:

  • a phone number for voice, SMS and MMS;
  • a Binding for WhatsApp, Telegram and Discord, which is one connected account or bot;
  • a mailbox for email.

You connect these under Channels in the dashboard, and choose which agent answers each one. See Channels.

Conversations

A conversation is the thread between one of your senders and one person. It belongs to one channel, has the person's address, and has a controller that says who answers. A WhatsApp conversation also tells you whether you may still reply.

Sending to someone who already has a conversation with that sender joins it; you do not create conversations yourself.

Messages

A message is inbound (a person wrote) or outbound (you sent). An outbound message moves from queued to sent, then delivered or read, or ends failed. Inbound ones are received.

One inbox

Every channel lands in the same place. Conversations in the dashboard lists them all, with a tab per channel, a Needs you view for anything waiting on a person, and the same events whichever channel a message came on. Calls appear there too, under Voice. See Conversations.

Test mode

A test key (vl_test_...) runs every check the API runs, but delivers to a simulated carrier at no cost and only to reserved test addresses. Test conversations are marked as tests, and their events carry "livemode": false. Nothing in test mode reaches a real person. See Test mode.

Next

On this page