Complete Channel Reference

Wunderland agents can communicate across 37 messaging and social platforms through the unified Channel system. This page provides a complete reference for every supported platform, grouped by priority tier.

For the channel architecture, binding management, and gateway events, see the Messaging Channels guide.

Tier Overview

Tier	Platforms	Support Level
P0 Core	Telegram, WhatsApp, Discord, Slack, WebChat	First-class messaging, fully tested, production-ready
P0 Social	Twitter/X, Instagram, Reddit, YouTube	First-class social media channels
P1 Extended	Signal, iMessage, Google Chat, Microsoft Teams	Supported with tested adapters
P1 Social	Pinterest, TikTok	Extended social media channels
P2 Community	Matrix, Zalo, Email, SMS	Community-contributed, well-tested
P3 Experimental	Nostr, Twitch, LINE, Feishu/Lark, Mattermost, NextCloud Talk, Tlon (Urbit), IRC, Zalo Personal	Experimental, community adapters

P0 Core Platforms

Full-featured Telegram bot integration via the Bot API.

Property	Value
Platform ID	`telegram`
Required Secret	`TELEGRAM_BOT_TOKEN`
Capabilities	Text, images, files, inline keyboards, reply markup, typing indicators, group chats, message editing

Setup:

Message @BotFather on Telegram
Send /newbot and follow the prompts
Copy the bot token

wunderland channels add telegram --token "1234567890:ABCdef..."

WhatsApp integration via the Baileys library (WhatsApp Web protocol).

Property	Value
Platform ID	`whatsapp`
Required Secret	`WHATSAPP_SESSION_DATA`
Capabilities	Text, images, files, typing indicators, read receipts, group chats, reactions

Setup:

wunderland channels add whatsapp
# Scan the QR code with your WhatsApp mobile app

warning

WhatsApp does not provide an official bot API. This integration uses the WhatsApp Web protocol via Baileys. Use at your own risk and ensure compliance with WhatsApp's Terms of Service.

Discord

Discord bot integration via Discord.js.

Property	Value
Platform ID	`discord`
Required Secret	`DISCORD_BOT_TOKEN`
Capabilities	Text, embeds, files, reactions, threads, slash commands, typing indicators, voice channels (audio)

Setup:

Create an application at the Discord Developer Portal
Add a bot and enable the Message Content privileged intent
Generate an invite URL with Send Messages, Read Message History, Attach Files permissions

wunderland channels add discord --token "MTIzNDU2..."

Slack

Slack bot integration via Socket Mode (real-time) or webhooks.

Property	Value
Platform ID	`slack`
Required Secrets	`SLACK_BOT_TOKEN`, `SLACK_APP_TOKEN`, `SLACK_SIGNING_SECRET`
Capabilities	Text, blocks (rich formatting), files, threads, reactions, typing indicators, slash commands, interactive messages

Setup:

Create a Slack app at api.slack.com/apps
Enable Socket Mode and generate an app-level token
Add OAuth scopes: chat:write, channels:history, groups:history, im:history, files:read

wunderland channels add slack \
  --bot-token "xoxb-..." \
  --app-token "xapp-..." \
  --signing-secret "abc123..."

WebChat

Built-in web-based chat widget served by the Wunderland HTTP server.

Property	Value
Platform ID	`webchat`
Required Secrets	None (built-in)
Capabilities	Text, markdown rendering, file uploads, typing indicators, streaming responses

Setup:

WebChat is automatically available when you start the server:

wunderland start
# WebChat available at http://localhost:3777/chat

Twitter / X

Twitter/X API v2 integration — posts, threads, DMs, trending, analytics, scheduling.

Property	Value
Platform ID	`twitter`
Required Secrets	`TWITTER_BEARER_TOKEN`, `TWITTER_API_KEY`, `TWITTER_API_SECRET`, `TWITTER_ACCESS_TOKEN`, `TWITTER_ACCESS_SECRET`
Capabilities	Text, images, video, polls, threads, hashtags, engagement metrics, scheduling, content discovery
SDK	`twitter-api-v2`

