GetMyBot 지식 베이스

채널: Telegram, WhatsApp, VK

하나의 프로젝트에 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 딥링크, 메시지 편집·삭제·전달, 답장 메시지를 트리거로 사용, 참여자 이벤트, 권한 및 관리 기능을 지원합니다. 모든 사진에 쓸 수 있는 file_id가 있으면 사진 카드들을 하나의 메시지에서 넘길 수 있습니다. 텍스트 서식은 Plain / HTML / Markdown입니다. WhatsApp식 메시지 템플릿, 대화형 목록, 세션 창은 없습니다.

WhatsApp(WhatsApp Cloud API): inline 버튼, callback, 이모지 반응, /start 딥링크와 메시지 템플릿, 대화형 목록(interactive list), 24시간 세션 창을 지원합니다. 텍스트 서식은 Plain / Markdown입니다. reply 키보드, 메시지 편집·삭제·전달, 답장을 트리거로 사용, 참여자 이벤트, 권한 관리, 한 메시지에서 사진 카드를 넘기는 기능은 지원하지 않습니다. WhatsApp에서 자세히 알아보세요.

VK: 메시지와 첨부파일, inline 버튼과 reply 키보드, callback, 이모지 반응, /start 딥링크, 메시지 편집·삭제·전달, 참여자 이벤트, 차단과 해제, 이미 제출된 비공개 커뮤니티 가입 요청 승인, 유료 구독 VK Donut 이벤트를 지원합니다. 서식은 일반 텍스트만 지원하며 HTML/Markdown은 표시할 때 제거됩니다. WhatsApp 템플릿, 대화형 목록, 한 메시지에서 사진 카드 넘기기, 세션 창은 없습니다.

모든 채널에 공통으로 inline 버튼, callback, 이모지 반응, /start 딥링크가 있습니다. 사진을 보낼 수 있는 채널에서는 사진 카드 블록도 사용할 수 있습니다. Telegram은 모든 사진에 적합한 file_id가 있을 때만 카드를 한 메시지에서 넘깁니다. 그 밖의 Telegram 경우와 WhatsApp, VK에서는 카드를 각각 별도의 사진 메시지로 보냅니다. 메시지 및 버튼을 참고하세요.

VK Donut

커뮤니티에 VK Donut이 켜져 있으면 봇은 유료 구독과 관련된 시스템 이벤트를 받습니다.

편집기에 표시되는 이벤트키사용할 수 있는 값
VK Donut: subscription createddonut_subscription_created{{event.donut_amount}}, {{event.donut_amount_without_fee}}
VK Donut: subscription prolongeddonut_subscription_prolonged{{event.donut_amount}}, {{event.donut_amount_without_fee}}
VK Donut: subscription expireddonut_subscription_expired없음
VK Donut: subscription cancelleddonut_subscription_cancelled없음

{{event.donut_amount}}는 결제 금액, {{event.donut_amount_without_fee}}는 VK 수수료를 뺀 금액입니다. 만료와 취소 이벤트에는 금액이 없습니다. 이미 결제한 기간이 끝났다는 사실만으로 새 결제가 있었다고 볼 수 없으므로 이전 결제액을 넣어서는 안 됩니다.

이 이벤트는 구독자에 관한 정보이지 그가 보낸 메시지가 아닙니다. 따라서 개인 메시지를 주고받을 수 있는 대화로 표시하거나 차단을 해제하지 않으며 ‘최근 활동’과 메시지 수를 늘리지 않습니다. 카드 결제는 사용자가 봇에 메시지를 보냈다는 뜻이 아니기 때문입니다. 플랫폼에 아직 없는 구독자라면 레이블과 권한을 적용할 수 있도록 새로 등록합니다.

‘유료 구독자 클럽’의 예:

  1. VK Donut: subscription created와 VK Donut: subscription prolonged에 대한 반응을 만듭니다. 레이블 변경으로 ‘클럽’ 레이블을 ttl_days = 31로 추가하고, 비공개 커뮤니티 링크와 가입 요청을 보내 달라는 안내를 보냅니다.
  2. 가입 요청 승인은 사용자가 실제로 요청한 뒤 별도의 단계에서 진행하세요. 권한 변경 → 가입 요청 승인은 이미 제출된 요청만 groups.approveRequest로 승인합니다. 요청이 없으면 승인할 것도 없습니다. 1단계 이후에 누르는 ‘가입 요청을 보냈어요’ 버튼이나 다음 구독 연장 이벤트에 해당 액션을 넣으세요.
  3. Label expired (label_expired) 반응에서는 권한 변경 → 채팅에서 제거를 실행하세요. VK에서 구독 만료 이벤트가 오지 않아도 레이블 기간이 끝났을 때 클럽에서 나가게 됩니다. 트리거를 참고하세요.
  4. VK Donut: subscription cancelled와 VK Donut: subscription expired 반응에서는 레이블 변경으로 ‘클럽’을 제거하고 필요하면 즉시 채팅에서도 제거하세요.

