Telegram, Discord, Slack

Telegram, Discord, Slack은 대부분의 Revka 운영자가 가장 먼저 선택하는 세 가지 메시징 플랫폼입니다. 세 플랫폼 모두 실시간으로 동작하며 공개 인바운드 포트가 필요 없습니다(각 플랫폼이 아웃바운드 연결로 메시지를 가져오므로 NAT 환경이나 Raspberry Pi에서도 동작합니다). 또한 추가 Cargo 기능 없이 기본 빌드에 포함되어 있습니다. 이 페이지는 플랫폼별 레퍼런스로, 구성 키, 스트리밍 모드, 수신 확인 반응, Discord 히스토리 로깅 변형, Slack 퍼머링크 확장을 다룹니다.

모든 채널은 ~/.revka/config.toml의 [channels_config] 아래에 위치하며 revka daemon 내에서 실행됩니다. 채널을 처음 연결하는 경우, 허용 목록 모델 및 폴링과 웹훅의 차이점에 대해서는 메시징 채널 연결하기를 참고하시고, 공통 트레이트 모델은 채널 개요를 참조하세요. 단계별 Telegram 연결 안내(예: /bind 페어링 흐름 포함)는 Telegram 및 Matrix 설정하기를 참고하세요.

허용 목록은 기본적으로 모두 차단합니다

모든 채널 허용 목록은 빈 상태로 시작하며, 이는 전체 차단을 의미합니다. 새로 추가된 채널은 연결되어 수신 대기하지만, allowed_users에 ID를 추가하기 전까지는 모든 메시지를 무시합니다. ["*"]는 임시 검증 목적으로만 사용하고, 이후에는 명시적인 ID로 제한하세요.

스트리밍 모드

Telegram과 Discord는 stream_mode 키(StreamMode 열거형)를 공유합니다. Slack은 드래프트 업데이트를 지원하지만 다중 메시지 분할은 지원하지 않으므로, 대신 stream_drafts 불리언 값을 사용합니다.

모드	값	동작	플랫폼
끄기	"off"	생성이 완료된 후 전체 응답을 단일 메시지로 전송합니다. 기본값.	Telegram, Discord
부분	"partial"	수정 가능한 드래프트를 게시하고 토큰이 도착하는 대로 실시간으로 편집하며, 최종적으로 전체 텍스트로 확정합니다. draft_update_interval_ms로 속도를 제한합니다.	Telegram, Discord, Slack (stream_drafts = true)
다중 메시지	"multi_message"	단락 경계(\n\n)로 분할된 별도 메시지로 응답을 전달하며, multi_message_delay_ms 간격으로 전송합니다. 코드 펜스는 절대 분할하지 않습니다.	Discord

드래프트 속도 제한이 필요한 이유

부분 스트리밍은 동일한 메시지를 반복적으로 편집합니다. draft_update_interval_ms는 편집 빈도를 제한하여 각 플랫폼의 속도 제한을 초과하지 않도록 합니다. 기본값은 Telegram과 Discord에서 1000 ms, Slack에서 1200 ms입니다.

수신 확인 반응

수신 확인(ack) 반응은 답장 텍스트가 존재하기 전에 발신자에게 메시지가 수신되어 처리 중임을 알려줍니다. [channels_config] 아래의 전역 스위치로 제어됩니다.

[channels_config]
ack_reactions = true    # default: add 👀 on receipt, ✅/⚠️ on completion
show_tool_calls = false # default: don't forward per-tool 🔧 notices to chat

키	유형	기본값	의미
ack_reactions	bool	true	수신 시 👀 반응을, 완료 시 ✅ / ⚠️ 반응을 인바운드 채널 메시지에 추가합니다.
show_tool_calls	bool	false	도구별 알림(예: 🔧 web_search_tool: …)을 채널 사용자에게 전달합니다. false인 경우 도구 호출은 서버 측에만 기록됩니다.

