Messenger Channels
설정과 운영 방법
채널 카드에서 상태를 확인하고, 가이드를 열고, 연결하기·다시 연결·연결 해제를 쓰는 공통 흐름을 현재 앱 화면 기준으로 정리했습니다.
채널 설정 열기
- 1
사이드바에서 연결을 엽니다.
- 2
메신저 채널 화면에서 원하는 카드로 이동합니다.
- 3
처음 연결이면 카드의 연결하기를 누릅니다.
- 4
이미 저장돼 있지만 끊어진 Telegram, Discord, Slack, WhatsApp 카드는 다시 연결을 누릅니다.
- 5
KakaoTalk과 LINE은 연결이 끊어진 뒤 카드 기본 상태로 돌아가므로 다시 연결 대신 연결하기에서 새 코드를 준비합니다.
- 6
카드 하단 가이드 또는 설정 모달의 문서 보기로 채널 문서를 열 수 있습니다.
연결 상태 이해하기
- connected: 현재 채널이 정상 연결된 상태입니다.
- connecting: 연결을 준비하거나 재시도하는 중입니다.
- disconnected: 설정은 남아 있지만 현재 연결이 비활성화된 상태입니다.
- error: 연결 또는 검증 과정에서 오류가 발생한 상태입니다.
카드에서 바로 할 수 있는 일
- 카드 상단 상태 점으로 connected, connecting, disconnected, error를 확인합니다.
- 카드 하단 가이드 버튼은 해당 채널 문서를 바로 엽니다.
- 연결된 카드의 기본 버튼은 연결 해제, 끊어진 카드의 기본 버튼은 다시 연결 또는 연결하기로 바뀝니다.
- 연결된 카드 오른쪽 더보기 메뉴에서는 에이전트 바인딩을 바꾸고 연결 상태에 맞는 동작을 추가로 실행할 수 있습니다.
- KakaoTalk은 현재 단일 계정만 지원합니다.
재연결과 연결 해제
- 연결된 카드의 기본 버튼은 연결 해제이며, 한 번 누르면 4초짜리 확인 상태가 뜨고 그 안에 한 번 더 눌러야 실제로 해제됩니다.
- 끊어진 Telegram, Discord, Slack, WhatsApp 카드는 카드 기본 버튼이 다시 연결로 바뀝니다.
- WhatsApp은 설정 모달에서 QR 코드 생성으로 새 연결을 시작하고, 표시된 뒤에는 코드 새로고침으로 다시 발급할 수 있습니다.
- KakaoTalk과 LINE은 연결하기를 다시 열어 새 코드를 준비합니다. 기존 바인딩이 남아 있으면 채팅창에 "연결해제"를 먼저 보내는 편이 안전합니다.
공통 주의사항
현재 앱 기준으로 연결 방식이 다릅니다
Telegram과 Discord는 토큰 입력, Slack은 브라우저 승인, WhatsApp은 QR 스캔, KakaoTalk과 LINE은 페어링 코드 발급 방식입니다. 채널마다 필요한 값과 실패 지점이 다르므로 개별 문서를 함께 보는 것이 좋습니다.
- 토큰 채널은 저장 후 연결을 누를 때 자격 증명 검증이 먼저 실행됩니다.
- Telegram과 Discord는 고급 설정을 열면 구성 검증 버튼으로 미리 확인할 수 있습니다.
- Slack은 보통 브라우저 승인만으로 충분하지만, 별도 환경에서는 Relay Base URL 확인이 필요할 수 있습니다.
- QR 코드와 KakaoTalk 또는 LINE 연결 코드는 시간이 지나면 다시 발급해야 할 수 있습니다.
- 문서 내용은 현재 데스크톱 앱에 맞춘 기준이므로 UI가 바뀌면 세부 단계도 함께 업데이트됩니다.