Tools: twitter.post, twitter.reply, twitter.quote, twitter.like, twitter.retweet, twitter.search, twitter.trending, twitter.timeline, twitter.dm, twitter.analytics, twitter.schedule, twitter.thread

wunderland channels add twitter --bearer-token "AAA..."

Instagram

Instagram Graph API — posts, reels, stories, carousels, hashtags, analytics.

Property	Value
Platform ID	`instagram`
Required Secret	`INSTAGRAM_ACCESS_TOKEN`
Capabilities	Text, images, video, stories, reels, carousels, hashtags, DM automation, engagement metrics, content discovery
SDK	`axios` (Graph API)

Tools: instagram.post, instagram.reel, instagram.story, instagram.dm, instagram.like, instagram.comment, instagram.follow, instagram.hashtags, instagram.explore, instagram.analytics

wunderland channels add instagram --access-token "IGQV..."

Reddit API via snoowrap — posts, comments, voting, search, trending, inbox.

Property	Value
Platform ID	`reddit`
Required Secrets	`REDDIT_CLIENT_ID`, `REDDIT_CLIENT_SECRET`, `REDDIT_USERNAME`, `REDDIT_PASSWORD`
Capabilities	Text, rich text, images, video, polls, threads, voting, subreddits, engagement metrics, content discovery
SDK	`snoowrap`

Tools: reddit.post, reddit.comment, reddit.vote, reddit.search, reddit.trending, reddit.subscribe, reddit.inbox, reddit.analytics

wunderland channels add reddit --client-id "..." --client-secret "..."

YouTube

YouTube Data API v3 — video upload, Shorts, comments, search, trending, playlists, analytics.

Property	Value
Platform ID	`youtube`
Required Secret	`YOUTUBE_API_KEY`
Capabilities	Video upload, Shorts, comments, search, trending, playlists, analytics, scheduling
SDK	`googleapis`

Tools: youtube.upload, youtube.short, youtube.comment, youtube.search, youtube.trending, youtube.analytics, youtube.playlist, youtube.schedule

wunderland channels add youtube --api-key "AIza..."

Pinterest API v5 — pins, boards, search, trending, analytics, scheduling.

Property	Value
Platform ID	`pinterest`
Required Secret	`PINTEREST_ACCESS_TOKEN`
Capabilities	Images, video, carousels, hashtags, engagement metrics, content discovery, scheduling
SDK	`axios` (API v5)

Tools: pinterest.pin, pinterest.board, pinterest.search, pinterest.trending, pinterest.analytics, pinterest.schedule

wunderland channels add pinterest --access-token "pina_..."

TikTok

TikTok API for Business — video upload, trending, search, analytics, engagement.

Property	Value
Platform ID	`tiktok`
Required Secret	`TIKTOK_ACCESS_TOKEN`
Capabilities	Video upload, reels, hashtags, engagement metrics, content discovery
SDK	`axios` (API for Business)

Tools: tiktok.upload, tiktok.trending, tiktok.search, tiktok.analytics, tiktok.engage, tiktok.discover

wunderland channels add tiktok --access-token "act...."

P1 Extended Platforms

Signal

Signal messenger integration via signal-cli.

Property	Value
Platform ID	`signal`
Required Secret	`SIGNAL_PHONE_NUMBER`
Capabilities	Text, images, files, typing indicators, group chats, reactions, disappearing messages

Setup:

Install signal-cli: brew install signal-cli
Register a phone number:

signal-cli -u +1234567890 register
signal-cli -u +1234567890 verify 123456
wunderland channels add signal --phone "+1234567890"

iMessage

iMessage integration via BlueBubbles server (macOS only).

Property	Value
Platform ID	`imessage`
Required Secrets	`BLUEBUBBLES_SERVER_URL`, `BLUEBUBBLES_PASSWORD`
Capabilities	Text, images, files, tapbacks (reactions), typing indicators, read receipts, group chats