Telegram은 이에 더해 자체 동작을 추가합니다. 메시지 처리를 시작할 때 setMessageReaction을 통해 ⚡️, 👌, 👀, 🔥, 👍 중 무작위로 선택한 이모지 반응을 추가합니다. Telegram은 또한 채널별 ack_reactions 재정의(아래 참조)를 지원하며, 이 값이 전역 설정보다 우선합니다.

Telegram

Telegram은 가장 빠르게 설정할 수 있는 채널입니다. @BotFather로 봇을 생성하고, 토큰을 붙여넣으면 몇 분 안에 에이전트와 대화할 수 있습니다. getUpdates 롱 폴링으로 메시지를 수신하고 sendMessage로 응답합니다.

[channels_config.telegram]
bot_token = "123456:TELEGRAM-TOKEN"   # required, from @BotFather
allowed_users = ["*"]                 # tighten after testing
stream_mode = "off"                   # off | partial
draft_update_interval_ms = 1000       # edit throttle for partial mode
mention_only = false                  # only respond to @mentions in groups
interrupt_on_new_message = false      # cancel in-flight reply on a new message
# ack_reactions = true                # optional per-channel override of the global setting
# proxy_url = "socks5://127.0.0.1:9050"
# notification_chat_id = "123456789"  # target for workflow notify/approval prompts

필드	유형 / 값	기본값	의미
bot_token	string (필수)	—	@BotFather에서 발급받은 Bot API 토큰입니다.
allowed_users	list	[] (전체 차단)	Telegram 사용자 이름(@ 제외) 또는 숫자 사용자 ID, 또는 "*"입니다.
stream_mode	"off" | "partial"	"off"	답장 전달 모드입니다.
draft_update_interval_ms	integer	1000	partial 모드에서 드래프트 스트리밍 시 편집 속도 제한입니다.
mention_only	bool	false	그룹 채팅에서 응답하기 위해 @멘션을 요구합니다. DM은 항상 처리됩니다.
interrupt_on_new_message	bool	false	동일한 발신자가 같은 채팅에서 다시 메시지를 보내면 진행 중인 생성을 취소합니다.
ack_reactions	bool (선택)	전역 설정 상속	[channels_config].ack_reactions의 채널별 재정의입니다.
proxy_url	string	—	전역 [proxy]를 재정의하는 채널별 HTTP/HTTPS/SOCKS5 프록시입니다.
notification_chat_id	string	—	"telegram"을 대상으로 하는 워크플로 notify 단계 및 승인 프롬프트에 사용할 채팅 ID입니다.

채널을 추가하고 데몬을 시작합니다.

revka channel add telegram '{"bot_token":"123456:TELEGRAM-TOKEN","name":"my-bot"}'
revka daemon

허용 목록은 기본적으로 모든 사람을 차단하므로, 새로운 발신자는 거부되며 Revka가 허용 목록 추가를 위한 정확한 revka channel bind-telegram <id> 명령어를 응답으로 보내줍니다. 전체 /bind 페어링 흐름은 Telegram 및 Matrix 설정하기를 참고하세요.

미디어 및 제한 사항

메시지는 Telegram의 4,096자 제한에 따라 단어/줄바꿈 경계에서 자동으로 분할됩니다. 인바운드 미디어(사진, 문서, 오디오, 비디오, 음성)는 ~/.revka/workspace/telegram_files/에 다운로드됩니다. 아웃바운드 파일은 [IMAGE:...], [DOCUMENT:...], [VIDEO:...], [AUDIO:...], [VOICE:...] 마커를 사용합니다. 공유 [transcription] 섹션이 활성화된 경우 음성 메모는 텍스트로 변환됩니다.

채팅 내 런타임 명령어

다음 명령어는 허용된 Telegram(및 Discord) 발신자가 사용할 수 있습니다. 발신자 범위로 적용되며 데몬을 재시작할 필요가 없습니다.

