GetMyBot 지식 베이스

메시지와 버튼

텍스트, 사진, 버튼으로 봇의 답을 만들고 질문에 대한 사용자 응답을 저장하는 방법.

이 페이지에서

봇이 텍스트와 사진, ‘선택’ 버튼을 보내게 하려면 메시지 전송 액션을 추가하세요. 답은 블록이라는 부분으로 조립합니다. 먼저 상품 사진을 보내고 설명과 버튼을 붙일 수 있습니다. 메시지 아래의 버튼은 인라인 버튼이라고도 합니다.

같은 액션에서 질문을 보내고 답을 기다릴 수도 있습니다. 예를 들어 전화번호를 물어 고객 정보에 저장합니다. 아래에서 블록, 버튼, 질문 단계를 설명합니다.

메시지 블록

블록 추가를 누르고 보낼 내용을 선택하세요. 인사말, 사진, 수업 안내 파일을 조합할 수 있습니다.

  • 텍스트: 치환 변수와 버튼을 포함하는 서식 있는 텍스트, 최대 4096자.
  • 사진: 설명 문구를 붙인 이미지.
  • 파일: 설명 문구를 붙인 문서.
  • Voice(음성 메시지): OGG/OPUS, MP3, M4A 형식이며 최대 50 MB입니다. Telegram에서 음성 메시지로 표시됩니다(sendVoice).
  • GIF: 소리가 없는 애니메이션이나 MP4, 최대 50 MB(sendAnimation).
  • Video note(동영상 노트): 정사각형 MP4, 최대 60초(sendVideoNote). 설명 문구를 붙일 수 없습니다. 미디어 라이브러리 파일은 전송할 때마다 다시 업로드됩니다. Telegram은 다른 방식으로 얻은 file_id를 sendVoice, sendAnimation, sendVideoNote에 사용하도록 허용하지 않습니다.
  • Carousel(캐러셀): 사진, 설명, 개별 버튼이 있는 카드 2~10개입니다. Telegram에서는 모든 사진에 사용 가능한 file_id가 있을 때만 editMessageMedia로 메시지 하나의 카드 사이를 ‘‹ ›’ 버튼으로 넘길 수 있습니다. ID는 카드에 직접 지정하거나 미디어 라이브러리 파일에서 얻습니다. 사진 하나라도 적절한 ID를 얻지 못하면 모든 카드를 개별 사진 메시지로 보냅니다. VK 등 다른 채널에서도 개별 메시지로 보냅니다. 각 카드의 설명과 버튼은 유지됩니다.
  • 지연: 다음 블록 전까지 몇 초간 기다립니다.
  • AI: 프롬프트에 따라 모델이 생성한 답.
  • 반응: 다른 반응을 호출하며 완료를 기다릴지 선택할 수 있습니다.

음성, GIF, 동영상 노트, 캐러셀도 다른 블록처럼 반응에서 사용되며 반응의 빠른 일괄 전송에 포함됩니다. 일괄 전송을 참고하세요.

블록은 끌어 순서를 바꿀 수 있습니다. 표시 방법은 순서대로 또는 답을 다양하게 보여주는 무작위입니다. 봇의 기본 메뉴는 그대로 두거나 새로 설정하거나 숨길 수 있습니다.

블록 옵션

텍스트 및 미디어 블록에는 고정, 무음, 전달 방지, 스포일러, 링크 미리보기 없음, N초 뒤 자동 삭제 설정이 있습니다.

인라인 버튼

블록에서 버튼 텍스트와 버튼 유형을 설정합니다.

  • 텍스트: 버튼 문구를 사용자의 답으로 전송합니다. Telegram과 VK에서는 답장 키보드여서 질문에 답하거나 텍스트로 반응을 시작할 수 있습니다. WhatsApp, Instagram, Messenger, 웹 위젯에서는 지속되는 키보드가 아닌 답장 버튼입니다.
  • 링크: URL을 엽니다.
  • 웹앱: Telegram Mini App을 엽니다. Mini App을 참고하세요.
  • 반응: 누르면 다른 반응을 시작합니다.
  • Inline query: 현재 채팅의 입력창에 ‘@bot query’를 넣거나 다른 채팅을 선택하게 합니다(switch_inline_query/switch_inline_query_current_chat). @BotFather의 /setinline에서 인라인 모드를 켠 Telegram 봇에만 사용할 수 있습니다. GetMyBot에는 answerInlineQuery가 구현되지 않아 버튼이 검색을 수행하지 않고 쿼리 문구만 준비합니다.
  • Prefilled text: https://t.me/<bot>?text=… 링크로 봇 채팅을 열어 입력창에 문구를 넣지만 전송하지는 않습니다(prefill).
  • Payment link: 필수 결제 URL을 엽니다. 결제는 ‘결제 생성’ 액션으로 만들며, Telegram 기본 청구서가 아닌 외부 결제 페이지로 이동합니다.
  • 알림: 클릭 시 텍스트만 보여주며 반응을 실행하거나 Carry 데이터를 전달하지 않습니다. Telegram에서는 최대 200자의 짧은 알림이나 팝업, VK에서는 팝업 없는 최대 90자의 배너입니다.

