# 채널

## 채널이란 무엇인가?

채널은 에이전트가 연결하는 메시지 플랫폼입니다. 채널을 연결하면 에이전트가 해당 플랫폼에서 들어오는 메시지를 수신하고 실시간으로 응답할 수 있게 됩니다.

Neotask는 기본적으로 **20개 이상의 메시지 플랫폼**을 지원합니다.

## 지원되는 채널

### 핵심 채널 (내장)

| 채널 | 설명 |
|---------|-------------|
| **WhatsApp** | WhatsApp Web 프로토콜을 통한 개인 및 비즈니스 계정. 그룹, 반응, 미디어, 스레드, 편집/전송 취소, 전달. |
| **Telegram** | Bot API 통합. 그룹, 채널, 스레드, 반응, 고정. 선택적 웹훅 수집. |
| **Discord** | 완전한 서버 통합. 채널, 역할, 스레드, 음성 채널 인식, 서버별 에이전트 바인딩. |
| **Slack** | OAuth를 통한 워크스페이스 앱. 채널, 스레드, 반응, 파일 공유. |
| **Signal** | Signal 프로토콜을 통한 암호화된 DM 및 그룹. QR을 통한 전화 페어링. |
| **Google Chat** | 웹훅을 통한 스페이스, 스레드, 반응, 카드 응답. |
| **iMessage** | macOS의 BlueBubbles를 통한 완전한 SMS/iMessage 지원. 편집, 전송 취소, 효과. |
| **IRC** | 채널, DM, SASL 인증, 다중 서버 지원을 갖춘 클래식 IRC. |

### 플러그인 채널

| 채널 | 설명 |
|---------|-------------|
| **Microsoft Teams** | 플러그인을 통한 워크스페이스 통합. |
| **Matrix** | 분산형 메시지 프로토콜. |
| **Nostr** | 분산형 소셜 프로토콜 DM. |
| **Zalo** | 베트남 메시지 플랫폼 (봇 API 및 개인 계정). |
| **Feishu/Lark** | 엔터프라이즈 메시지 플랫폼. |
| **LINE** | LINE 메시지 API 통합. |
| **Nextcloud Talk** | Nextcloud를 통한 자체 호스팅 메시지. |
| **Mattermost** | 오픈소스 팀 메시지. |
| **Tlon** | Urbit 기반 메시지. |
| **Twitch** | IRC를 통한 라이브 스트림 채팅. |

## 채널 기능

### 다중 계정 지원
채널당 여러 계정을 실행합니다. 예를 들어 동일한 게이트웨이에서 여러 WhatsApp 번호 또는 Telegram 봇을 관리합니다.

### 미디어 지원
이미지, 비디오, 오디오, 문서, 스티커 및 기타 미디어 유형을 전송하고 수신합니다. 미디어 처리는 플랫폼에 따라 다르지만 대부분의 채널은 양방향으로 풍부한 미디어를 지원합니다.

### 그룹 및 채널 관리
에이전트는 그룹 대화에 참여하고, 멘션에 응답하고, 스레드를 관리하고, 채널별 기능(반응, 투표, 고정)과 상호작용할 수 있습니다.

### 메시지 스레딩
Slack, Discord, Telegram처럼 지원하는 플랫폼에서 에이전트는 스레드를 생성하고, 스레드 내에서 답장하고, 스레드별 컨텍스트를 유지할 수 있습니다.

### 메시지 편집 및 반응
에이전트는 자신의 메시지를 편집하고, 메시지를 전송 취소하고, 이러한 기능을 지원하는 플랫폼에서 반응을 추가할 수 있습니다.

### 브로드캐스트 그룹
여러 채널에 동시에 공지를 전송합니다. 여러 플랫폼을 동기화 상태로 유지하기 위해 브로드캐스트 그룹을 구성합니다.

## 채널 라우팅

### 기본 동작
기본적으로 메인 에이전트는 모든 채널에서 모든 수신 메시지를 받습니다.

### 다중 에이전트 라우팅
여러 에이전트가 있을 경우 메시지는 바인딩에 따라 라우팅됩니다:

- **채널별**, 모든 WhatsApp 메시지 → 개인 에이전트
- **서버별**, Discord 서버 A → 지원 에이전트, 서버 B → 개발 에이전트
- **워크스페이스별**, Slack 워크스페이스 → 팀 에이전트
- **채팅 유형별**, 개인 DM → 어시스턴트, 그룹 메시지 → 팀 봇

### DM 접근 제어
어떤 연락처가 에이전트에게 직접 메시지를 보낼 수 있는지 구성합니다. 모든 DM 허용, 알려진 연락처만, 또는 특정 허용 목록 등의 옵션이 있습니다.

### 그룹 멘션 게이팅
그룹 채팅에서 에이전트가 모든 메시지에 응답하는지 아니면 멘션될 때만 응답하는지 구성합니다.

## 페어링 및 인증

각 채널은 자체 인증 방법을 가집니다:

| 채널 | 인증 방법 |
|---------|-------------|
| WhatsApp | QR 코드 스캔 |
| Telegram | 봇 토큰 |
| Discord | 봇 토큰 |
| Slack | OAuth (워크스페이스 앱) |
| Signal | QR을 통한 전화 페어링 |
| Google Chat | 웹훅 URL |
| iMessage | BlueBubbles API 키 |
| IRC | 닉 + 선택적 비밀번호 |