명령어	효과
/models	사용 가능한 프로바이더와 현재 선택 항목을 표시합니다.
/models <provider>	이 발신자의 세션에서 프로바이더를 전환합니다.
/model	현재 모델을 표시합니다.
/model <model-id>	이 발신자의 세션에서 모델을 전환합니다.
/new	이 발신자의 대화 히스토리를 초기화하고 새로 시작합니다.

Discord

Discord는 Gateway WebSocket(op IDENTIFY)으로 연결되어 길드 및 DM 메시지를 실시간으로 수신하고, REST를 통해 답장을 보냅니다. 세 가지 stream_mode 값을 모두 지원하고, 타이핑 표시기, 이모지 반응, 승인 키워드 인터셉트를 지원하는 세 플랫폼 중 가장 풍부한 스트리밍 기능을 제공합니다.

[channels_config.discord]
bot_token = "DISCORD-BOT-TOKEN"   # required
guild_id = "123456789012345678"   # optional: restrict to one guild
allowed_users = ["*"]             # tighten after testing
listen_to_bots = false            # process messages from other bots
mention_only = false              # require an @mention
interrupt_on_new_message = false  # cancel in-flight reply on a new message
stream_mode = "multi_message"     # off | partial | multi_message
draft_update_interval_ms = 1000   # edit throttle (partial mode)
multi_message_delay_ms = 800      # delay between chunks (multi_message mode)
# proxy_url = "socks5://127.0.0.1:9050"
# notification_channel_id = "123456789012345678"

필드	유형 / 값	기본값	의미
bot_token	string (필수)	—	Discord 개발자 포털에서 발급받은 봇 토큰입니다.
guild_id	string	—	봇을 단일 길드(서버)로 제한합니다.
allowed_users	list	[] (전체 차단)	Discord 사용자 ID, 또는 "*"입니다.
listen_to_bots	bool	false	다른 봇의 메시지를 처리합니다. 봇은 자신의 메시지는 항상 무시합니다.
mention_only	bool	false	@멘션을 요구하며, 다른 길드 메시지는 무시합니다.
interrupt_on_new_message	bool	false	동일한 발신자가 같은 채널에서 다시 메시지를 보내면 진행 중인 생성을 취소합니다.
stream_mode	"off" | "partial" | "multi_message"	"off"	답장 전달 모드입니다.
draft_update_interval_ms	integer	1000	partial 모드에서 편집 속도 제한(PATCH /channels/{id}/messages/{id})입니다.
multi_message_delay_ms	integer	800	multi_message 모드에서 단락 청크 간 지연 시간입니다.
proxy_url	string	—	채널별 HTTP/HTTPS/SOCKS5 프록시입니다.
notification_channel_id	string	—	"discord"를 대상으로 하는 워크플로 notify 단계에 사용할 채널 ID입니다.

추가 후 시작합니다.

revka channel add discord '{"bot_token":"DISCORD-BOT-TOKEN","name":"my-discord"}'
revka daemon

동작 세부 사항

텍스트 파일 첨부는 가져와서 인라인으로 삽입됩니다. 이미지는 활성 프로바이더의 비전 파이프라인으로 전달됩니다. 공유 [transcription] 섹션이 활성화된 경우 오디오 첨부는 텍스트로 변환됩니다. Gateway 재연결(op 7 Reconnect / op 9 Invalid Session)은 자동으로 처리됩니다. multi_message 모드에서 코드 펜스는 절대 분할되지 않습니다.

Discord History 채널

Discord History 채널은 Discord의 별도 변형으로, 자체 [channels_config.discord_history] 키로 구성됩니다. @멘션 메시지만 에이전트로 전달하면서 봇 이외의 모든 메시지를 전용 discord.db 메모리 백엔드에 로깅하여, Revka를 호출 시 응답하는 영구적인 길드 아카이브로 전환합니다. 팀이 봇과 함께 검색 가능한 메시지 히스토리를 원할 때 사용하세요.

