Telegram

Telegram Mini App과 봇을 위한 오퍼월.

사용자는 오퍼를 완료해 코인을 받고, 퍼블리셔는 완료된 오퍼마다 수익을 얻습니다. Mini App은 웹 페이지이므로 SDK가 필요 없습니다. 서버가 사용자별 링크에 서명하고 서명된 postback으로 코인을 적립합니다.

  • SDK 불필요Mini App은 웹 페이지입니다
  • 맞춤 오퍼국가, 기기에 맞춤
  • 서명됨모든 적립에 postback

Telegram Mini App이나 봇에 오퍼월을 추가하는 방법은?

Mini App의 initData를 백엔드로 보내 봇 토큰으로 검증하세요. Telegram 사용자를 자체 계정 ID에 연결하고, 서버에서 서명된 오퍼월 링크를 만드세요. 사용자가 Earn을 탭하면 Mini App이 Telegram.WebApp.openLink로 링크를 열거나, 봇이 개인 채팅에서 버튼으로 보냅니다. 백엔드는 서명된 postback이 도착했을 때만 코인을 적립하고, 취소 시 회수합니다.

Telegram에서의 작동 방식.

첫 클릭부터 내 화폐로 지급되는 리워드까지, 다섯 단계로.

  1. 사용자가 Earn을 탭

    Mini App 안에서, 또는 /earn이나 채널의 ?start= 링크로 봇과의 개인 채팅이 열린 후에.

  2. 서버가 사용자 확인

    봇 토큰으로 initData를 검증하고, 사용자의 계정을 찾은 다음, 해당 계정 ID로 오퍼월 링크에 서명합니다.

  3. 오퍼월이 열립니다

    openLink는 Mini App을 열어 둔 채 사용자 브라우저에서 오퍼월을 엽니다. 오퍼는 사용자의 국가와 기기에 맞춰집니다.

  4. 사용자가 오퍼 완료

    앱을 설치하거나, 가입하거나, 게임에서 특정 레벨에 도달합니다. 광고주가 완료된 각 단계를 확인합니다.

  5. 코인이 잔액에 반영

    서명된 postback이 서버에 도착하면 서버가 거래 ID당 한 번 코인을 적립합니다. Mini App은 잔액을 다시 불러옵니다.

Telegram 운영자가 Moonetix를 추가하는 이유.

내 화폐와 내 사용자를 중심으로 만든 제휴 네트워크.

  • Mini App에 SDK 불필요

    Mini App은 자체 웹 페이지이므로 서명된 오퍼월 링크만으로 연동이 끝납니다. 일반 봇에서도 똑같이 작동합니다.

  • 자체 코인, 자체 비율

    앱마다 화폐 이름과 아이콘, $1당 단위, 사용자 몫, 반올림을 설정하면, 오퍼 보상이 탭 게임이나 봇에서 이미 쓰는 코인으로 지급됩니다.

  • 서버 측 잔액에 맞게 설계

    모든 적립과 취소는 서명된 postback으로 서버에 전달됩니다. 코인은 Mini App을 거치지 않으므로 변조된 클라이언트가 코인을 추가할 수 없습니다.

  • Stars와 함께 사용 가능

    결제하는 사용자는 Stars로 코인을 살 수 있고, 결제하지 않는 사용자는 오퍼로 같은 코인을 얻을 수 있습니다. Stars vs 오퍼월을 참고하세요.

  • 수익을 낸 게시물 확인

    ?start= 페이로드에 유입 경로를 넣어 sub ID로 전달하면, sub ID, 국가, 오퍼별 클릭, 전환, 취소를 확인할 수 있습니다.

  • 오퍼월의 부정행위 필터

    VPN, 프록시, Tor, 데이터센터 네트워크 사용자는 오퍼월이 차단되며, 트래픽 품질 리포트에서 사용자의 전환 현황을 확인할 수 있습니다.

채널 게시물에서 개인 링크까지.

