텔레그램 링크 형식

각 행에는 일반 웹 링크, iPhone URL 스킴 및 Android 형식이 표시됩니다. 대문자 자리 표시자를 실제 값으로 바꾸세요.

콘텐츠웹 링크iPhone (URL 스킴)안드로이드
채널, 그룹 또는 사용자https://t.me/USERNAMEtg://resolve?domain=USERNAMEintent://t.me/USERNAME#Intent;package=org.telegram.messenger;scheme=https;end
특정 직책https://t.me/CHANNEL/123tg://resolve?domain=CHANNEL&post=123intent://t.me/CHANNEL/123#Intent;package=org.telegram.messenger;scheme=https;end
시작 매개변수가 있는 봇https://t.me/BOTNAME?start=PAYLOADtg://resolve?domain=BOTNAME&start=PAYLOADintent://t.me/BOTNAME?start=PAYLOAD#Intent;package=org.telegram.messenger;scheme=https;end
비공개 초대https://t.me/+INVITE_CODEtg://join?invite=INVITE_CODEintent://t.me/+INVITE_CODE#Intent;package=org.telegram.messenger;scheme=https;end
Note

tg:// 방문자에게 "텔레그램에서 열기"를 누르라는 t.me 웹페이지를 건너뛰었습니다.

Not an official API

대부분의 앱은 공식적으로 URL 스킴을 문서화하지 않습니다. 아래 형식은 DSLink가 오늘날 실제 운영에서 사용하는 형식이지만, 앱 업데이트로 인해 변경될 수 있습니다 — 자체 앱이나 사이트에 스킴을 하드코딩하기 전에 실제 기기에서 테스트하세요.

웹사이트에서 그 계획을 사용하기

URL 스킴은 바로 링크에 사용할 수 있습니다. 아이폰에서는, 사파리가 앱 전환 전에 방문자에게 확인을 요청합니다:

<a href="tg://resolve?domain=USERNAME">Open in Telegram</a>

안드로이드에서는 인텐트 자체에 웹 대체(fallback)를 추가할 수 있습니다. 앱이 없으면 실패하는 대신 Chrome이 대체 URL을 엽니다:

intent://t.me/USERNAME#Intent;package=org.telegram.messenger;scheme=https;S.browser_fallback_url=https%3A%2F%2Ft.me%2FUSERNAME;end

두 가지 제한이 모든 곳에 적용됩니다. 앱이 설치되어 있지 않으면 일반 스킴은 아무런 유용한 동작을 하지 못하고 iOS는 오류를 보여줍니다. 그리고 Instagram, TikTok 또는 X와 같은 앱 내 내장 브라우저는 커스텀 스킴을 차단하거나 무시하는데, 바로 대부분의 링크가 클릭되는 곳이기도 합니다.

DSLink 스마트 링크는 이 모든 것을 하나의 짧은 URL로 감쌉니다. 휴대폰에서는 기기에 맞는 앱 형식을 시도하고, 앱이 없으면 텔레그램 웹페이지로 돌아가며, 데스크톱 방문자를 바로 웹사이트로 안내합니다. 모든 곳에서 하나의 링크를 공유하고 클릭 통계를 가장 먼저 확인할 수 있습니다.

자주 묻는 질문

tg:// URL 방식이란 무엇인가요?

tg://는 Telegram 앱이 등록하는 스킴입니다. tg://resolve?domain=NAME은 채널, 그룹, 사용자 또는 봇을 엽니다; tg://join?invite=CODE는 비공개 초대를 엽니다.

Telegram 봇에 시작 매개변수를 전달할 수 있나요?

예: tg://resolve?domain=BOTNAME&start=PAYLOAD. 페이로드에는 문자, 숫자, 밑줄 및 하이픈이 포함될 수 있습니다.

Telegram 앱이 설치되어 있지 않으면 어떻게 되나요?

단순한 URL 스킴은 실패합니다: iOS에서는 오류가 표시되며 아무 것도 열리지 않습니다. 항상 웹 폴백과 함께 사용하세요 — 안드로이드에서는 인텐트의 S.browser_fallback_url과 함께 사용하거나, 웹 페이지로 자동 폴백되는 DSLink 스마트 링크를 사용하세요.