Skip to content

Channel Matrix

Channels are messaging surfaces that route inbound messages to an assistant and send its replies back out. Wayland documents 25 of them, and every one has a setup flow in the desktop app under Settings > Channels. The catalog is organized into three tiers. Ten of the channels also have a Wayland Core CLI connector (a wcore-channel-* crate) so you can set them up from a Core channel config too.

  • Tier 1 is the mass-market set.
  • Tier 2 is the pro and regional set.
  • Tier 3 is the long tail. The desktop app provides a setup flow for each; treat these as set-up-able rather than battle-tested end to end.
  • Core CLI marks the channels that also ship a Wayland Core connector.

The required credentials below are the values you create on the provider side. The exact field names appear on each channel’s setup page. For step-by-step guides, see the channel pages under How-to.

The Channels panel in the desktop app, showing the Tier 1 channels each with a Set up button

ChannelIdCore CLIRequired credentials
TelegramtelegramYesBot token from BotFather
SlackslackYesBot token, app token or signing secret, app scopes
DiscorddiscordYesBot token, gateway intents
WhatsAppwhatsappYesPaired bridge session (QR), or Cloud API access token, phone number ID, app secret
SMS (Twilio)sms-twilioYesAccount SID, auth token, from-number or Messaging Service SID
SignalsignalYesRegistered or linked number through signal-cli
Email (AgentMail)email-agentmailYesAgentMail API key, inbox address
Email (IMAP/SMTP)email-imapYesIMAP and SMTP host, port, credentials
WebhookwebhookNoOutbound URL, outbound secret (Wayland exposes the inbound URL)
ChannelIdCore CLIRequired credentials
MatrixmatrixYesHomeserver URL, user ID, access token
MS Teamsms-teamsYesApp registration (app ID and app password)
iMessageimessageYes (macOS)macOS host signed in to iMessage, allowed handles
LINElineNoChannel access token, channel secret
Lark / FeishularkNoApp ID, app secret, event subscription
DingTalkdingtalkNoClient ID, client secret (optional webhook secret)
WeChatwechatNoQR-code login (no pasted credentials)
WeComwecomNoWebSocket: bot ID and secret; Webhook: corp ID, token, encoding AES key
ChannelIdCore CLIRequired credentials
MattermostmattermostNoBot access token, server URL, team ID
Google Chatgoogle-chatNoService account JSON, audience
Nextcloud Talknextcloud-talkNoServer URL, username, app password
IRCircNoServer and port, nick, channels
NostrnostrNoPrivate key (nsec), relays
TwitchtwitchNoOAuth token, bot username, channels
Synology Chatsynology-chatNoIncoming and outgoing webhook tokens
BlueBubblesbluebubblesNoBlueBubbles server URL and password

In the Wayland Core CLI, the channels that both receive messages and send replies through Core’s two-way inbound support are Telegram, Discord, Slack, WhatsApp, Matrix, MS Teams, and SMS. This note describes the Core CLI behavior; for desktop-only channels, follow each channel’s own page for how it receives and sends.

A freshly added channel shows as not connected. Once its credentials validate and the gateway starts, the card moves to connected.