서명된 링크는 사용자 한 명의 것이므로 공개 게시물에 넣지 마세요. 게시물은 봇을 열고, 봇이 각 사용자에게 개인 링크를 보냅니다.

  1. 채널 게시물t.me/yourbot?start=earn으로 연결되는 버튼
  2. 내 봇개인 채팅에서 /start earn 수신
  3. 내 서버해당 사용자용 오퍼월 링크에 서명
  4. Mini App 또는 브라우저사용자가 오퍼를 완료하고 코인을 받습니다
init-data.js
import crypto from 'node:crypto';
 
export function isValidInitData(initData, botToken) {
  const params = new URLSearchParams(initData);
  const hash = params.get('hash');
  if (!hash) return false;
  params.delete('hash');
 
  const dataCheck = [...params.entries()]
    .sort(([a], [b]) => (a < b ? -1 : 1))
    .map(([k, v]) => `${k}=${v}`)
    .join('\n');
 
  const secret = crypto.createHmac('sha256', 'WebAppData')
    .update(botToken).digest();
  const expected = crypto.createHmac('sha256', secret)
    .update(dataCheck).digest('hex');
  return expected.length === hash.length &&
    crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(hash));
}
  • 서버에서 initData 확인

    Telegram Mini Apps 문서는 initData를 봇 토큰으로 검증하고 initDataUnsafe는 절대 신뢰하지 말라고 안내합니다.

  • 오래된 데이터 거부

    또한 auth_date를 현재 시간과 비교해 오래된 데이터 사본이 재사용되지 않도록 하세요.

  • 그다음 오퍼월 링크에 서명

    서명된 오퍼월 링크에는 해당 Telegram 사용자에 대한 자체 계정 ID를 사용하고, 코인은 postback으로만 적립하세요.

출처: Telegram Mini Apps 문서, 2026년 11월 5일 확인. 전체 가이드: Telegram Mini App의 오퍼월.

Telegram 규칙을 지키세요.

오퍼월을 허용하거나 금지한다고 명시한 Telegram 규칙은 찾지 못했습니다. 따라서 이 내용은 승인이 아니라 적용되는 규칙으로 읽어 주세요. Telegram은 약관을 변경하고 봇이나 Mini App을 삭제할 수 있습니다.

권장

  • 서버에서 봇 토큰으로 initData를 검증하고, auth_date를 확인하며, initDataUnsafe나 클라이언트가 보내는 사용자 ID는 절대 신뢰하지 마세요.
  • ?start= 파라미터로 채널 게시물을 봇에 연결하고, 봇이 개인 채팅에서 해당 사용자의 개인 서명 링크로 답하게 하세요.
  • 개발자 약관에 따라, IP 주소, 기기, 오퍼 활동이 오퍼월 제공업체에 전달된다는 내용의 개인정보 처리방침을 @BotFather에 게시하세요.
  • 봇이나 Mini App 안에서 코인이나 부스트를 판매할 때는 Telegram Stars만 사용하세요. 오퍼로 코인을 받는 것은 판매가 아니지만, 코인을 파는 것은 판매입니다.

금지

  • 서명된 오퍼월 링크를 채널이나 그룹에 게시하지 마세요. 링크는 생성 대상 사용자에게 적립되므로, 각 사용자는 개인 채팅에서 자신의 링크를 받아야 합니다.
  • Start를 누른 적 있는 모든 사용자에게 오퍼를 일괄 발송하지 마세요. Telegram 개발자 약관은 원치 않는 메시지로 사용자에게 스팸을 보내는 것을 금지합니다.
  • 토큰 에어드롭이나 사용자가 도달할 수 없는 수입을 약속하지 마세요. 5.2항은 달성할 수 없는 결과로 사용자를 오도해 행동하게 하는 것을 금지합니다.
  • Mini App 사용자를 TON 기반이 아닌 암호화폐로 연결하지 마세요. 7.4항은 TON 기반이 아닌 암호화 자산의 홍보를 금지하므로 오퍼 페이지에서 해당 오퍼를 숨기세요.

