텔레그램 첨부 메뉴에 봇 넣기

첨부 메뉴 연동이란

대화 입력창의 클립(첨부) 버튼을 누르면 사진·파일·위치 같은 항목이 뜹니다. 봇은 이 메뉴, 또는 앱의 옆 메뉴(사이드 메뉴)에 자기 미니 앱을 여는 항목을 넣을 수 있습니다. 사용자는 어떤 대화를 보다가든 클립 버튼에서 바로 그 미니 앱을 엽니다.

사용자가 추가하는 흐름

1. 사용자가 봇의 첨부 메뉴 설치 링크를 엽니다.
2. 앱이 '이 봇을 첨부 메뉴에 추가할까요' 하고 묻습니다. 처음이면 미니 앱 이용 약관과 안내에 동의해야 합니다.
3. 봇이 요청했다면 메시지를 보내도 되는지(쓰기 허락)를 함께 묻습니다. 허락하면 봇이 그 사용자에게 먼저 메시지를 보낼 수 있습니다.
4. 이후 클립 버튼(또는 옆 메뉴)에 봇 항목이 생기고, 누르면 미니 앱이 열립니다.

링크로 바로 열기

설치된 첨부 메뉴 미니 앱은 링크로 바로 열 수 있습니다.

https://t.me/sample_help_bot?startattach=coupon_10

• startattach 뒤의 값은 미니 앱에 start_param 으로 전달됩니다 — 어떤 화면부터 보여 줄지 정할 때 씁니다.
• 어느 대화에서 열지 사용자에게 고르게 하려면 choose 로 대화 종류(사용자·봇·그룹·채널)를 지정합니다.

미니 앱 쪽에서 할 일

첨부 메뉴로 연 미니 앱은 사용자 정보(initData)를 받습니다. 지금 보고 있던 대화와 관련된 정보가 함께 올 수 있으니, 서버에서 서명을 검사한 뒤에 씁니다 — 미니 앱 사용자 확인. 미니 앱을 처음 만드는 순서는 미니 앱 만들기 입문에 있습니다.

입구	누가 쓸 수 있나	사용자가 여는 곳
메뉴 버튼	모든 봇	봇 대화 입력창 옆
인라인 버튼·직접 링크	모든 봇	메시지 버튼, t.me 링크
첨부 메뉴·옆 메뉴	주요 광고주 봇(테스트 서버는 모두)	어느 대화든 클립 버튼