텍스트와 미리 채운 텍스트

할 일유형과 설정누른 결과
설문에서 ‘예’ 고르기‘텍스트’, 문구 ‘예’; 메시지가 답을 기다리도록 설정‘예’가 대화 단계로 전달됨
문의 문구 준비하기‘Prefilled text’, 문구 ‘문의하기’, 미리 채울 문구 ‘주문하고 싶어요’봇 채팅의 입력창에 초안이 나타나며 사용자가 고쳐서 직접 전송

버튼에 보이는 글자와 미리 채우는 문구는 서로 다른 필드입니다. 미리 채운 텍스트는 메시지를 보내거나 반응을 실행하지 않습니다.

반응 버튼의 클릭은 callback이라는 별도 이벤트로 봇에 전달됩니다. Inline query와 Prefilled text는 Telegram 앱 안에서만 동작하므로 callback이 없고 answerCallbackQuery와 Carry 데이터 전달도 지원하지 않습니다.

버튼 아이콘과 색상

버튼 문구 앞에 프리미엄 이모지를 표시할 수 있습니다. Premium emoji ID 필드에 icon_custom_emoji_id인 양의 64비트 정수를 입력하세요. 007은 7로 읽힙니다. 문자, 0, 음수, 너무 큰 숫자는 버려지고 버튼은 아이콘 없이 저장됩니다.

Telegram은 필요한 권한이 있는 봇에만 아이콘을 보여줍니다. Fragment를 통한 추가 사용자 이름이 있거나, 소유자가 Telegram Premium을 사용하면서 개인 채팅·그룹에 직접 보내는 경우입니다. 그 밖에는 일반 이모지로 대체하지 않고 아이콘을 무시합니다.

버튼 스타일은 기본(색상 없음), 주요(파랑), 성공(초록), 위험(빨강)입니다. 기술 필드 이름은 style입니다.

일회용 (누른 후 소멸) (single_use)은 버튼에 저장된 데이터를 한 번만 사용하게 합니다. 선택을 확정할 때 유용합니다. 버튼 문구 변경과 메시지 삭제는 클릭 동작에서 따로 설정합니다.

버튼 플래그

플래그는 켜고 끌 수 있는 추가 설정입니다.

  • 새 줄에서 시작: 버튼을 다음 줄에 놓습니다.
  • 전체 너비로 확장: 버튼을 별도 줄에 두고 다음 버튼도 새 줄에서 시작합니다.

대괄호가 버튼을 뜻하는 배치 예시:

한 줄:            [카탈로그] [도움말]

새 줄:            [카탈로그]
                  [도움말]

전체 너비:         [         도움말         ]

Telegram과 VK에서는 줄 배치와 색상을 사용할 수 있습니다. 편집기를 다시 열어도 줄 배치는 유지됩니다. Telegram 프리미엄 이모지는 연결 조건이 맞아야 합니다. ‘Telegram 내부에서 열기’ 플래그로 이 동작을 제어할 수는 없습니다. Bot API에 그런 설정이 없기 때문입니다.

채널 제한

블록이나 버튼에 사용할 연결을 선택합니다. 모든 채널을 선택하면 편집기는 공통 기능만 제공하고 지원하지 않는 유형은 저장할 수 없습니다.

  • Telegram: URL, Mini App, 반응, 알림/팝업, 줄 배치, 색상, 권한이 있을 때 사용자 지정 이모지.
  • VK: URL, 반응, snackbar, 줄 배치, 색상. VK Mini App과 VK Pay는 호환되는 VK 연결에서만 제공됩니다.
  • WhatsApp: 메시지 하나에 다른 버튼 없이 URL CTA 버튼 하나. 일반 답장 버튼은 최대 3개, 4~10개는 목록으로 표시됩니다. 문구는 20자 이하입니다. 줄 배치, 색상, Mini App, 알림은 지원하지 않습니다.
  • Instagram / Messenger: 현재 어댑터는 답장 버튼(quick replies)만 전달하고 문구는 최대 20자입니다. URL, Mini App, 알림, 줄 배치, 색상은 지원하지 않습니다.
  • 웹 위젯: URL과 답장 버튼을 지원하지만 줄 배치, 색상, 알림은 지원하지 않습니다.
  • Email: 결제 링크를 포함한 링크를 지원하며 답장 버튼과 알림은 사용할 수 없습니다.