출처, 2026년 11월 5일 확인: Telegram Bot Platform Developer Terms, Telegram Mini Apps documentation, Telegram bot deep linking. 플랫폼 규칙은 바뀔 수 있으므로 출시 전에 확인하세요.

네 단계로 설정하세요.

  1. 퍼블리셔로 신청하기

    신청할 때 Mini App, 봇 또는 채널에 대해 알려 주세요. 모든 신청은 직접 검토되며, 승인되면 추가하는 앱이 즉시 활성화됩니다.

  2. Mini App 또는 봇 추가

    실시간 미리보기에서 코인 이름과 아이콘, 환율, 사용자 몫, 오퍼월 디자인을 설정하세요. App ID와 link hash salt는 Mini App이 아니라 서버 설정에 복사하세요.

  3. 서버에서 링크 서명

    initData를 검증한 후 자체 계정 ID로 링크를 만드세요. 탭하면 openLink로 열거나, 봇의 개인 채팅에서 URL 버튼으로 보내세요.

  4. postback으로 적립한 뒤 테스트

    Postback URL을 저장하고, status 1이면 거래 ID당 한 번 적립하고, status 2면 취소하세요. 그다음 일반 연결에서 처음부터 끝까지 테스트하세요.

얼마를 벌 수 있을까요?

오디언스 규모에 맞게 슬라이더를 움직이고 가정값을 조정하세요. 비율은 예시일 뿐 보장되지 않습니다. 배치 위치, 국가, 기기에 따라 결과가 달라집니다.

전체 계산기 열기

예상 수익 계산하기

슬라이더를 월간 사용자 수에 맞추세요

10,000
5001M
  • 오퍼월 열기 8%
  • 오퍼 완료 10%
  • 완료 건당 $1.20
예상 월 수익 $93.12
연간 $1,117.44사용자 1,000명당 $9.31

예시 수치일 뿐 보장되지 않습니다. 배치 위치, 국가, 기기에 따라 결과가 달라집니다.

가정값 조정

Telegram 가이드.

Moonetix Academy의 단계별 가이드.

Telegram Mini App에 오퍼월 추가하기 Telegram Mini App 수익화를 위한 오퍼월: 서버에서 initData를 검증하고, 서버에서 서명된 오퍼월 링크를 만들고, Telegram.WebApp.openLink로 열고, postback으로 사용자에게 적립하며, 출시 전에 Telegram 개발자 약관을 확인하세요. 10분 분량 Telegram 탭투언 게임 만드는 방법(2026) 테스트를 거친 Node.js 서버 로직으로 Telegram Mini App 탭투언 클리커 게임을 만드세요: initData 검증, 일괄 탭 처리, 서버 측 에너지, 오토클릭 방지 검사, 업그레이드, 추천, 그리고 토큰을 약속하는 대신 가상 포인트를 사용하는 수익화. 12분 분량 2026년 Telegram 봇 수익화 방법 Telegram 봇이 수익을 내는 검증된 모든 방법: Stars 결제와 구독, 결제 대행사를 통한 실물 상품 판매, Telegram 광고 수익, 제휴 프로그램, 오퍼월, 부분 유료화(freemium) 모델과 스폰서, 그리고 각 방법에 적용되는 규칙. 10분 분량 Telegram Stars vs 오퍼월: Telegram 채널로 수익 내기 Telegram Stars는 결제하는 독자에게서 수익을 내고, 오퍼월은 광고주에게서 수익을 내며 독자도 리워드를 받을 수 있게 합니다. 각각의 작동 방식, Stars에 관한 Telegram의 현재 약관, 나란히 비교, 둘을 안전하게 함께 운영하는 방법을 알아보세요. 7분 분량 Telegram 채널 수익화 방법(무료 및 유료) 50% 광고 수익 공유부터 유료 게시물, Star 구독, 추천 게시물까지 Telegram 자체 수익화 도구와 함께 스폰서십, 제휴 링크, 자체 사이트의 리워드 프로그램까지 다룹니다. 7분 분량 Telegram Mini Apps용 오퍼월 고르기: 확인할 사항 Telegram Mini Apps와 봇 안에서 오퍼월이 작동하는 방식, 선택 전에 확인할 여덟 가지, 리워드에 영향을 주는 Telegram 규칙, 그리고 Mini App의 수익 계산 예시. 7분 분량