VK의 권한 변경 액션에서 채팅 (chat_id)에는 연결된 커뮤니티의 ID를 넣어야 합니다. 채널 목록에 표시된 숫자와 같습니다. VK는 해당 커뮤니티의 사용자만 관리할 수 있습니다. 다른 ID를 넣으면 VK로 보내기 전에 액션이 거부됩니다. 다른 커뮤니티를 관리하려면 별도 채널로 연결하세요.

이벤트 활성화 방법:

  • Long Poll: 채널을 연결하거나 플랫폼이 시작될 때 봇이 자동으로 구독합니다. 이미 연결된 커뮤니티는 따로 할 일이 없습니다.
  • Callback API: 커뮤니티 설정의 Работа с API → Callback API → Типы событий → VK Donut에서 위 네 이벤트를 모두 켜세요.

채널 연결 방법

프로젝트 페이지에서 채널을 추가합니다.

  1. 프로젝트를 열고 대상 프로젝트를 찾으세요.
  2. 프로젝트 카드에서 채널 추가를 누르세요.
  3. Telegram, WhatsApp, VK 중 플랫폼을 선택하세요.
  4. 연결 정보를 입력하세요. Telegram은 토큰, WhatsApp은 Meta 연결 정보, VK는 커뮤니티 정보가 필요합니다.
  5. 확인을 누르면 GetMyBot이 해당 메신저에서 연결 정보를 확인합니다.
  6. 연결을 누르세요.

WhatsApp과 VK는 연결 후 채널에 웹훅 주소(🔗 아이콘)가 나타납니다. 들어오는 이벤트를 받으려면 WhatsApp의 Meta 앱이나 VK 커뮤니티 설정에 이 주소를 등록해야 합니다. WhatsApp 설정 방법은 WhatsApp 웹훅 설정을 참고하세요.

다음 단계

채널 연결 정보

Telegram에는 BotFather의 전체 토큰을 사용합니다. VK에는 커뮤니티 토큰과 숫자 커뮤니티 ID가 필요하고, Callback API를 쓰려면 비밀 문자열과 확인 코드도 필요합니다. WhatsApp에는 Phone Number ID, WhatsApp 비즈니스 계정 ID, 계정 접근 토큰, 웹훅 Verify Token, Meta 앱 App Secret을 입력합니다.

연결 전에 값을 확인하세요. 키를 바꾸면 해당 제공업체의 설정도 함께 갱신해야 합니다. Verify Token은 웹훅 주소를 확인하고 App Secret은 수신 이벤트의 서명을 검증합니다. 둘 다 API 접근 토큰을 대신하지는 않습니다.

수신 이벤트와 웹훅 주소

VK Callback API에서는 MyBot이 표시한 주소를 커뮤니티 서버 설정에 등록하고 같은 비밀 문자열과 확인 코드를 넣으세요. Long Poll에는 공개 주소나 두 값이 필요하지 않습니다. WhatsApp에서는 Meta 앱에 주소를 등록하고 같은 Verify Token을 입력한 다음 필요한 메시지 이벤트를 구독하세요. 메시지를 보낼 수 있는 연결 정보만 넣어서는 수신 메시지가 설정되지 않습니다.

Instagram과 Messenger 인증

연결 안내에서 Meta 인증 화면을 엽니다. 연결할 Facebook 페이지나 전문가용 Instagram 계정을 관리할 수 있는 계정으로 로그인하세요. 요청된 권한을 허용한 뒤 이 프로젝트에 연결할 계정을 선택합니다. 안내 과정에서 권한, 웹훅 구독, 메시지 전달 준비 상태를 확인합니다. 실패한 항목을 해결한 뒤 채널을 사용하세요. 기존 연결에서도 선택한 계정을 다시 확인할 수 있습니다.