목록에서 만들어지는 버튼의 열 개수는 줄 배치를 지원하는 채널에서만 설정할 수 있습니다. 다른 채널은 직접 배치합니다. 버튼 개수와 문구 길이 제한은 전송할 때 검사합니다.

클릭 후 동작

봇에 클릭을 전달하는 버튼은 채널이 지원하는 경우 메시지를 다른 텍스트나 반응 내용으로 바꾸기, 메시지 삭제, 레이블 추가, 매개변수 저장을 할 수 있습니다. 클릭 후 버튼 문구 자체 변경은 Telegram에서만 가능합니다. 예를 들어 ‘예약하기’를 ‘선택됨’으로 바꿉니다. VK에서 메시지 편집을 지원하더라도 버튼 문구 변경은 지원하지 않습니다.

Telegram은 answerCallbackQuery로 클릭 확인을 기다립니다. GetMyBot은 보통 이를 자동 전송해 버튼의 로딩 표시를 없앱니다. answerCallbackQuery 건너뛰기를 켜면 확인을 보내지 않습니다.

반응 버튼의 **Text on press (notification)**에는 ‘수업 선택 완료’ 같은 짧은 확인 문구를 적을 수 있습니다. Telegram은 최대 200자, VK는 최대 90자이며 치환 변수를 지원합니다. 보통 Telegram 채팅 위에 잠깐 표시됩니다. Telegram 전용 **Show as a popup (alert)**는 answerCallbackQuery의 show_alert를 사용해 팝업을 엽니다. 문구가 비어 있으면 로딩 표시만 없앱니다. answerCallbackQuery를 건너뛰면 문구나 팝업도 전송되지 않습니다.

버튼 데이터(Carry)

Carry는 버튼이 어떤 항목에 속하는지 기억하게 합니다. 코트와 드레스에 모두 ‘구매’ 버튼이 있다면 코트에는 product_id=101, 드레스에는 product_id=102를 저장하세요. 드레스 버튼을 누르면 다음 반응에서 {{ctx.product_id}}가 102가 됩니다.

편집기의 클릭 시 전송할 데이터에서 키 이름과 숫자·텍스트·치환 값 중 하나를 넣습니다. 봇은 데이터를 메시지 전송 시점에 기억하고 클릭하면 반응의 임시 데이터 ctx에 넣습니다. 버튼별 값은 독립적입니다.

버튼 데이터 유효 기간(초) (ttl_seconds, TTL)를 설정할 수 있습니다. 3600은 한 시간이고 0은 기본값인 30일입니다. 만료 후에는 데이터를 사용할 수 없습니다. 일회용 (누른 후 소멸) (single_use)은 첫 클릭 뒤 데이터를 지웁니다. 저장해 둔 가격은 카탈로그를 바꿔도 갱신되지 않으므로 결제 전에 상품 ID로 현재 가격을 다시 확인하세요. 동적 버튼과 매개변수를 참고하세요.

동적 버튼

상품이나 수업이 이미 목록에 있다면 버튼을 하나씩 만들 필요가 없습니다. 목록에서 동적 버튼 블록은 항목마다 버튼을 생성합니다. ctx에서 목록 위치, 항목 별칭, 한 줄의 버튼 수, 문구 템플릿을 설정하세요. {{item.name}}은 현재 상품 이름을 넣습니다. 동적 버튼과 매개변수를 참고하세요.

텍스트의 프리미엄 이모지

텍스트 블록의 프리미엄 이모지 서식 버튼은 <tg-emoji emoji-id="…">🙂</tg-emoji>를 넣습니다. Telegram Premium 사용자는 맞춤 이모지를, 다른 사용자는 태그 안의 대체 이모지를 봅니다. 블록이 HTML이든 Markdown이든 사용할 수 있습니다. 이모지 ID는 최대 32자리 숫자이며 getCustomEmojiStickers로 확인하거나 원하는 이모지가 있는 메시지를 @idstickerbot 같은 봇에 전달해 얻을 수 있습니다.