Setup:

Install BlueBubbles server on a Mac (requires macOS and an Apple ID with iMessage)
Configure the server URL and password

wunderland channels add imessage \
  --server-url "http://192.168.1.50:1234" \
  --password "your-password"

tip

BlueBubbles requires a Mac to be running continuously. Consider using a Mac Mini as a dedicated server.

Google Chat

Google Chat integration via a service account and the Google Chat API.

Property	Value
Platform ID	`google-chat`
Required Secret	`GOOGLE_CHAT_SERVICE_ACCOUNT`
Capabilities	Text, cards (rich formatting), threads, slash commands, typing indicators

Setup:

Create a Google Cloud project and enable the Chat API
Create a service account with Chat permissions
Download the JSON key

wunderland channels add google-chat \
  --service-account-file "/path/to/service-account.json"

Microsoft Teams

Teams bot integration via the Bot Framework.

Property	Value
Platform ID	`teams`
Required Secrets	`TEAMS_APP_ID`, `TEAMS_APP_PASSWORD`
Capabilities	Text, adaptive cards, files, typing indicators, threads, @mentions

Setup:

Register a bot in the Azure Bot Service
Configure the messaging endpoint to point to your Wunderland instance

wunderland channels add teams \
  --app-id "your-app-id" \
  --app-password "your-app-password"

P2 Community Platforms

Matrix

Matrix protocol integration via the Matrix Client-Server API.

Property	Value
Platform ID	`matrix`
Required Secrets	`MATRIX_HOMESERVER_URL`, `MATRIX_ACCESS_TOKEN`
Capabilities	Text, formatted messages (HTML), files, reactions, threads, E2EE rooms

Setup:

wunderland channels add matrix \
  --homeserver "https://matrix.org" \
  --access-token "syt_..."

Zalo

Zalo Official Account integration via the Zalo API.

Property	Value
Platform ID	`zalo`
Required Secrets	`ZALO_APP_ID`, `ZALO_SECRET_KEY`
Capabilities	Text, images, files, quick replies, rich messages

Setup:

Register a Zalo Official Account at oa.zalo.me
Create an app in the Zalo Developer Portal

wunderland channels add zalo \
  --app-id "your-app-id" \
  --secret-key "your-secret-key"

Email

Email integration via SMTP (outbound) and IMAP/webhook (inbound).

Property	Value
Platform ID	`email`
Required Secrets	`SMTP_HOST`, `SMTP_USER`, `SMTP_PASSWORD`
Capabilities	Text, HTML, attachments, CC/BCC, reply threading

Setup:

wunderland channels add email \
  --smtp-host "smtp.gmail.com" \
  --smtp-user "[email protected]" \
  --smtp-password "your-app-password"

tip

For Gmail, use an App Password rather than your account password.

SMS

SMS integration via Twilio.

Property	Value
Platform ID	`sms`
Required Secrets	`TWILIO_ACCOUNT_SID`, `TWILIO_AUTH_TOKEN`, `TWILIO_PHONE_NUMBER`
Capabilities	Text, MMS (images), delivery receipts

Setup:

Create a Twilio account and purchase a phone number

wunderland channels add sms \
  --account-sid "ACxxxxxxxx" \
  --auth-token "your-auth-token" \
  --phone-number "+15551234567"

P3 Experimental Platforms

info

P3 platforms are experimental and provided through community adapters. They may have limited functionality or require additional configuration. Contributions are welcome.

Nostr

Decentralized social protocol integration via NIP-04 encrypted direct messages.

Property	Value
Platform ID	`nostr`
Required Secrets	`NOSTR_PRIVATE_KEY`, `NOSTR_RELAY_URLS`
Capabilities	Text, encrypted DMs, public notes

Setup:

wunderland channels add nostr \
  --private-key "nsec1..." \
  --relay-urls "wss://relay.damus.io,wss://nos.lol"

Twitch

Twitch chat integration for live stream interaction.

Property	Value
Platform ID	`twitch`
Required Secrets	`TWITCH_OAUTH_TOKEN`, `TWITCH_CHANNEL_NAME`
Capabilities	Text, emotes, chat commands, whispers

Setup:

wunderland channels add twitch \
  --oauth-token "oauth:..." \
  --channel "yourchannel"

LINE

LINE Messaging API integration for the popular Asian messaging platform.

Property	Value
Platform ID	`line`
Required Secrets	`LINE_CHANNEL_ACCESS_TOKEN`, `LINE_CHANNEL_SECRET`
Capabilities	Text, images, stickers, quick replies, rich menus, flex messages

Setup:

Create a LINE Developers account and a Messaging API channel

wunderland channels add line \
  --channel-token "..." \
  --channel-secret "..."

Feishu / Lark

Feishu (Lark) bot integration for the enterprise collaboration platform.

Property	Value
Platform ID	`feishu`
Required Secrets	`FEISHU_APP_ID`, `FEISHU_APP_SECRET`, `FEISHU_VERIFICATION_TOKEN` (and `FEISHU_ENCRYPT_KEY` if event encryption is enabled)
Capabilities	Text, rich text, cards, files, group chats

Setup:

Create an app in the Feishu Open Platform

wunderland channels add feishu \
  --app-id "..." \
  --app-secret "..."

Mattermost

Self-hosted Mattermost integration via webhooks or bot accounts.

Property	Value
Platform ID	`mattermost`
Required Secrets	`MATTERMOST_URL`, `MATTERMOST_BOT_TOKEN`
Capabilities	Text, markdown, files, reactions, threads

Setup:

wunderland channels add mattermost \
  --url "https://mattermost.example.com" \
  --bot-token "..."

NextCloud Talk

NextCloud Talk integration for self-hosted communication.

Property	Value
Platform ID	`nextcloud-talk`
Required Secrets	`NEXTCLOUD_URL`, `NEXTCLOUD_TOKEN`
Capabilities	Text, files, reactions, polls

Setup:

wunderland channels add nextcloud-talk \
  --url "https://nextcloud.example.com" \
  --token "..."

Tlon (Urbit)

Tlon integration for the Urbit decentralized computing platform.

Property	Value
Platform ID	`tlon`
Required Secrets	`URBIT_URL`, `URBIT_CODE`
Capabilities	Text, channels, groups

Setup:

wunderland channels add tlon \
  --url "http://localhost:8080" \
  --code "+code"

IRC

IRC integration via TCP or TLS. Joins configured channels and normalizes inbound/outbound PRIVMSG into ChannelMessage.

Property	Value
Platform ID	`irc`
Required Secrets	`IRC_HOST`, `IRC_PORT`, `IRC_NICK`, `IRC_CHANNELS`
Capabilities	Text, group chats (channels)

Setup:

wunderland channels add irc
# Prompts for IRC_HOST/IRC_PORT/IRC_NICK/IRC_CHANNELS (and optional TLS/NickServ settings)

Zalo Personal

Zalo personal account messaging via zca-cli (unofficial). Use at your own risk and ensure compliance with Zalo’s Terms of Service.

Property	Value
Platform ID	`zalouser`
Required Secrets	None (requires `zca` installed + authenticated)
Capabilities	Text, group chats

Setup:

Install zca and authenticate: zca auth login
(Optional) Set ZCA_PROFILE to select a profile (defaults to default)
(Optional) Set ZCA_CLI_PATH if zca is not on PATH

wunderland channels add zalouser

Sandbox policy

Because this adapter executes a local binary, it requires CLI execution to be allowed by your runtime permission policy.

Channel Capabilities Matrix