Telegram 관련 질문

Telegram 운영자가 Moonetix를 추가하기 전에 묻는 질문.

아직 궁금한 점이 있나요? 문의하기

Telegram은 Mini App의 오퍼월을 허용하나요?

Telegram의 개발자 약관이나 Mini App 약관에서 오퍼월을 허용하거나 금지한다고 명시한 규칙은 찾지 못했습니다. 개인정보, 스팸, 사용자 오도, Stars 결제, TON 전용 암호화폐에 관한 규칙은 적용되므로 출시 전에 최신 Bot Platform Developer Terms를 읽어 보세요.

Telegram Mini App 오퍼월에 SDK가 필요한가요?

아니요. Mini App은 웹 페이지이므로 서버가 오퍼월 링크에 서명하고 Mini App이 이를 엽니다. Moonetix SDK는 네이티브 Android, iOS, Unity, Flutter, React Native 앱용입니다.

Mini App 없는 Telegram 봇도 오퍼월을 사용할 수 있나요?

네. /earn 명령어가 개인 채팅에서 사용자의 서명된 링크가 담긴 URL 버튼으로 응답하면, 오퍼월이 브라우저에서 열립니다. 봇 백엔드가 잔액을 저장하고 postback으로 적립합니다.

오퍼월로 Telegram 채널을 어떻게 수익화하나요?

채널에는 오퍼월을 둘 수 없습니다. 게시물을 ?start= 파라미터로 봇에 연결하면, 봇이 각 독자에게 개인별 서명된 링크를 보냅니다. Telegram 채널 수익화에서는 Telegram 자체 프로그램도 다룹니다.

탭투언 게임은 오퍼월을 어떻게 활용하나요?

오퍼는 플레이어가 탭으로 모으는 것과 같은 포인트로 지급되며, 서버가 서명된 postback으로 적립합니다. 탭투언 가이드에서 설명하듯 토큰을 약속하기보다 명확한 약관과 함께 포인트를 가상 자산으로 유지하세요.

openLink와 iframe 중 무엇을 사용해야 하나요?

openLink 호출은 사용자 브라우저에서 오퍼월을 열고 Mini App은 열린 상태로 유지합니다. iframe은 앱에 등록한 웹사이트에서만 로드되며, Telegram 웹 클라이언트는 Mini App을 프레임 안에 표시하므로 그곳에서는 실패할 수 있습니다.

Stars로 코인을 판매하면서 오퍼월도 제공할 수 있나요?

네, 많은 봇이 둘 다 합니다. 봇이나 Mini App에서 판매하는 디지털 상품은 Telegram Stars로 결제해야 하며, 오퍼로 받은 코인은 postback으로 같은 잔액에 적립됩니다.

일부 사용자에게 오퍼가 표시되지 않는 이유는 무엇인가요?

오퍼는 사용자의 국가와 기기에 따라 달라지며, VPN, 프록시, Tor, 데이터센터 네트워크 사용자는 오퍼월이 차단됩니다. 최종 사용자는 16세 이상이어야 하며, 18세 미만은 보호자 동의가 필요합니다.

트래픽을 수익으로 바꾸세요.

무료 퍼블리셔 계정을 만들고, 사용자가 웹사이트, 앱, 게임, 커뮤니티에서 완료하는 모든 오퍼로 수익을 올리세요.

전 세계 타기팅
더 보기
로그인