봇 링크와 미리 채운 텍스트

t.me/<bot>?start=<parameter> 링크는 Telegram에서 /start <parameter>를 시작합니다. 이 링크로 /start 없이 매개변수만 전달해 채팅을 여는 것은 불가능합니다.

  • 조용한 /start: /start 명령 트리거의 시작 링크 태그를 설정한 반응에서 ‘메시지 전송’ 액션을 블록 없이 둘 수 있습니다. /start에 대한 눈에 띄는 답은 없지만 태그는 이미 이벤트 컨텍스트에 있어 같은 반응의 조건과 액션에 쓸 수 있습니다.
  • Prefilled text: https://t.me/<bot>?text=<text> 링크는 버튼 또는 일반 링크 버튼으로 만들 수 있습니다. 채팅 입력창에 문구를 넣되 전송하지 않습니다. /start는 시작되지 않고 사용자가 직접 보냅니다.
  • 링크를 열자마자 ‘사용자 명의’로 자동 메시지 전송: Bot API에서는 불가능합니다. 봇은 사용자 대신 메시지를 보낼 수 없습니다. 가장 가까운 방법은 ?start= 딥 링크와 봇 명의로 원하는 글을 답하는 반응입니다.

예상 응답(대화 단계)

텍스트 블록은 사용자 응답을 기다릴 수 있습니다. 그러면 대화 단계가 되어 답이 올 때까지 흐름이 잠시 멈춥니다. 여러 단계를 잇으면 채팅 안에서 설문이나 단계별 입력을 만들 수 있습니다.

예상 콘텐츠 유형

텍스트, 선택지 중 하나, 사진, 동영상, 동영상 노트, 오디오, 문서, 음성 메시지, 위치, 연락처, 달력, 주사위 등을 기다릴 수 있습니다. 다른 유형이 오면 적절한 답으로 처리하지 않습니다.

텍스트 검증

텍스트 답은 전화번호, 이메일, 링크, 날짜, 시간 또는 수식 조건으로 확인할 수 있습니다. 전화번호를 기다리는 동안 임의의 글이 오면 거부하고 오류 메시지를 보여줍니다. 수식 검사는 확장 수식을 사용하며, 성공하면 빈 문자열, 거부하면 오류 문구를 반환해야 합니다.

응답 저장

사용자 답을 매개변수에 저장하면 {{param.key}} 치환 변수와 조건에서 사용할 수 있습니다. 이렇게 대화 단계가 작은 고객 프로필을 채웁니다.

오류, 알림, 타임아웃

  • 검증 오류 메시지: 답이 검사에 실패하면 보여줄 내용.
  • 알림: 사용자가 답하지 않으면 보낼 내용.
  • 시간 초과 시 대기 종료: 얼마 뒤 기다리기를 멈출지 정합니다. 만료되면 다른 반응을 실행해 설문을 종료할 수 있습니다. 반응 연결에는 해당 반응이 ‘응답 대기 시간 초과’로, 실제 답에 대한 반응은 ‘예상 응답’으로 표시됩니다.

명령으로 단계 나가기

/cancel 또는 러시아어 그대로의 단어 отмена는 응답 대기를 해제하고 Отменено.로 답합니다. 취소 반응을 설정했다면 그 반응을 실행합니다. 다른 명령은 기본적으로 일반 텍스트 답으로 취급되어 검증을 거칩니다. 봇 명령(예: /start)이 대기를 중단 (escape_on_command)하도록 설정하면 설문 중 /start 같은 명령이 조용히 대기를 끝내고 평소처럼 실행됩니다. 한국어 ‘취소’는 기본 제공 취소 명령이 아닙니다.

치환 변수

치환 버튼으로 발신자({{first_name}}, {{username}}, {{user_id}}), 이벤트({{text}}, {{chat_id}}, {{datetime}}), 매개변수({{param.key}})를 넣을 수 있습니다. 전체 목록과 수식은 치환 변수와 수식을 참고하세요.

봇 메뉴 버튼

Menu button 액션은 일반 메뉴, 명령 목록, 텍스트와 URL이 있는 Mini App 버튼을 선택합니다. 현재 채팅 또는 봇의 공통 설정에 적용할 수 있습니다. 예를 들어 한 고객에게만 개인용 Mini App을 설정할 수 있으며 제공 여부는 채널 기능에 따라 다릅니다.

다음 단계