Platform	Text	Images	Files	Typing	Reactions	Threads	Groups	Rich Format
Telegram	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Inline keyboards
WhatsApp	Yes	Yes	Yes	Yes	Yes	No	Yes	Limited
Discord	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Embeds
Slack	Yes	Yes	Yes	Yes	Yes	Yes	Yes	Blocks
WebChat	Yes	No	Yes	Yes	No	No	No	Markdown
Twitter/X	Yes	Yes	No	No	Yes	Yes	No	Polls, hashtags
Instagram	Yes	Yes	No	No	Yes	No	No	Stories, reels, carousels
Reddit	Yes	Yes	No	No	Yes	Yes	Yes	Polls, rich text
YouTube	No	No	Yes	No	Yes	Yes	No	Shorts, playlists
Pinterest	No	Yes	No	No	No	No	No	Carousels
TikTok	No	No	Yes	No	Yes	No	No	Hashtags
Signal	Yes	Yes	Yes	Yes	Yes	No	Yes	Limited
iMessage	Yes	Yes	Yes	Yes	Yes	No	Yes	Tapbacks
Google Chat	Yes	No	No	Yes	No	Yes	No	Cards
Teams	Yes	Yes	Yes	Yes	No	Yes	No	Adaptive cards
Matrix	Yes	Yes	Yes	No	Yes	Yes	Yes	HTML
Zalo	Yes	Yes	Yes	No	No	No	No	Quick replies
Email	Yes	No	Yes	No	No	Yes	No	HTML
SMS	Yes	Yes	No	No	No	No	No	MMS
Nostr	Yes	No	No	No	No	No	No	Encrypted DMs
Twitch	Yes	No	No	No	No	No	No	Emotes
LINE	Yes	Yes	No	No	No	No	Yes	Flex messages
Feishu	Yes	No	Yes	No	No	No	Yes	Cards
Mattermost	Yes	Yes	Yes	No	Yes	Yes	No	Markdown
NextCloud	Yes	No	Yes	No	Yes	No	No	Limited
Tlon	Yes	No	No	No	No	No	Yes	Limited
IRC	Yes	No	No	No	No	No	Yes	Plain text
Zalo Personal	Yes	No	No	No	No	No	Yes	Limited

Managing Channels via CLI

# List all configured channel bindings
wunderland channels

# Add a channel interactively
wunderland channels add

# Remove a channel binding
wunderland channels remove <binding-id>

# Test a channel
wunderland channels test <binding-id> --message "Hello from Wunderland!"

Messaging Channels -- architecture and gateway events
Extension Ecosystem -- channel adapters as extensions
CLI Reference -- wunderland channels command details

Tier Overview​

P0 Core Platforms​

Telegram​

WhatsApp​

Discord​

Slack​

WebChat​

P0 Social Platforms​

Twitter / X​

Instagram​

Reddit​

YouTube​

P1 Social Platforms​

Pinterest​

TikTok​

P1 Extended Platforms​

Signal​

iMessage​

Google Chat​

Microsoft Teams​

P2 Community Platforms​

Matrix​

Zalo​

Email​

SMS​

P3 Experimental Platforms​

Nostr​

Twitch​

LINE​

Feishu / Lark​

Mattermost​

NextCloud Talk​

Tlon (Urbit)​

IRC​

Zalo Personal​

Channel Capabilities Matrix​

Managing Channels via CLI​

Related​

Tier Overview

P0 Core Platforms

Telegram

WhatsApp

Discord

Slack

WebChat

P0 Social Platforms

Twitter / X

Instagram

Reddit

YouTube

P1 Social Platforms

Pinterest

TikTok

P1 Extended Platforms

Signal

iMessage

Google Chat

Microsoft Teams

P2 Community Platforms

Matrix

Zalo

Email

SMS

P3 Experimental Platforms

Nostr

Twitch

LINE

Feishu / Lark

Mattermost

NextCloud Talk

Tlon (Urbit)

IRC

Zalo Personal

Channel Capabilities Matrix

Managing Channels via CLI

Related