Setup & management

Messenger Channels

Setup and management

Review the shared card behavior for checking status, opening docs, and using Connect, Reconnect, and Disconnect in the current app UI.

Open channel setup

  1. 1

    Open Channels from the sidebar.

  2. 2

    Move to the card you want on the Messenger Channels screen.

  3. 3

    Use Connect for a first-time setup.

  4. 4

    For Telegram, Discord, Slack, and WhatsApp cards that already exist but are disconnected, use Reconnect.

  5. 5

    KakaoTalk and LINE return to Connect after disconnection, so you prepare a fresh code from the Connect flow again.

  6. 6

    Use the Guide button on the card or View Documentation inside a setup modal if you want the matching docs page.

Understand connection states

  • connected: the channel is currently active and usable.
  • connecting: the app is preparing or retrying the connection.
  • disconnected: config remains, but the live connection is not active.
  • error: the last validation or connection step failed.

What you can do directly from a card

  • The status dot on the card shows connected, connecting, disconnected, or error.
  • The Guide button on the card opens the public docs page for that channel.
  • The primary card button changes between Disconnect, Reconnect, or Connect based on the current state.
  • On configured cards, the overflow menu lets you update the agent binding and run the matching connection action.
  • KakaoTalk is currently single-account only.

Reconnect and disconnect

  • When a card is connected, its primary action becomes Disconnect. The app asks for a second click within 4 seconds before it actually disconnects.
  • Disconnected Telegram, Discord, Slack, and WhatsApp cards switch their primary action to Reconnect.
  • WhatsApp starts a fresh linked-device flow from Generate QR Code, and Refresh Code issues another QR after it appears.
  • KakaoTalk and LINE go back through Connect to prepare a fresh code again. If an older binding still exists, sending "연결해제" first is the safer reset path.

Shared notes

Each channel follows a different connection model

Telegram and Discord are token-based, Slack uses browser approval, WhatsApp is QR-based, and KakaoTalk plus LINE are pairing-based. The required inputs and failure points differ, so keep the channel-specific guide open while you configure it.

  • Token-based channels validate credentials when you press Save & Connect.
  • Telegram and Discord also expose Validate Configuration inside Advanced settings.
  • Slack may require relay-side settings only when you override the default environment.
  • QR codes and pairing content for KakaoTalk or LINE may need to be regenerated after they expire.
  • These docs mirror the current desktop app behavior, so UI changes should be updated here together with the product.