채널: Telegram, WhatsApp, VK
GetMyBot의 봇은 여러 메신저 — Telegram, WhatsApp, VK — 에서 동시에 동작할 수 있습니다. 동작(반응, 조건, 액션)은 한 번만 구성하면, 플랫폼이 이벤트가 발생한 채널로 이를 전달합니다. 이렇게 하나의 컨스트럭터가 모든 채널을 담당하며, 채널마다 따로 설정할 필요가 없습니다.
채널이란
채널은 연결된 전달 지점입니다. 구체적으로는 특정 Telegram 봇, WhatsApp Business 번호, 또는 VK 커뮤니티입니다. 하나의 GetMyBot 봇은 여러 채널을 가질 수 있습니다. 반응은 공통입니다. 구독자가 WhatsApp에 메시지를 보내면, 그 이벤트는 Telegram과 동일한 반응으로 처리되고, 응답은 다시 WhatsApp으로 전송됩니다.
채널마다 지원하는 메신저 기능(버튼, 편집, 템플릿 등)의 범위가 다릅니다. 컨스트럭터는 이를 고려하여, 해당 채널에서 사용할 수 없는 액션은 제안하지 않거나 가장 가까운 대안으로 축소합니다.
기본 채널 (primary_channel)
각 봇에는 기본 채널(primary_channel)이 있습니다. 이는 봇이 일차적으로 연결되는 지점입니다. 보통은 Telegram이지만, Telegram 없이 바로 WhatsApp 봇 또는 VK 봇 으로 봇을 만들 수도 있습니다. 기본 채널은 생성 시 정해지며 봇 목록에 표시됩니다. 나머지 채널은 이후에 봇에 추가합니다.
채널 기능 매트릭스
아래는 각 채널이 지원하는 메신저 기능입니다. 최신 매트릭스는 API가 기계 판독 가능한 형태로 반환합니다: GET /api/channels/capabilities.
Telegram — 전체 기능을 갖춘 기준 채널입니다: inline 버튼과 reply 키보드, callback(버튼 누름 → 반응), 이모지 반응, 딥링크 /start, 메시지 편집·삭제·전달, 트리거로서의 reply, 참여자 이벤트, 권한 및 모더레이션. 텍스트 서식은 Plain / HTML / Markdown. 템플릿, 리스트, 캐러셀, 세션 창은 없습니다(Telegram에서는 필요하지 않습니다).
WhatsApp(WhatsApp Cloud API 경유) — 고유한 특성이 있습니다: inline 버튼, callback, 이모지 반응, 딥링크 /start, 메시지 템플릿, 리스트(interactive list), 24시간 세션 창. 서식은 Plain / Markdown. reply 키보드, 메시지 편집·삭제·전달, 트리거로서의 reply, 참여자 이벤트, 권한/모더레이션, 캐러셀은 지원하지 않습니다. 자세한 내용은 WhatsApp 페이지를 참고하세요.
VK — 메시지와 첨부, inline 버튼과 reply 키보드, callback, 이모지 반응, 딥링크 /start, 메시지 편집과 삭제, 전달, 참여자 이벤트, 차단/차단 해제. 서식은 일반 텍스트만 지원합니다(HTML/Markdown은 렌더링 시 제거됩니다). WhatsApp 템플릿, 리스트, 캐러셀, 세션 창은 VK에 없습니다.
모든 채널 공통: inline 버튼, callback, 이모지 반응, 딥링크 /start. 캐러셀은 아직 어느 채널도 지원하지 않습니다.
채널 연결 방법
채널은 봇 페이지(/app/bots)에서 추가합니다.
- 봇 을 열고 원하는 봇을 찾습니다.
- 봇 카드에서 「채널 추가」 를 클릭합니다.
- 플랫폼(Telegram, WhatsApp, VK)을 선택합니다.
- 채널의 자격 증명을 입력합니다(Telegram은 토큰, WhatsApp은 Meta 자격 증명 세트, VK는 커뮤니티 자격 증명).
- 「검증」 을 클릭합니다 — 플랫폼이 메신저 측에서 자격 증명을 확인합니다.
- 「연결」 을 클릭합니다.
WhatsApp 과 VK 의 경우, 연결 후 채널에 Webhook 주소(🔗 아이콘)가 표시됩니다. 수신 이벤트가 봇에 도달하도록, 이 주소를 플랫폼 측(WhatsApp은 Meta 앱, VK는 커뮤니티 설정)에 등록해야 합니다. WhatsApp에서의 방법은 WhatsApp → Webhook 설정을 참고하세요.