[channels_config.discord_history]
bot_token = "DISCORD-BOT-TOKEN"   # required
guild_id = "123456789012345678"   # optional: restrict logging to one guild
allowed_users = ["*"]             # empty = allow all (open logging)
channel_ids = []                  # channels to watch; empty = all
store_dms = true                  # persist DM messages to discord.db
respond_to_dms = true             # forward DM @mentions to the agent
# proxy_url = "socks5://127.0.0.1:9050"

필드	유형 / 값	기본값	의미
bot_token	string (필수)	—	Discord 개발자 포털에서 발급받은 봇 토큰입니다.
guild_id	string	—	로깅을 단일 길드로 제한합니다.
allowed_users	list	[] → 전체 허용	Discord 사용자 ID, 또는 "*"입니다. 참고: 표준 Discord와 달리 여기서 빈 목록은 전체 차단이 아닌 개방형 로깅을 의미합니다.
channel_ids	list	[] (전체 감시)	감시할 채널 ID 목록입니다.
store_dms	bool	true	DM 메시지를 discord.db에 저장합니다.
respond_to_dms	bool	true	DM에서 수신된 @멘션을 에이전트로 전달합니다.
proxy_url	string	—	채널별 프록시입니다.

두 가지 Discord 변형, 두 가지 구성 키

[channels_config.discord]와 [channels_config.discord_history]는 별개의 채널입니다. History 변형은 Memory 백엔드 인스턴스가 필요하며, 채널 이름을 확인(24시간 캐시)하여 저장된 행이 @user in #channel at <time>: <text> 형식으로 표시됩니다. 스트리밍, 드래프트 편집, 비전은 지원하지 않으며, 로깅과 멘션 응답 기능만 제공하는 봇입니다.

discord_search 도구 현재 사용 불가

discord_search 에이전트 도구는 discord.db History 백엔드를 쿼리하도록 설계되었습니다. 키워드 query에 일치하는 메시지를 반환하며, channel_id 또는 RFC 3339 형식의 since/until 시간 범위로 선택적 필터링이 가능합니다. 도구 코드는 트리에 남아 있지만 현재 연결되지 않은 상태입니다. 의존하던 SQLite 메모리 백엔드가 제거되었고, 해당 도구는 discord 기반 Memory 핸들이 제공될 때만 등록됩니다. Kumiho 그래프 메모리 위에 재도입되기 전까지는 에이전트 도구 목록에 표시되지 않습니다. 현재 세션 간 영구적인 메시지 검색이 필요하다면 Kumiho 메모리 도구를 사용하세요.

Slack

Slack은 실시간 이벤트를 위해 앱 수준 토큰(xapp-...)을 사용하는 Socket Mode로 연결되며, 앱 토큰이 없는 경우 conversations.history 폴링으로 대체합니다. chat.update를 통한 드래프트 스트리밍, 반응으로 취소, 타이핑 표시기, 파일 첨부, 퍼머링크 확장을 지원합니다.

[channels_config.slack]
bot_token = "xoxb-..."                 # required, bot OAuth token
app_token = "xapp-..."                 # app-level token for Socket Mode
channel_id = "C1234567890"             # single channel; "*" or omit = all accessible
channel_ids = ["C123...", "D456..."]   # explicit list; takes precedence over channel_id
allowed_users = ["*"]                  # tighten after testing
thread_replies = true                  # reply in the originating thread
mention_only = false                   # require an @mention in groups; DMs always allowed
use_markdown_blocks = true             # use the markdown block type (12k char limit)
stream_drafts = false                  # progressive draft updates via chat.update
draft_update_interval_ms = 1200        # edit throttle for draft streaming
cancel_reaction = "x"                  # emoji name (no colons) that cancels an in-flight request
interrupt_on_new_message = false       # newer message from same sender cancels and restarts
# proxy_url = "socks5://127.0.0.1:9050"
# notification_channel_id = "C1234567890"

