채널

채널이란 무엇인가?

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

주요 개념:

에이전트별 구성 -- 각 채널 연결은 에이전트 수준에서 구성됩니다. 하나의 에이전트가 Slack에 연결되어 있는 동안 다른 에이전트는 Discord를 처리하거나, 단일 에이전트가 여러 채널에 동시에 연결될 수 있습니다.
양방향 -- 채널은 메시지 전송과 수신을 모두 지원합니다. 에이전트는 들어오는 메시지에 응답하거나, 아웃바운드 메시지를 시작하거나, 둘 다 수행할 수 있습니다.
다중 계정 -- 같은 채널 유형에 대해 여러 계정을 연결할 수 있습니다(예: 두 개의 다른 Slack 워크스페이스 또는 여러 이메일 주소).

지원되는 채널

채널	인증 방법	기능
Slack	OAuth	전체 메시지, 채널, 스레드, 반응, 파일 업로드
Discord	봇 토큰	서버 메시지, 채널, DM, 임베드, 반응
WhatsApp	QR 코드	문자 메시지, 미디어 메시지, 그룹 채팅
Telegram	봇 토큰	문자 메시지, 그룹, 채널, 인라인 키보드, 파일 공유
Signal	로컬 앱	종단 간 암호화 메시지, 그룹 채팅
Microsoft Teams	OAuth	팀, 채널, 채팅, 어댑티브 카드, 파일 공유
Google Chat	OAuth	스페이스, 직접 메시지, 카드, 스레드 대화
SMS	API 키	지원 제공업체를 통한 아웃바운드 및 인바운드 문자 메시지
이메일 / Gmail	OAuth	보내기, 받기, 초안, 답장, 첨부 파일, 레이블 관리
Matrix	토큰	연합 메시지, 방, 종단 간 암호화
Line	토큰	문자 메시지, 스티커, 그룹 채팅, 리치 메뉴
Zalo	토큰	문자 메시지, 미디어 공유
IRC	구성	서버 연결, 채널, 개인 메시지
iMessage	로컬	macOS 기본 메시지(macOS 호스트 필요)

채널 연결

연결 프로세스는 채널의 인증 방법에 따라 다릅니다.

OAuth 흐름

사용: Slack, Microsoft Teams, Google Chat, 이메일 / Gmail

에이전트의 채널 탭을 엽니다.
추가하려는 채널 옆에 연결을 클릭합니다.
서비스의 인증 페이지로 리디렉션됩니다.
계정으로 로그인하고 Neotask에 요청된 권한을 부여합니다.
인증 후 대시보드로 리디렉션되고 채널이 연결됨으로 표시됩니다.

모바일 플랫폼의 경우 QR 코드 옵션이 제공됩니다. 스마트폰으로 QR 코드를 스캔하여 데스크톱 브라우저에 로그인하지 않고도 인증을 완료할 수 있습니다.

봇 토큰

사용: Discord, Telegram

각 플랫폼에서 봇을 생성합니다:
- Discord -- Discord 개발자 포털에서 애플리케이션을 생성하고 봇 토큰을 생성합니다.
- Telegram -- Telegram에서 @BotFather에게 메시지를 보내 봇을 생성하고 토큰을 받습니다.
에이전트의 채널 탭을 열고 채널 옆의 연결을 클릭합니다.
봇 토큰을 토큰 필드에 붙여넣습니다.
저장을 클릭하여 연결을 설정합니다.

QR 코드

사용: WhatsApp

에이전트의 채널 탭을 열고 WhatsApp 옆의 연결을 클릭합니다.
화면에 QR 코드가 나타납니다.
스마트폰에서 WhatsApp을 열고 연결된 기기로 이동하여 QR 코드를 스캔합니다.
스마트폰이 링크를 확인하면 연결이 설정됩니다.

API 키

사용: SMS

SMS 제공업체(예: Twilio, Vonage)에서 API 키를 받습니다.
에이전트의 채널 탭을 열고 SMS 옆의 연결을 클릭합니다.
API 키와 추가 필수 필드(예: 전화번호, 계정 SID)를 입력합니다.
저장을 클릭하여 채널을 활성화합니다.

토큰

사용: Matrix, Line, Zalo

각 플랫폼의 개발자 설정 또는 관리 패널에서 액세스 토큰을 생성합니다.
에이전트의 채널 탭을 열고 채널 옆의 연결을 클릭합니다.
토큰을 토큰 필드에 붙여넣습니다.
저장을 클릭하여 연결을 설정합니다.

서버 구성

사용: IRC

에이전트의 채널 탭을 열고 IRC 옆의 연결을 클릭합니다.
서버 주소, 포트, 닉네임, 선택적으로 비밀번호를 입력합니다.
연결 시 참여할 채널을 지정합니다.
저장을 클릭하여 연결합니다.

로컬 애플리케이션

사용: Signal, iMessage

필요한 애플리케이션이 호스트 시스템에 설치되어 실행 중인지 확인합니다:
- Signal -- Signal Desktop이 설치되어 Signal 계정에 연결되어 있어야 합니다.
- iMessage -- Messages.app이 구성된 macOS 호스트가 필요합니다.
에이전트의 채널 탭을 열고 채널 옆의 연결을 클릭합니다.
Neotask이 로컬 애플리케이션을 감지하고 연결을 설정합니다.
애플리케이션이 감지되지 않으면 설치하거나 구성하라는 메시지가 표시됩니다.

연결 테스트

채널 연결 후 Neotask은 연결을 확인하기 위해 자동으로 지연 시간 프로브를 실행합니다:

채널의 API를 통해 테스트 메시지가 전송되고 수신됩니다.
왕복 지연 시간이 측정되어 표시됩니다.
테스트에 실패하면 오류 메시지가 문제를 설명합니다(예: 유효하지 않은 토큰, 만료된 OAuth 부여, 도달할 수 없는 서버).

채널 설정에서 언제든지 연결 테스트를 다시 실행할 수 있습니다.

채널 작업

채널이 연결되면 에이전트의 채널 탭에서 관리할 수 있습니다.

활성화 / 비활성화

연결 해제 없이 채널을 켜거나 끕니다. 비활성화 시:

에이전트가 해당 채널에서 메시지 수신을 중지합니다.
아웃바운드 메시지가 전송되지 않습니다.
연결 자격 증명이 유지되어 재구성 없이 언제든지 다시 활성화할 수 있습니다.

연결 테스트

채널에 연결 가능하고 응답하는지 확인하기 위해 온디맨드 연결 테스트를 실행합니다. 테스트는:

채널의 서비스에 경량 API 요청을 보냅니다.
밀리초 단위의 왕복 지연 시간을 측정합니다.
연결됨(지연 시간 포함) 또는 실패(오류 세부 정보 포함)로 결과를 보고합니다.

지연 시간 보기

각 연결된 채널은 채널 탭에 가장 최근의 지연 시간 수치를 표시합니다. 이를 통해 한눈에 느리거나 저하된 연결을 식별할 수 있습니다. 지연 시간은 다음 때 업데이트됩니다:

각 연결 테스트 후 자동으로.
채널이 활성화된 동안 백그라운드에서 주기적으로.

연결 해제 / 로그아웃

채널 연결을 완전히 제거하려면:

채널 옆의 연결 해제를 클릭합니다.
대화 상자에서 작업을 확인합니다.
Neotask이 저장된 자격 증명을 취소하거나 폐기합니다(OAuth 토큰은 지원되는 경우 제공업체 측에서 취소됩니다).
채널이 에이전트의 활성 채널 목록에서 제거됩니다.

연결 해제 후 다시 연결하려면 원래 연결 단계를 다시 따르세요.