Telegramリンク形式
各行には通常のウェブリンク、iPhoneのURLスキーム、Android形式が表示されます。大文字のプレースホルダーは実際の値に置き換えてください。
| コンテンツ | ウェブリンク | iPhone（URLスキーム） | アンドロイド |
|---|---|---|---|
| チャンネル、グループ、またはユーザー | https://t.me/USERNAME | tg://resolve?domain=USERNAME | intent://t.me/USERNAME#Intent;package=org.telegram.messenger;scheme=https;end |
| 特定の投稿 | https://t.me/CHANNEL/123 | tg://resolve?domain=CHANNEL&post=123 | intent://t.me/CHANNEL/123#Intent;package=org.telegram.messenger;scheme=https;end |
| 開始パラメータ付きボット | https://t.me/BOTNAME?start=PAYLOAD | tg://resolve?domain=BOTNAME&start=PAYLOAD | intent://t.me/BOTNAME?start=PAYLOAD#Intent;package=org.telegram.messenger;scheme=https;end |
| プライベート招待 | https://t.me/+INVITE_CODE | tg://join?invite=INVITE_CODE | intent://t.me/+INVITE_CODE#Intent;package=org.telegram.messenger;scheme=https;end |
tg:// は、訪問者に「Telegramで開く」をタップさせるt.meウェブページをスキップします。
ほとんどのアプリは URL スキームを公式に文書化していません。 以下の形式は DSLink が現在実稼働環境で使用している形式ですが、アプリの更新により形式が変更される可能性があります。スキームを独自のアプリまたはサイトにハードコーディングする前に、実際のデバイスでテストしてください。
ウェブサイトでのスキームの使用
URL スキームはリンクに直接挿入できます。 iPhone では、Safari はアプリを切り替える前に訪問者に確認を求めます。
<a href="tg://resolve?domain=USERNAME">Open in Telegram</a>Android では、インテント自体に Web フォールバックを追加できます。 アプリが見つからない場合、Chrome は失敗せずにフォールバック URL を開きます。
intent://t.me/USERNAME#Intent;package=org.telegram.messenger;scheme=https;S.browser_fallback_url=https%3A%2F%2Ft.me%2FUSERNAME;endどこでも 2 つの制限が適用されます。 アプリがインストールされていない場合、裸のスキームは何も役に立ちません。iOS ではエラーが表示されます。 また、Instagram、TikTok、X などのアプリ内の組み込みブラウザーはカスタム スキームをブロックまたは無視することが多く、まさにほとんどのリンクがタップされる場所です。
コード不要の代替手段: スマート リンク
DSLinkスマートリンクは、これらすべてを1つの短いURLにまとめます。スマートフォンでは、デバイスに適したアプリ形式を試し、アプリがない場合はTelegramウェブページにフォールバックし、デスクトップの訪問者は直接ウェブサイトに送ります。1つのリンクをどこにでも共有でき、さらにクリック統計も取得できます。
よくある質問
tg:// URLスキームとは何ですか？
tg:// は Telegram アプリが登録するスキームです。tg://resolve?domain=NAME はチャンネル、グループ、ユーザー、またはボットを開きます；tg://join?invite=CODE はプライベート招待を開きます。
Telegram ボットに start パラメータを渡すことはできますか？
はい：tg://resolve?domain=BOTNAME&start=PAYLOAD。ペイロードには文字、数字、アンダースコア、ハイフンを含めることができます。
Telegram アプリがインストールされていない場合はどうなりますか？
裸の URL スキームは失敗します。iOS ではエラーが表示され、何も開きません。 常に Web フォールバックと組み合わせてください。Android ではインテントに S.browser_fallback_url を指定するか、Web ページに自動的にフォールバックする DSLink スマート リンクを使用してください。