필드	유형 / 값	기본값	의미
bot_token	string (필수)	—	봇 OAuth 토큰(xoxb-...)입니다.
app_token	string	—	Socket Mode를 활성화하는 앱 수준 토큰(xapp-...)입니다. 없으면 Slack은 폴링으로 대체됩니다.
channel_id	string	—	단일 채널 ID입니다. 생략하거나 "*"를 사용하면 접근 가능한 모든 채널을 자동 검색합니다.
channel_ids	list	[]	감시할 채널/DM ID 명시 목록입니다. channel_id보다 우선합니다.
allowed_users	list	[] (전체 차단)	Slack 사용자 ID, 또는 "*"입니다.
thread_replies	bool	true	원본 스레드에 답장합니다. false이면 채널 루트에 게시됩니다.
mention_only	bool	false	그룹에서 @멘션을 요구합니다. DM은 항상 허용됩니다.
use_markdown_blocks	bool	false	section 블록(3,000자) 대신 최신 markdown 블록 유형(12,000자 제한)을 사용합니다. 워크스페이스가 지원하는 경우에만 활성화하세요.
stream_drafts	bool	false	chat.update를 통한 점진적 드래프트 스트리밍을 활성화합니다.
draft_update_interval_ms	integer	1200	드래프트 스트리밍 중 편집 속도 제한입니다.
cancel_reaction	string	—	사용자가 반응하면 진행 중인 요청을 취소하는 이모지 이름(콜론 없이), 예: "x". 비활성화하려면 설정하지 마세요.
interrupt_on_new_message	bool	false	동일한 채널에서 동일한 발신자의 새 메시지가 오면 진행 중인 요청을 취소하고 히스토리를 유지한 채 재시작합니다.
proxy_url	string	—	채널별 프록시입니다.
notification_channel_id	string	—	"slack"을 대상으로 하는 워크플로 notify 단계 및 승인 프롬프트에 사용할 채널 ID입니다.

추가 후 시작합니다.

revka channel add slack '{"bot_token":"xoxb-...","app_token":"xapp-...","name":"my-slack"}'
revka daemon

Slack 제한 및 캐싱

표준 section 블록은 3,000자로 제한되며, use_markdown_blocks를 사용하면 12,000자로 늘어납니다. 메시지당 최대 8개의 파일 첨부를 지원하며, 이미지는 5 MB로 제한됩니다. 사용자 표시 이름은 6시간 동안 캐시됩니다. 공유 [transcription] 섹션이 활성화된 경우 오디오 첨부는 텍스트로 변환됩니다.

퍼머링크 확장

인바운드 Slack 메시지에 다른 Slack 메시지 링크가 포함되어 있으면, Revka는 이를 해석하여 에이전트가 별도의 도구 호출 없이 참조된 콘텐츠를 볼 수 있도록 합니다. https://<workspace>.slack.com/archives/<channel>/p<timestamp> 형식의 퍼머링크를 파싱하고 해당 컨텍스트를 가져옵니다.

• 메시지당 최대 퍼머링크 3개가 확장됩니다(채널 + 타임스탬프 기준 중복 제거).
• 스레드 퍼머링크는 주변 답장을 최대 최근 20개까지 가져오며, 이전 답장은 … N earlier thread messages omitted …로 요약됩니다.
• 확장된 전체 콘텐츠는 메시지당 최대 8,000자로 제한됩니다.

확장은 투명하게 처리됩니다. 확인된 Message: 또는 Thread: 텍스트가 에이전트가 읽는 내용 앞에 추가됩니다. 이 기능은 Slack 외 URL을 위한 크로스 채널 링크 인리처와 함께 사용하면 효과적입니다.

관련 페이지

채널 개요 채널 트레이트, 전달 모드, 허용 목록 의미론.

Telegram 및 Matrix 설정하기 /bind 페어링 흐름을 포함한 단계별 Telegram 설정 안내.

메시징 채널 연결하기 채널 모델과 revka channel 명령어.

revka channel 및 통합 channel add / bind / start / doctor의 CLI 레퍼런스.

구성: 채널, 도구 및 통합 모든 채널 구성 키를 한 곳에서.

Kumiho 그래프 메모리 세션 간 영구 메모리 및 검색.