All pages
Powered by GitBook
1 of 20

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Telegram Bridge

ОписаниС

Π‘ΠΈΠ±Π»ΠΈΠΎΡ‚Π΅ΠΊΠ° для Ρ€Π°Π±ΠΎΡ‚Ρ‹ с Telegram WebApp API, ΠΏΡ€Π΅Π΄ΠΎΡΡ‚Π°Π²Π»ΡΡŽΡ‰Π°Ρ ΡƒΠ΄ΠΎΠ±Π½Ρ‹ΠΉ интСрфСйс для взаимодСйствия с функциями Telegram Mini Apps. Π Π΅Π°Π»ΠΈΠ·ΠΎΠ²Π°Π½Π° Π½Π° TypeScript с ΠΏΠΎΠ΄Π΄Π΅Ρ€ΠΆΠΊΠΎΠΉ строгой Ρ‚ΠΈΠΏΠΈΠ·Π°Ρ†ΠΈΠΈ.

Полная докумСнтация

ΠžΡΠ½ΠΎΠ²Π½Ρ‹Π΅ возмоТности

  • Π£ΠΏΡ€Π°Π²Π»Π΅Π½ΠΈΠ΅ внСшним Π²ΠΈΠ΄ΠΎΠΌ WebApp (Ρ†Π²Π΅Ρ‚Π°, ΠΊΠ½ΠΎΠΏΠΊΠΈ)

  • Π Π°Π±ΠΎΡ‚Π° с ΠΏΠ»Π°Ρ‚Π΅ΠΆΠ°ΠΌΠΈ ΠΈ инвойсами

  • ВзаимодСйствиС с QR-сканСром

  • Π£ΠΏΡ€Π°Π²Π»Π΅Π½ΠΈΠ΅ Π±ΡƒΡ„Π΅Ρ€ΠΎΠΌ ΠΎΠ±ΠΌΠ΅Π½Π°

Установка

ΠŸΠΎΠ΄Π΄Π΅Ρ€ΠΆΠΊΠ°

Если Ρƒ вас Π²ΠΎΠ·Π½ΠΈΠΊΠ»ΠΈ вопросы ΠΈΠ»ΠΈ ΠΏΡ€ΠΎΠ±Π»Π΅ΠΌΡ‹:

Бпособы связи

  • (Для Π±Π°Π³Ρ€Π΅ΠΏΠΎΡ€Ρ‚ΠΎΠ² ΠΈ запросов Ρ„ΡƒΠ½ΠΊΡ†ΠΈΠΉ)

  • ΠΠ°ΠΏΠΈΡΠ°Ρ‚ΡŒ Π² Telegram: (Быстрая ΠΏΠΎΠΌΠΎΡ‰ΡŒ Π² Ρ€Π΅Π°Π»ΡŒΠ½ΠΎΠΌ Π²Ρ€Π΅ΠΌΠ΅Π½ΠΈ)

ΠžΠ±Ρ€Π°Π±ΠΎΡ‚ΠΊΠ° систСмных событий Telegram
ДокумСнтация API
Π‘ΠΎΠ·Π΄Π°Ρ‚ΡŒ issue Π² GitHub
@apiteam_help
npm install @apiteam/twa-bridge

Π€ΡƒΠ½ΠΊΡ†ΠΈΠΈ

setBackgroundColor

ΠœΠ΅Ρ‚ΠΎΠ΄, ΠΊΠΎΡ‚ΠΎΡ€Ρ‹ΠΉ устанавливаСт Ρ†Π²Π΅Ρ‚ Ρ„ΠΎΠ½Π° прилоТСния Π² Ρ„ΠΎΡ€ΠΌΠ°Ρ‚Π΅ #RRGGBB. Π’Ρ‹ Ρ‚Π°ΠΊΠΆΠ΅ ΠΌΠΎΠΆΠ΅Ρ‚Π΅ ΠΈΡΠΏΠΎΠ»ΡŒΠ·ΠΎΠ²Π°Ρ‚ΡŒ ΠΊΠ»ΡŽΡ‡Π΅Π²Ρ‹Π΅ слова `bg_color` ΠΈ `secondary_bg_color`.

web_app_set_background_color

ΠŸΠΎΠ΄Π΄Π΅Ρ€ΠΆΠΊΠ°

Минимальная вСрсия Telegram API: 6.1+

  • Telegram Web

  • Telegram Desktop

  • Telegram Mobile (iOS/Android)

ИспользованиС

ΠŸΠ°Ρ€Π°ΠΌΠ΅Ρ‚Ρ€Ρ‹

ΠŸΠ°Ρ€Π°ΠΌΠ΅Ρ‚Ρ€
Π’ΠΈΠΏ
ОписаниС
ΠŸΡ€ΠΈΠΌΠ΅Ρ€Ρ‹

Π’ΠΎΠ·Π²Ρ€Π°Ρ‰Π°Π΅ΠΌΠΎΠ΅ Π·Π½Π°Ρ‡Π΅Π½ΠΈΠ΅

БистСмныС Ρ†Π²Π΅Ρ‚Π°

Π—Π½Π°Ρ‡Π΅Π½ΠΈΠ΅
ОписаниС

requestEmojiStatus

ΠœΠ΅Ρ‚ΠΎΠ΄, ΠΊΠΎΡ‚ΠΎΡ€Ρ‹ΠΉ ΠΏΠΎΠΊΠ°Π·Ρ‹Π²Π°Π΅Ρ‚ собствСнноС Π²ΡΠΏΠ»Ρ‹Π²Π°ΡŽΡ‰Π΅Π΅ ΠΎΠΊΠ½ΠΎ, Π·Π°ΠΏΡ€Π°ΡˆΠΈΠ²Π°ΡŽΡ‰Π΅Π΅ Ρ€Π°Π·Ρ€Π΅ΡˆΠ΅Π½ΠΈΠ΅ для Π±ΠΎΡ‚Π° Π½Π° ΡƒΠΏΡ€Π°Π²Π»Π΅Π½ΠΈΠ΅ статусом эмодзи ΠΏΠΎΠ»ΡŒΠ·ΠΎΠ²Π°Ρ‚Π΅Π»Ρ.

web_app_request_emoji_status_access

downloadFile

ΠœΠ΅Ρ‚ΠΎΠ΄, ΠΊΠΎΡ‚ΠΎΡ€Ρ‹ΠΉ ΠΎΡ‚ΠΎΠ±Ρ€Π°ΠΆΠ°Π΅Ρ‚ собствСнноС Π²ΡΠΏΠ»Ρ‹Π²Π°ΡŽΡ‰Π΅Π΅ ΠΎΠΊΠ½ΠΎ, ΠΏΡ€Π΅Π΄Π»Π°Π³Π°ΡŽΡ‰Π΅Π΅ ΠΏΠΎΠ»ΡŒΠ·ΠΎΠ²Π°Ρ‚Π΅Π»ΡŽ Π·Π°Π³Ρ€ΡƒΠ·ΠΈΡ‚ΡŒ Ρ„Π°ΠΉΠ».

web_app_request_file_download

openLink

ΠœΠ΅Ρ‚ΠΎΠ΄, ΠΊΠΎΡ‚ΠΎΡ€Ρ‹ΠΉ ΠΎΡ‚ΠΊΡ€Ρ‹Π²Π°Π΅Ρ‚ ссылку Π²ΠΎ внСшнСм Π±Ρ€Π°ΡƒΠ·Π΅Ρ€Π΅. Мини-ΠΏΡ€ΠΈΠ»ΠΎΠΆΠ΅Π½ΠΈΠ΅ Π½Π΅ Π±ΡƒΠ΄Π΅Ρ‚ Π·Π°ΠΊΡ€Ρ‹Ρ‚ΠΎ.

web_app_open_link

setupSwipeBehavior

ΠœΠ΅Ρ‚ΠΎΠ΄, ΠΊΠΎΡ‚ΠΎΡ€Ρ‹ΠΉ Π²ΠΊΠ»ΡŽΡ‡Π°Π΅Ρ‚ ΠΈ Π²Ρ‹ΠΊΠ»ΡŽΡ‡Π°Π΅Ρ‚ Π²Π΅Ρ€Ρ‚ΠΈΠΊΠ°Π»ΡŒΠ½Ρ‹Π΅ свайпы для закрытия ΠΈΠ»ΠΈ сворачивания Mini App.

web_app_setup_swipe_behavior

color

string

Π¦Π²Π΅Ρ‚ Ρ„ΠΎΠ½Π°

"#ff0000", "bg_color"

bg_color

Основной Ρ„ΠΎΠ½

secondary_bg_color

Π’Ρ‚ΠΎΡ€ΠΈΡ‡Π½Ρ‹ΠΉ Ρ„ΠΎΠ½

ΠŸΠΎΠ΄Π΄Π΅Ρ€ΠΆΠΊΠ°

Минимальная вСрсия Telegram API: 8.0+

  • Telegram Web

  • Telegram Desktop

  • Telegram Mobile (iOS/Android)

ИспользованиС

Π’ΠΎΠ·Π²Ρ€Π°Ρ‰Π°Π΅ΠΌΠΎΠ΅ Π·Π½Π°Ρ‡Π΅Π½ΠΈΠ΅

const result = await bridgeRequestEmojiStatus({})
ΠŸΠΎΠ΄Π΄Π΅Ρ€ΠΆΠΊΠ°

Минимальная вСрсия Telegram API: 8.0+

  • Telegram Web

  • Telegram Desktop

  • Telegram Mobile (iOS/Android)

ИспользованиС

ΠŸΠ°Ρ€Π°ΠΌΠ΅Ρ‚Ρ€Ρ‹

ΠŸΠ°Ρ€Π°ΠΌΠ΅Ρ‚Ρ€
Π’ΠΈΠΏ
ОписаниС

url

string

HTTPS URL-адрСс Ρ„Π°ΠΉΠ»Π° для Π·Π°Π³Ρ€ΡƒΠ·ΠΊΠΈ.

file_name

string

ΠŸΡ€Π΅Π΄Π»Π°Π³Π°Π΅ΠΌΠΎΠ΅ имя для Π·Π°Π³Ρ€ΡƒΠΆΠ°Π΅ΠΌΠΎΠ³ΠΎ Ρ„Π°ΠΉΠ»Π°.

Π’ΠΎΠ·Π²Ρ€Π°Ρ‰Π°Π΅ΠΌΠΎΠ΅ Π·Π½Π°Ρ‡Π΅Π½ΠΈΠ΅

ΠŸΠΎΠ΄Π΄Π΅Ρ€ΠΆΠΊΠ°

Минимальная вСрсия Telegram API: 6.2+

  • Telegram Web

  • Telegram Desktop

  • Telegram Mobile (iOS/Android)

ИспользованиС

ΠŸΠ°Ρ€Π°ΠΌΠ΅Ρ‚Ρ€Ρ‹

ΠŸΠ°Ρ€Π°ΠΌΠ΅Ρ‚Ρ€
Π’ΠΈΠΏ
ОписаниС

url

string

URL-адрСс, ΠΊΠΎΡ‚ΠΎΡ€Ρ‹ΠΉ Π΄ΠΎΠ»ΠΆΠ΅Π½ Π±Ρ‹Ρ‚ΡŒ ΠΎΡ‚ΠΊΡ€Ρ‹Ρ‚ ΠΏΡ€ΠΈΠ»ΠΎΠΆΠ΅Π½ΠΈΠ΅ΠΌ Telegram. Π”ΠΎΠ»ΠΆΠ΅Π½ Π±Ρ‹Ρ‚ΡŒ ΠΏΠΎΠ»Π½Ρ‹ΠΌ ΠΏΡƒΡ‚Π΅ΠΌ с ΠΏΡ€ΠΎΡ‚ΠΎΠΊΠΎΠ»ΠΎΠΌ https.

try_instant_view

boolean

[v6.4] ΠΠ΅ΠΎΠ±ΡΠ·Π°Ρ‚Π΅Π»ΡŒΠ½ΠΎ. Бсылка Π±ΡƒΠ΄Π΅Ρ‚ ΠΎΡ‚ΠΊΡ€Ρ‹Ρ‚Π° Π² Ρ€Π΅ΠΆΠΈΠΌΠ΅ ΠΌΠ³Π½ΠΎΠ²Π΅Π½Π½ΠΎΠ³ΠΎ просмотра, Ссли это Π²ΠΎΠ·ΠΌΠΎΠΆΠ½ΠΎ.

try_browser

boolean

[v7.6] ΠΠ΅ΠΎΠ±ΡΠ·Π°Ρ‚Π΅Π»ΡŒΠ½ΠΎ.

Π’ΠΎΠ·Π²Ρ€Π°Ρ‰Π°Π΅ΠΌΠΎΠ΅ Π·Π½Π°Ρ‡Π΅Π½ΠΈΠ΅

ΠŸΠΎΠ΄Π΄Π΅Ρ€ΠΆΠΊΠ°

Минимальная вСрсия Telegram API: 7.7+

  • Telegram Web

  • Telegram Desktop

  • Telegram Mobile (iOS/Android)

ИспользованиС

ΠŸΠ°Ρ€Π°ΠΌΠ΅Ρ‚Ρ€Ρ‹

ΠŸΠ°Ρ€Π°ΠΌΠ΅Ρ‚Ρ€
Π’ΠΈΠΏ
ОписаниС

allow_vertical_swipe

boolean

Π’ΠΊΠ»ΡŽΡ‡Π°Π΅Ρ‚/Π’Ρ‹ΠΊΠ»ΡŽΡ‡Π°Π΅Ρ‚ свайп

Π’ΠΎΠ·Π²Ρ€Π°Ρ‰Π°Π΅ΠΌΠΎΠ΅ Π·Π½Π°Ρ‡Π΅Π½ΠΈΠ΅

// Установка HEX-Ρ†Π²Π΅Ρ‚Π°
const result = bridgeSetBackgroundColor({ color: '#3498db' })

// ИспользованиС систСмного Ρ†Π²Π΅Ρ‚Π°
bridgeSetBackgroundColor({ color: 'bg_color' })
{
  status: boolean | 'not_supported'
}
{
  status: boolean | 'not_supported'
}
const result = await bridgeDownloadFile({ 
  url: "https://i1.sndcdn.com/artworks-000196299556-zqzzcl-t500x500.jpg",
  file_name: "Каспийский Π“Ρ€ΡƒΠ· 18+ ft. Rigos"
})
{
  status: boolean | 'not_supported'
}
bridgeOpenLink({ url: "https://t.me/apiteamru" })
{
  status: boolean | 'not_supported'
}
bridgeSetupSwipeBehavior({ allow_vertical_swipe: false })
{
  status: boolean | 'not_supported'
}

shareToStory

ΠœΠ΅Ρ‚ΠΎΠ΄, ΠΊΠΎΡ‚ΠΎΡ€Ρ‹ΠΉ ΠΎΡ‚ΠΊΡ€Ρ‹Π²Π°Π΅Ρ‚ собствСнный Ρ€Π΅Π΄Π°ΠΊΡ‚ΠΎΡ€ историй с ΠΌΠ΅Π΄ΠΈΠ°, ΡƒΠΊΠ°Π·Π°Π½Π½Ρ‹ΠΌΠΈ Π² ΠΏΠ°Ρ€Π°ΠΌΠ΅Ρ‚Ρ€Π΅ media_url ΠΊΠ°ΠΊ HTTPS URL.

web_app_share_to_story

ΠŸΠΎΠ΄Π΄Π΅Ρ€ΠΆΠΊΠ°

Минимальная вСрсия Telegram API: 7.8+

  • Telegram Web

  • Telegram Desktop

  • Telegram Mobile (iOS/Android)

ИспользованиС

ΠŸΠ°Ρ€Π°ΠΌΠ΅Ρ‚Ρ€Ρ‹

ΠŸΠ°Ρ€Π°ΠΌΠ΅Ρ‚Ρ€
Π’ΠΈΠΏ
ОписаниС

Π’ΠΎΠ·Π²Ρ€Π°Ρ‰Π°Π΅ΠΌΠΎΠ΅ Π·Π½Π°Ρ‡Π΅Π½ΠΈΠ΅

error_ids

ID
ОписаниС

setHeaderColor

ΠœΠ΅Ρ‚ΠΎΠ΄, ΠΊΠΎΡ‚ΠΎΡ€Ρ‹ΠΉ устанавливаСт Ρ†Π²Π΅Ρ‚ Π·Π°Π³ΠΎΠ»ΠΎΠ²ΠΊΠ° прилоТСния Π² Ρ„ΠΎΡ€ΠΌΠ°Ρ‚Π΅ #RRGGBB. Π’Ρ‹ Ρ‚Π°ΠΊΠΆΠ΅ ΠΌΠΎΠΆΠ΅Ρ‚Π΅ ΠΈΡΠΏΠΎΠ»ΡŒΠ·ΠΎΠ²Π°Ρ‚ΡŒ ΠΊΠ»ΡŽΡ‡Π΅Π²Ρ‹Π΅ слова `bg_color` ΠΈ `secondary_bg_color`.

web_app_setup_closing_behavior

ΠŸΠΎΠ΄Π΄Π΅Ρ€ΠΆΠΊΠ° ΠΏΠ»Π°Ρ‚Ρ„ΠΎΡ€ΠΌ

Минимальная вСрсия Telegram API: 6.1+

  • Telegram Web

  • Telegram Desktop

  • Telegram Mobile (iOS/Android)

ИспользованиС

ΠŸΠ°Ρ€Π°ΠΌΠ΅Ρ‚Ρ€Ρ‹

ΠŸΠ°Ρ€Π°ΠΌΠ΅Ρ‚Ρ€
Π’ΠΈΠΏ
ОписаниС
ΠŸΡ€ΠΈΠΌΠ΅Ρ€Ρ‹

Π’ΠΎΠ·Π²Ρ€Π°Ρ‰Π°Π΅ΠΌΠΎΠ΅ Π·Π½Π°Ρ‡Π΅Π½ΠΈΠ΅

БистСмныС Ρ†Π²Π΅Ρ‚Π°

Π—Π½Π°Ρ‡Π΅Π½ΠΈΠ΅
ОписаниС

setupClosingBehavior

ΠœΠ΅Ρ‚ΠΎΠ΄, ΠΊΠΎΡ‚ΠΎΡ€Ρ‹ΠΉ устанавливаСт Ρ†Π²Π΅Ρ‚ Π·Π°Π³ΠΎΠ»ΠΎΠ²ΠΊΠ° прилоТСния Π² Ρ„ΠΎΡ€ΠΌΠ°Ρ‚Π΅ #RRGGBB. Π’Ρ‹ Ρ‚Π°ΠΊΠΆΠ΅ ΠΌΠΎΠΆΠ΅Ρ‚Π΅ ΠΈΡΠΏΠΎΠ»ΡŒΠ·ΠΎΠ²Π°Ρ‚ΡŒ ΠΊΠ»ΡŽΡ‡Π΅Π²Ρ‹Π΅ слова `bg_color` ΠΈ `secondary_bg_color`.

web_app_setup_closing_behavior

ΠŸΠΎΠ΄Π΄Π΅Ρ€ΠΆΠΊΠ°

Минимальная вСрсия Telegram API: 6.2+

  • Telegram Web

  • Telegram Desktop

  • Telegram Mobile (iOS/Android)

ИспользованиС

ΠŸΠ°Ρ€Π°ΠΌΠ΅Ρ‚Ρ€Ρ‹

ΠŸΠ°Ρ€Π°ΠΌΠ΅Ρ‚Ρ€
Π’ΠΈΠΏ
ОписаниС

Π’ΠΎΠ·Π²Ρ€Π°Ρ‰Π°Π΅ΠΌΠΎΠ΅ Π·Π½Π°Ρ‡Π΅Π½ΠΈΠ΅

shareMessage

ΠœΠ΅Ρ‚ΠΎΠ΄, ΠΊΠΎΡ‚ΠΎΡ€Ρ‹ΠΉ ΠΎΡ‚ΠΊΡ€Ρ‹Π²Π°Π΅Ρ‚ Π΄ΠΈΠ°Π»ΠΎΠ³ΠΎΠ²ΠΎΠ΅ ΠΎΠΊΠ½ΠΎ, ΠΏΠΎΠ·Π²ΠΎΠ»ΡΡŽΡ‰Π΅Π΅ ΠΏΠΎΠ»ΡŒΠ·ΠΎΠ²Π°Ρ‚Π΅Π»ΡŽ ΠΏΠΎΠ΄Π΅Π»ΠΈΡ‚ΡŒΡΡ сообщСниСм, прСдоставлСнным Π±ΠΎΡ‚ΠΎΠΌ. Π˜Π΄Π΅Π½Ρ‚ΠΈΡ„ΠΈΠΊΠ°Ρ‚ΠΎΡ€ сообщСния, ΠΏΠ΅Ρ€Π΅Π΄Π°Π½Π½Ρ‹ΠΉ этому ΠΌΠ΅Ρ‚ΠΎΠ΄Ρƒ, Π΄ΠΎΠ»ΠΆΠ΅Π½ ΠΏΡ€ΠΈΠ½Π°Π΄Π»Π΅ΠΆΠ°Ρ‚ΡŒ `PreparedInlineMe

web_app_send_prepared_message

ΠŸΠΎΠ΄Π΄Π΅Ρ€ΠΆΠΊΠ°

Минимальная вСрсия Telegram API: 8.0+

  • Telegram Web

  • Telegram Desktop

  • Telegram Mobile (iOS/Android)

ИспользованиС

ΠŸΠ°Ρ€Π°ΠΌΠ΅Ρ‚Ρ€Ρ‹

ΠŸΠ°Ρ€Π°ΠΌΠ΅Ρ‚Ρ€
Π’ΠΈΠΏ
ОписаниС

Π’ΠΎΠ·Π²Ρ€Π°Ρ‰Π°Π΅ΠΌΠΎΠ΅ Π·Π½Π°Ρ‡Π΅Π½ΠΈΠ΅

ΠœΠ΅Ρ‚ΠΎΠ΄Ρ‹

ΠœΠ΅Ρ‚ΠΎΠ΄Ρ‹ Telegram Mini Apps β€” это события, ΠΊΠΎΡ‚ΠΎΡ€Ρ‹Π΅ Π²Ρ‹ΠΏΠΎΠ»Π½ΡΡŽΡ‚ Π½Π΅ΠΊΠΎΡ‚ΠΎΡ€Ρ‹Π΅ ΠΏΡ€Π΅Π΄ΠΎΠΏΡ€Π΅Π΄Π΅Π»Π΅Π½Π½Ρ‹Π΅ дСйствия. Они всСгда Π²Ρ‹Π·Ρ‹Π²Π°ΡŽΡ‚ΡΡ Mini App.

Π’ этом Ρ€Π°Π·Π΄Π΅Π»Π΅ содСрТится список доступных ΠΌΠ΅Ρ‚ΠΎΠ΄ΠΎΠ² для Π²Ρ‹Π·ΠΎΠ²Π° с ΠΈΡ… ΠΈΠΌΠ΅Π½Π°ΠΌΠΈ, описаниСм ΠΈ ΠΏΠ°Ρ€Π°ΠΌΠ΅Ρ‚Ρ€Π°ΠΌΠΈ. Π’ случаС, Ссли Mini App Π½Π΅ удовлСтворяСт ΠΌΠΈΠ½ΠΈΠΌΠ°Π»ΡŒΠ½ΠΎΠΌΡƒ Ρ‚Ρ€Π΅Π±ΠΎΠ²Π°Π½ΠΈΡŽ вСрсии ΠΌΠ΅Ρ‚ΠΎΠ΄Π°, Π½ΠΈΡ‡Π΅Π³ΠΎ Π½Π΅ ΠΏΡ€ΠΎΠΈΠ·ΠΎΠΉΠ΄Π΅Ρ‚. БобствСнноС ΠΏΡ€ΠΈΠ»ΠΎΠΆΠ΅Π½ΠΈΠ΅ просто Π½Π΅ Π·Π½Π°Π΅Ρ‚, ΠΊΠ°ΠΊΠΎΠΉ ΠΌΠ΅Ρ‚ΠΎΠ΄ слСдуСт Π²Ρ‹Π·Ρ‹Π²Π°Ρ‚ΡŒ, ΠΏΠΎΠΊΠ° ΠΎΠ½ Π½Π΅ ΠΎΠΏΡ€Π΅Π΄Π΅Π»Π΅Π½ Π²Π½ΡƒΡ‚Ρ€ΠΈ.

iframe_ready

УвСдомляСт Ρ€ΠΎΠ΄ΠΈΡ‚Π΅Π»ΡŒΡΠΊΠΈΠΉ iframe ΠΎ готовности Ρ‚Π΅ΠΊΡƒΡ‰Π΅Π³ΠΎ Ρ„Ρ€Π΅ΠΉΠΌΠ°. Π­Ρ‚ΠΎΡ‚ ΠΌΠ΅Ρ‚ΠΎΠ΄ ΠΈΡΠΏΠΎΠ»ΡŒΠ·ΡƒΠ΅Ρ‚ΡΡ Ρ‚ΠΎΠ»ΡŒΠΊΠΎ Π² Π²Π΅Π±-вСрсии Telegram. Π’ Ρ€Π΅Π·ΡƒΠ»ΡŒΡ‚Π°Ρ‚Π΅ Mini App ΠΏΠΎΠ»ΡƒΡ‡ΠΈΡ‚ событиС set_custom_style.

ПолС

openTgLink

ΠœΠ΅Ρ‚ΠΎΠ΄, ΠΊΠΎΡ‚ΠΎΡ€Ρ‹ΠΉ ΠΎΡ‚ΠΊΡ€Ρ‹Π²Π°Π΅Ρ‚ ссылку Telegram Π²Π½ΡƒΡ‚Ρ€ΠΈ прилоТСния Telegram. Мини-ΠΏΡ€ΠΈΠ»ΠΎΠΆΠ΅Π½ΠΈΠ΅ Π½Π΅ Π±ΡƒΠ΄Π΅Ρ‚ Π·Π°ΠΊΡ€Ρ‹Ρ‚ΠΎ послС Π²Ρ‹Π·ΠΎΠ²Π° этого ΠΌΠ΅Ρ‚ΠΎΠ΄Π°.

web_app_open_tg_link

Π’ΠΈΠΏ
ОписаниС

reload_supported

boolean

ΠΠ΅ΠΎΠ±ΡΠ·Π°Ρ‚Π΅Π»ΡŒΠ½ΠΎ. True, Ссли Ρ‚Π΅ΠΊΡƒΡ‰Π΅Π΅ ΠΌΠΈΠ½ΠΈ-ΠΏΡ€ΠΈΠ»ΠΎΠΆΠ΅Π½ΠΈΠ΅ ΠΏΠΎΠ΄Π΄Π΅Ρ€ΠΆΠΈΠ²Π°Π΅Ρ‚ ΡΠΎΠ±ΡΡ‚Π²Π΅Π½Π½ΡƒΡŽ ΠΏΠ΅Ρ€Π΅Π·Π°Π³Ρ€ΡƒΠ·ΠΊΡƒ.


iframe_will_reload

УвСдомляСт Ρ€ΠΎΠ΄ΠΈΡ‚Π΅Π»ΡŒΡΠΊΠΈΠΉ iframe ΠΎ Ρ‚ΠΎΠΌ, Ρ‡Ρ‚ΠΎ Ρ‚Π΅ΠΊΡƒΡ‰ΠΈΠΉ iframe Π±ΡƒΠ΄Π΅Ρ‚ ΠΏΠ΅Ρ€Π΅Π·Π°Π³Ρ€ΡƒΠΆΠ΅Π½.


web_app_add_to_home_screen

Минимальная вСрсия Telegram API: 8.0+

ΠŸΡ€Π΅Π΄Π»Π°Π³Π°Π΅Ρ‚ ΠΏΠΎΠ»ΡŒΠ·ΠΎΠ²Π°Ρ‚Π΅Π»ΡŽ Π΄ΠΎΠ±Π°Π²ΠΈΡ‚ΡŒ Mini App Π½Π° домашний экран. ΠžΠ±Ρ€Π°Ρ‚ΠΈΡ‚Π΅ Π²Π½ΠΈΠΌΠ°Π½ΠΈΠ΅, Ρ‡Ρ‚ΠΎ Ссли устройство Π½Π΅ ΠΌΠΎΠΆΠ΅Ρ‚ ΠΎΠΏΡ€Π΅Π΄Π΅Π»ΠΈΡ‚ΡŒ статус установки, событиС ΠΌΠΎΠΆΠ΅Ρ‚ Π½Π΅ Π±Ρ‹Ρ‚ΡŒ ΠΏΠΎΠ»ΡƒΡ‡Π΅Π½ΠΎ, Π΄Π°ΠΆΠ΅ Ссли Π·Π½Π°Ρ‡ΠΎΠΊ Π±Ρ‹Π» Π΄ΠΎΠ±Π°Π²Π»Π΅Π½.


web_app_biometry_get_info

Минимальная вСрсия Telegram API: 7.2+

Π—Π°ΠΏΡ€Π°ΡˆΠΈΠ²Π°Π΅Ρ‚ Ρ‚Π΅ΠΊΡƒΡ‰ΠΈΠ΅ настройки Π±ΠΈΠΎΠΌΠ΅Ρ‚Ρ€ΠΈΠΈ.


web_app_biometry_open_settings

Минимальная вСрсия Telegram API: 7.2+

Π­Ρ‚ΠΎΡ‚ ΠΌΠ΅Ρ‚ΠΎΠ΄ ΠΌΠΎΠΆΠ΅Ρ‚ Π±Ρ‹Ρ‚ΡŒ Π²Ρ‹Π·Π²Π°Π½ Ρ‚ΠΎΠ»ΡŒΠΊΠΎ Π² ΠΎΡ‚Π²Π΅Ρ‚ Π½Π° взаимодСйствиС ΠΏΠΎΠ»ΡŒΠ·ΠΎΠ²Π°Ρ‚Π΅Π»Ρ с интСрфСйсом ΠΌΠΈΠ½ΠΈ-прилоТСния (Π½Π°ΠΏΡ€ΠΈΠΌΠ΅Ρ€, Ρ‰Π΅Π»Ρ‡ΠΎΠΊ Π²Π½ΡƒΡ‚Ρ€ΠΈ ΠΌΠΈΠ½ΠΈ-прилоТСния ΠΈΠ»ΠΈ Π½Π° Π³Π»Π°Π²Π½ΠΎΠΉ ΠΊΠ½ΠΎΠΏΠΊΠ΅).

ΠžΡ‚ΠΊΡ€Ρ‹Π²Π°Π΅Ρ‚ настройки биомСтричСского доступа для Π±ΠΎΡ‚ΠΎΠ². ПолСзно, ΠΊΠΎΠ³Π΄Π° Π½ΡƒΠΆΠ½ΠΎ Π·Π°ΠΏΡ€ΠΎΡΠΈΡ‚ΡŒ биомСтричСский доступ Ρƒ ΠΏΠΎΠ»ΡŒΠ·ΠΎΠ²Π°Ρ‚Π΅Π»Π΅ΠΉ, ΠΊΠΎΡ‚ΠΎΡ€Ρ‹Π΅ Π΅Π³ΠΎ Π΅Ρ‰Π΅ Π½Π΅ прСдоставили.


web_app_biometry_request_access

Минимальная вСрсия Telegram API: 7.2+

Π—Π°ΠΏΡ€Π°ΡˆΠΈΠ²Π°Π΅Ρ‚ Ρ€Π°Π·Ρ€Π΅ΡˆΠ΅Π½ΠΈΠ΅ Π½Π° использованиС Π±ΠΈΠΎΠΌΠ΅Ρ‚Ρ€ΠΈΠΈ.

ПолС
Π’ΠΈΠΏ
ОписаниС

reason

string

ΠΠ΅ΠΎΠ±ΡΠ·Π°Ρ‚Π΅Π»ΡŒΠ½ΠΎ. ВСкст, ΠΊΠΎΡ‚ΠΎΡ€Ρ‹ΠΉ Π±ΡƒΠ΄Π΅Ρ‚ ΠΎΡ‚ΠΎΠ±Ρ€Π°ΠΆΠ°Ρ‚ΡŒΡΡ ΠΏΠΎΠ»ΡŒΠ·ΠΎΠ²Π°Ρ‚Π΅Π»ΡŽ Π²ΠΎ Π²ΡΠΏΠ»Ρ‹Π²Π°ΡŽΡ‰Π΅ΠΌ ΠΎΠΊΠ½Π΅, ΠΎΠΏΠΈΡΡ‹Π²Π°ΡŽΡ‰ΠΈΠΉ, ΠΏΠΎΡ‡Π΅ΠΌΡƒ Π±ΠΎΡ‚Ρƒ Π½Π΅ΠΎΠ±Ρ…ΠΎΠ΄ΠΈΠΌ доступ ΠΊ Π±ΠΈΠΎΠΌΠ΅Ρ‚Ρ€ΠΈΠΈ, 0-128 символов.


web_app_biometry_request_auth

Минимальная вСрсия Telegram API: 7.2+

АутСнтифицируСт ΠΏΠΎΠ»ΡŒΠ·ΠΎΠ²Π°Ρ‚Π΅Π»Ρ с использованиСм Π±ΠΈΠΎΠΌΠ΅Ρ‚Ρ€ΠΈΠΈ.

ПолС
Π’ΠΈΠΏ
ОписаниС

reason

string

ΠΠ΅ΠΎΠ±ΡΠ·Π°Ρ‚Π΅Π»ΡŒΠ½ΠΎ. ВСкст, ΠΊΠΎΡ‚ΠΎΡ€Ρ‹ΠΉ Π±ΡƒΠ΄Π΅Ρ‚ ΠΎΡ‚ΠΎΠ±Ρ€Π°ΠΆΠ°Ρ‚ΡŒΡΡ ΠΏΠΎΠ»ΡŒΠ·ΠΎΠ²Π°Ρ‚Π΅Π»ΡŽ Π²ΠΎ Π²ΡΠΏΠ»Ρ‹Π²Π°ΡŽΡ‰Π΅ΠΌ ΠΎΠΊΠ½Π΅, ΠΎΠΏΠΈΡΡ‹Π²Π°ΡŽΡ‰ΠΈΠΉ, ΠΏΠΎΡ‡Π΅ΠΌΡƒ Π²Ρ‹ проситС Π΅Π³ΠΎ ΠΏΡ€ΠΎΠΉΡ‚ΠΈ Π°ΡƒΡ‚Π΅Π½Ρ‚ΠΈΡ„ΠΈΠΊΠ°Ρ†ΠΈΡŽ ΠΈ ΠΊΠ°ΠΊΠΈΠ΅ дСйствия Π²Ρ‹ ΠΏΡ€Π΅Π΄ΠΏΡ€ΠΈΠΌΠ΅Ρ‚Π΅ Π½Π° основС этой Π°ΡƒΡ‚Π΅Π½Ρ‚ΠΈΡ„ΠΈΠΊΠ°Ρ†ΠΈΠΈ, 0–128 символов.


web_app_biometry_update_token

Минимальная вСрсия Telegram API: 7.2+

ΠžΠ±Π½ΠΎΠ²Π»ΡΠ΅Ρ‚ биомСтричСский Ρ‚ΠΎΠΊΠ΅Π½ Π² бСзопасном Ρ…Ρ€Π°Π½ΠΈΠ»ΠΈΡ‰Π΅ Π½Π° устройствС. Π§Ρ‚ΠΎΠ±Ρ‹ ΡƒΠ΄Π°Π»ΠΈΡ‚ΡŒ Ρ‚ΠΎΠΊΠ΅Π½, ΠΏΠ΅Ρ€Π΅Π΄Π°ΠΉΡ‚Π΅ ΠΏΡƒΡΡ‚ΡƒΡŽ строку.

ПолС
Π’ΠΈΠΏ
ОписаниС

token

string

Π’ΠΎΠΊΠ΅Π½ для хранСния. Максимальная Π΄Π»ΠΈΠ½Π° 1024 символа.


web_app_check_home_screen

Минимальная вСрсия Telegram API: 8.0+

ΠžΡ‚ΠΏΡ€Π°Π²Π»ΡΠ΅Ρ‚ запрос Π² собствСнноС ΠΏΡ€ΠΈΠ»ΠΎΠΆΠ΅Π½ΠΈΠ΅ Telegram, Ρ‡Ρ‚ΠΎΠ±Ρ‹ ΠΏΡ€ΠΎΠ²Π΅Ρ€ΠΈΡ‚ΡŒ, Π΄ΠΎΠ±Π°Π²Π»Π΅Π½ΠΎ Π»ΠΈ Ρ‚Π΅ΠΊΡƒΡ‰Π΅Π΅ ΠΌΠΈΠ½ΠΈ-ΠΏΡ€ΠΈΠ»ΠΎΠΆΠ΅Π½ΠΈΠ΅ Π½Π° Π³Π»Π°Π²Π½Ρ‹ΠΉ экран устройства.


web_app_check_location

Минимальная вСрсия Telegram API: 8.0+

Π—Π°ΠΏΡ€Π°ΡˆΠΈΠ²Π°Π΅Ρ‚ состояниС доступности Ρ„ΡƒΠ½ΠΊΡ†ΠΈΠΎΠ½Π°Π»ΡŒΠ½ΠΎΡΡ‚ΠΈ, связанной с мСстополоТСниСм.


web_app_close

Π—Π°ΠΊΡ€Ρ‹Π²Π°Π΅Ρ‚ ΠΌΠΈΠ½ΠΈ-ΠΏΡ€ΠΈΠ»ΠΎΠΆΠ΅Π½ΠΈΠ΅.


web_app_close_scan_qr_popup

Минимальная вСрсия Telegram API: 6.4+

Π—Π°ΠΊΡ€Ρ‹Π²Π°Π΅Ρ‚ QR-сканСр. ΠŸΡ€ΠΈΠ»ΠΎΠΆΠ΅Π½ΠΈΠ΅ Telegram создаСт событиС scan_qr_popup_closed.


web_app_data_send

ΠžΡ‚ΠΏΡ€Π°Π²Π»ΡΠ΅Ρ‚ Π΄Π°Π½Π½Ρ‹Π΅ Π±ΠΎΡ‚Ρƒ. ΠŸΡ€ΠΈ Π²Ρ‹Π·ΠΎΠ²Π΅ этого ΠΌΠ΅Ρ‚ΠΎΠ΄Π° Π±ΠΎΡ‚Ρƒ отправляСтся слуТСбноС сообщСниС, содСрТащСС Π΄Π°Π½Π½Ρ‹Π΅ Π΄Π»ΠΈΠ½ΠΎΠΉ Π΄ΠΎ 4096 Π±Π°ΠΉΡ‚. Π—Π°Ρ‚Π΅ΠΌ Mini App Π±ΡƒΠ΄Π΅Ρ‚ Π·Π°ΠΊΡ€Ρ‹Ρ‚.

Π§Ρ‚ΠΎΠ±Ρ‹ ΠΏΠΎΠ»ΡƒΡ‡ΠΈΡ‚ΡŒ большС ΠΈΠ½Ρ„ΠΎΡ€ΠΌΠ°Ρ†ΠΈΠΈ, взглянитС Π½Π° ΠΏΠΎΠ»Π΅ web_app_data Π² классС Message.

ПолС
Π’ΠΈΠΏ
ОписаниС

data

string

Π”Π°Π½Π½Ρ‹Π΅ для ΠΎΡ‚ΠΏΡ€Π°Π²ΠΊΠΈ Π±ΠΎΡ‚Ρƒ. НС Π΄ΠΎΠ»ΠΆΠ½Ρ‹ ΠΈΠΌΠ΅Ρ‚ΡŒ Ρ€Π°Π·ΠΌΠ΅Ρ€ Π±ΠΎΠ»Π΅Π΅ 4096 Π±Π°ΠΉΡ‚.


web_app_exit_fullscreen

Минимальная вСрсия Telegram API: 8.0+

Π—Π°ΠΏΡ€Π°ΡˆΠΈΠ²Π°Π΅Ρ‚ Π²Ρ‹Ρ…ΠΎΠ΄ ΠΈΠ· полноэкранного Ρ€Π΅ΠΆΠΈΠΌΠ° для ΠΌΠΈΠ½ΠΈ-прилоТСния.


web_app_expand

Π Π°Π·Π²ΠΎΡ€Π°Ρ‡ΠΈΠ²Π°Π΅Ρ‚ ΠΌΠΈΠ½ΠΈ-ΠΏΡ€ΠΈΠ»ΠΎΠΆΠ΅Π½ΠΈΠ΅.


web_app_invoke_custom_method

Минимальная вСрсия Telegram API: 6.9+

ПолС
Π’ΠΈΠΏ
ОписаниС

req_id

string

Π£Π½ΠΈΠΊΠ°Π»ΡŒΠ½Ρ‹ΠΉ ΠΈΠ΄Π΅Π½Ρ‚ΠΈΡ„ΠΈΠΊΠ°Ρ‚ΠΎΡ€ Ρ‚Π΅ΠΊΡƒΡ‰Π΅Π³ΠΎ Π²Ρ‹Π·ΠΎΠ²Π°.

method

string

Имя ΠΌΠ΅Ρ‚ΠΎΠ΄Π°.

params

unknown

ΠŸΠ°Ρ€Π°ΠΌΠ΅Ρ‚Ρ€Ρ‹ согласно method.


web_app_open_invoice

Минимальная вСрсия Telegram API: 6.1+

ΠžΡ‚ΠΊΡ€Ρ‹Π²Π°Π΅Ρ‚ счСт-Ρ„Π°ΠΊΡ‚ΡƒΡ€Ρƒ ΠΏΠΎ ΡƒΠΊΠ°Π·Π°Π½Π½ΠΎΠΌΡƒ слагу. ΠŸΠΎΠ΄Ρ€ΠΎΠ±Π½Π΅Π΅ ΠΎ счСтах-Ρ„Π°ΠΊΡ‚ΡƒΡ€Π°Ρ… Π² этой Π΄ΠΎΠΊΡƒΠΌΠ΅Π½Ρ‚Π°Ρ†ΠΈΠΈ.

ПолС
Π’ΠΈΠΏ
ОписаниС

slug

string

Π£Π½ΠΈΠΊΠ°Π»ΡŒΠ½Ρ‹ΠΉ ΠΈΠ΄Π΅Π½Ρ‚ΠΈΡ„ΠΈΠΊΠ°Ρ‚ΠΎΡ€ счСта-Ρ„Π°ΠΊΡ‚ΡƒΡ€Ρ‹.


web_app_open_link

ΠžΡ‚ΠΊΡ€Ρ‹Π²Π°Π΅Ρ‚ ссылку Π² Π±Ρ€Π°ΡƒΠ·Π΅Ρ€Π΅ ΠΏΠΎ ΡƒΠΌΠΎΠ»Ρ‡Π°Π½ΠΈΡŽ. Мини-ΠΏΡ€ΠΈΠ»ΠΎΠΆΠ΅Π½ΠΈΠ΅ Π½Π΅ Π±ΡƒΠ΄Π΅Ρ‚ Π·Π°ΠΊΡ€Ρ‹Ρ‚ΠΎ.

ПолС
Π’ΠΈΠΏ
ОписаниС

url

string

URL-адрСс, ΠΊΠΎΡ‚ΠΎΡ€Ρ‹ΠΉ Π΄ΠΎΠ»ΠΆΠ΅Π½ Π±Ρ‹Ρ‚ΡŒ ΠΎΡ‚ΠΊΡ€Ρ‹Ρ‚ ΠΏΡ€ΠΈΠ»ΠΎΠΆΠ΅Π½ΠΈΠ΅ΠΌ Telegram. Π”ΠΎΠ»ΠΆΠ΅Π½ Π±Ρ‹Ρ‚ΡŒ ΠΏΠΎΠ»Π½Ρ‹ΠΌ ΠΏΡƒΡ‚Π΅ΠΌ с ΠΏΡ€ΠΎΡ‚ΠΎΠΊΠΎΠ»ΠΎΠΌ https.

try_instant_view

boolean

[v6.4] ΠΠ΅ΠΎΠ±ΡΠ·Π°Ρ‚Π΅Π»ΡŒΠ½ΠΎ. Бсылка Π±ΡƒΠ΄Π΅Ρ‚ ΠΎΡ‚ΠΊΡ€Ρ‹Ρ‚Π° Π² Ρ€Π΅ΠΆΠΈΠΌΠ΅ ΠΌΠ³Π½ΠΎΠ²Π΅Π½Π½ΠΎΠ³ΠΎ просмотра, Ссли это Π²ΠΎΠ·ΠΌΠΎΠΆΠ½ΠΎ.

try_browser

boolean

[v7.6] ΠΠ΅ΠΎΠ±ΡΠ·Π°Ρ‚Π΅Π»ΡŒΠ½ΠΎ. Бсылка Π±ΡƒΠ΄Π΅Ρ‚ ΠΎΡ‚ΠΊΡ€Ρ‹Ρ‚Π° Π² Π±Ρ€Π°ΡƒΠ·Π΅Ρ€Π΅, Ссли это Π²ΠΎΠ·ΠΌΠΎΠΆΠ½ΠΎ.


web_app_open_location_settings

Минимальная вСрсия Telegram API: 8.0+

ΠžΠ±Ρ€Π°Ρ‚ΠΈΡ‚Π΅ Π²Π½ΠΈΠΌΠ°Π½ΠΈΠ΅, Ρ‡Ρ‚ΠΎ этот ΠΌΠ΅Ρ‚ΠΎΠ΄ ΠΌΠΎΠΆΠ΅Ρ‚ Π±Ρ‹Ρ‚ΡŒ Π²Ρ‹Π·Π²Π°Π½ Ρ‚ΠΎΠ»ΡŒΠΊΠΎ Π² ΠΎΡ‚Π²Π΅Ρ‚ Π½Π° взаимодСйствиС ΠΏΠΎΠ»ΡŒΠ·ΠΎΠ²Π°Ρ‚Π΅Π»Ρ с интСрфСйсом ΠΌΠΈΠ½ΠΈ-прилоТСния (Π½Π°ΠΏΡ€ΠΈΠΌΠ΅Ρ€, Ρ‰Π΅Π»Ρ‡ΠΎΠΊ Π²Π½ΡƒΡ‚Ρ€ΠΈ ΠΌΠΈΠ½ΠΈ-прилоТСния ΠΈΠ»ΠΈ Π½Π° Π³Π»Π°Π²Π½ΠΎΠΉ ΠΊΠ½ΠΎΠΏΠΊΠ΅).

ΠžΡ‚ΠΊΡ€Ρ‹Π²Π°Π΅Ρ‚ настройки доступа ΠΊ ΠΌΠ΅ΡΡ‚ΠΎΠΏΠΎΠ»ΠΎΠΆΠ΅Π½ΠΈΡŽ для Π±ΠΎΡ‚ΠΎΠ². ПолСзно, ΠΊΠΎΠ³Π΄Π° Π²Π°ΠΌ Π½ΡƒΠΆΠ½ΠΎ Π·Π°ΠΏΡ€ΠΎΡΠΈΡ‚ΡŒ доступ ΠΊ ΠΌΠ΅ΡΡ‚ΠΎΠΏΠΎΠ»ΠΎΠΆΠ΅Π½ΠΈΡŽ Ρƒ ΠΏΠΎΠ»ΡŒΠ·ΠΎΠ²Π°Ρ‚Π΅Π»Π΅ΠΉ, ΠΊΠΎΡ‚ΠΎΡ€Ρ‹Π΅ Π΅Ρ‰Π΅ Π½Π΅ прСдоставили Π΅Π³ΠΎ.


web_app_open_popup

Минимальная вСрсия Telegram API: 6.2+

ΠžΡ‚ΠΊΡ€Ρ‹Π²Π°Π΅Ρ‚ Π½ΠΎΠ²ΠΎΠ΅ Π²ΡΠΏΠ»Ρ‹Π²Π°ΡŽΡ‰Π΅Π΅ ΠΎΠΊΠ½ΠΎ. Когда ΠΏΠΎΠ»ΡŒΠ·ΠΎΠ²Π°Ρ‚Π΅Π»ΡŒ Π·Π°ΠΊΡ€Ρ‹Π²Π°Π΅Ρ‚ Π²ΡΠΏΠ»Ρ‹Π²Π°ΡŽΡ‰Π΅Π΅ ΠΎΠΊΠ½ΠΎ, Telegram создаСт событиС popup_closed.

ПолС
Π’ΠΈΠΏ
ОписаниС

title

string

ВСкст, ΠΊΠΎΡ‚ΠΎΡ€Ρ‹ΠΉ Π±ΡƒΠ΄Π΅Ρ‚ ΠΎΡ‚ΠΎΠ±Ρ€Π°ΠΆΠ°Ρ‚ΡŒΡΡ Π² Π·Π°Π³ΠΎΠ»ΠΎΠ²ΠΊΠ΅ Π²ΡΠΏΠ»Ρ‹Π²Π°ΡŽΡ‰Π΅Π³ΠΎ ΠΎΠΊΠ½Π°, 0-64 символа.

message

string

Π‘ΠΎΠΎΠ±Ρ‰Π΅Π½ΠΈΠ΅, ΠΊΠΎΡ‚ΠΎΡ€ΠΎΠ΅ Π±ΡƒΠ΄Π΅Ρ‚ ΠΎΡ‚ΠΎΠ±Ρ€Π°ΠΆΠ°Ρ‚ΡŒΡΡ Π² тСкстС Π²ΡΠΏΠ»Ρ‹Π²Π°ΡŽΡ‰Π΅Π³ΠΎ ΠΎΠΊΠ½Π°, ΠΎΡ‚ 1 Π΄ΠΎ 256 символов.

buttons

PopupButton[]

Бписок ΠΊΠ½ΠΎΠΏΠΎΠΊ, ΠΊΠΎΡ‚ΠΎΡ€Ρ‹Π΅ Π±ΡƒΠ΄ΡƒΡ‚ ΠΎΡ‚ΠΎΠ±Ρ€Π°ΠΆΠ°Ρ‚ΡŒΡΡ Π²ΠΎ Π²ΡΠΏΠ»Ρ‹Π²Π°ΡŽΡ‰Π΅ΠΌ ΠΎΠΊΠ½Π΅, 1-3 ΠΊΠ½ΠΎΠΏΠΊΠΈ

PopupButton

ПолС
Π’ΠΈΠΏ
ОписаниС

id

string

Π˜Π΄Π΅Π½Ρ‚ΠΈΡ„ΠΈΠΊΠ°Ρ‚ΠΎΡ€ ΠΊΠ½ΠΎΠΏΠΊΠΈ, 0-64 символа.

type

PopupButtonType

Π’ΠΈΠΏ ΠΊΠ½ΠΎΠΏΠΊΠΈ. "default", "destructive", "ok", "close", "cancel"

text

PopupButton[]

ВСкст, ΠΊΠΎΡ‚ΠΎΡ€Ρ‹ΠΉ Π±ΡƒΠ΄Π΅Ρ‚ ΠΎΡ‚ΠΎΠ±Ρ€Π°ΠΆΠ°Ρ‚ΡŒΡΡ Π½Π° ΠΊΠ½ΠΎΠΏΠΊΠ΅, 0-64 символа. Π˜Π³Π½ΠΎΡ€ΠΈΡ€ΡƒΠ΅Ρ‚ΡΡ, Ссли type Π² ok, close ΠΈΠ»ΠΈ cancel.

PopupButtonType

Π’ΠΈΠΏ
ОписаниС

default

Кнопка со стилСм ΠΏΠΎ ΡƒΠΌΠΎΠ»Ρ‡Π°Π½ΠΈΡŽ.

destructive

Кнопка со стилСм, ΡƒΠΊΠ°Π·Ρ‹Π²Π°ΡŽΡ‰ΠΈΠΌ Π½Π° дСструктивноС дСйствиС (Π½Π°ΠΏΡ€ΠΈΠΌΠ΅Ρ€, Β«Π£Π΄Π°Π»ΠΈΡ‚ΡŒΒ» ΠΈ Ρ‚. Π΄.)

ok

Кнопка с Π»ΠΎΠΊΠ°Π»ΠΈΠ·ΠΎΠ²Π°Π½Π½Ρ‹ΠΌ тСкстом «ОК»

close

Кнопка с Π»ΠΎΠΊΠ°Π»ΠΈΠ·ΠΎΠ²Π°Π½Π½Ρ‹ΠΌ тСкстом Β«Π—Π°ΠΊΡ€Ρ‹Ρ‚ΡŒΒ»

cancel

Кнопка с Π»ΠΎΠΊΠ°Π»ΠΈΠ·ΠΎΠ²Π°Π½Π½Ρ‹ΠΌ тСкстом Β«ΠžΡ‚ΠΌΠ΅Π½Π°Β»


web_app_open_scan_qr_popup

Минимальная вСрсия Telegram API: 6.4+

ΠžΡ‚ΠΊΡ€Ρ‹Π²Π°Π΅Ρ‚ QR-сканСр. Когда сканСр Π±Ρ‹Π» Π·Π°ΠΊΡ€Ρ‹Ρ‚, ΠΏΡ€ΠΈΠ»ΠΎΠΆΠ΅Π½ΠΈΠ΅ Telegram создаСт событиС scan_qr_popup_closed. Когда сканСр считываСт QR, Telegram создаСт событиС qr_text_received.

ПолС
Π’ΠΈΠΏ
ОписаниС

text

string

ΠΠ΅ΠΎΠ±ΡΠ·Π°Ρ‚Π΅Π»ΡŒΠ½ΠΎ. ВСкст, ΠΊΠΎΡ‚ΠΎΡ€Ρ‹ΠΉ Π±ΡƒΠ΄Π΅Ρ‚ ΠΎΡ‚ΠΎΠ±Ρ€Π°ΠΆΠ°Ρ‚ΡŒΡΡ Π² QR-сканСрС.


widget_link.name

string

ΠΠ΅ΠΎΠ±ΡΠ·Π°Ρ‚Π΅Π»ΡŒΠ½ΠΎ. Имя, ΠΊΠΎΡ‚ΠΎΡ€ΠΎΠ΅ Π±ΡƒΠ΄Π΅Ρ‚ ΠΎΡ‚ΠΎΠ±Ρ€Π°ΠΆΠ°Ρ‚ΡŒΡΡ для ссылки Π²ΠΈΠ΄ΠΆΠ΅Ρ‚Π°. Максимальная Π΄Π»ΠΈΠ½Π° β€” 48 символа.

media

string

Бсылка Π½Π° ΠΊΠΎΠ½Ρ‚Π΅Π½Ρ‚, Ρ‚ΠΎΠ»ΡŒΠΊΠΎ HTTPS

text

string

ΠΠ΅ΠΎΠ±ΡΠ·Π°Ρ‚Π΅Π»ΡŒΠ½ΠΎ. ВСкст, ΠΊΠΎΡ‚ΠΎΡ€Ρ‹ΠΉ Π½Π΅ΠΎΠ±Ρ…ΠΎΠ΄ΠΈΠΌΠΎ Π²ΡΡ‚Π°Π²ΠΈΡ‚ΡŒ Π² ΠΏΠΎΠ»Π΅ Π²Π²ΠΎΠ΄Π° послС Ρ‚Π΅ΠΊΡƒΡ‰Π΅Π³ΠΎ ΠΈΠΌΠ΅Π½ΠΈ Π±ΠΎΡ‚Π°. Максимальная Π΄Π»ΠΈΠ½Π° β€” 2048 символов.

widget_link

Object

ΠΠ΅ΠΎΠ±ΡΠ·Π°Ρ‚Π΅Π»ΡŒΠ½ΠΎ.

widget_link.url

string

URL-адрСс, ΠΊΠΎΡ‚ΠΎΡ€Ρ‹ΠΉ Π±ΡƒΠ΄Π΅Ρ‚ Π²ΠΊΠ»ΡŽΡ‡Π΅Π½ Π² ΠΈΡΡ‚ΠΎΡ€ΠΈΡŽ.

1

ВСкст (text) слишком Π΄Π»ΠΈΠ½Π½Ρ‹ΠΉ

2

Имя (widget_link.name) ссылки слишком Π΄Π»ΠΈΠ½Π½ΠΎΠ΅

color

string

Π¦Π²Π΅Ρ‚ Ρ„ΠΎΠ½Π°

"#ff0000"

color_key

string

Π¦Π²Π΅Ρ‚ Ρ„ΠΎΠ½Π°

"bg_color"

bg_color

Основной Ρ„ΠΎΠ½

secondary_bg_color

Π’Ρ‚ΠΎΡ€ΠΈΡ‡Π½Ρ‹ΠΉ Ρ„ΠΎΠ½

need_confirmation

boolean

Π‘ΡƒΠ΄Π΅Ρ‚ Π»ΠΈ ΠΏΠΎΠ»ΡŒΠ·ΠΎΠ²Π°Ρ‚Π΅Π»ΡŽ Π²Ρ‹Π΄Π°Π½ΠΎ ΡƒΠ²Π΅Π΄ΠΎΠΌΠ»Π΅Π½ΠΈΠ΅ Π² случаС закрытия прилоТСния?

msg_id

number

Π˜Π΄Π΅Π½Ρ‚ΠΈΡ„ΠΈΠΊΠ°Ρ‚ΠΎΡ€

ΠŸΠΎΠ΄Π΄Π΅Ρ€ΠΆΠΊΠ°

Минимальная вСрсия Telegram API: 7.0+

  • Telegram Web

  • Telegram Desktop

  • Telegram Mobile (iOS/Android)

ИспользованиС

ΠŸΠ°Ρ€Π°ΠΌΠ΅Ρ‚Ρ€Ρ‹

ΠŸΠ°Ρ€Π°ΠΌΠ΅Ρ‚Ρ€
Π’ΠΈΠΏ
ОписаниС

path_full

string

Π”ΠΎΠ»ΠΆΠ½ΠΎ Π±Ρ‹Ρ‚ΡŒ Π·Π½Π°Ρ‡Π΅Π½ΠΈΠ΅, взятоС ΠΈΠ· ссылки Π² ΡΠ»Π΅Π΄ΡƒΡŽΡ‰Π΅ΠΌ Ρ„ΠΎΡ€ΠΌΠ°Ρ‚Π΅: https://t.me/{path_full}

force_request

boolean

ΠΠ΅ΠΎΠ±ΡΠ·Π°Ρ‚Π΅Π»ΡŒΠ½ΠΎ.

Π’ΠΎΠ·Π²Ρ€Π°Ρ‰Π°Π΅ΠΌΠΎΠ΅ Π·Π½Π°Ρ‡Π΅Π½ΠΈΠ΅

bridgeShareToStory({ 
  media: "https://i1.sndcdn.com/artworks-000196299556-zqzzcl-t500x500.jpg",
  text: "Каспийский Π“Ρ€ΡƒΠ· 18+ ft. Rigos"
})
{
  status: boolean | 'not_supported'
  error_id: undefined | 1 | 2
}
// Установка HEX-Ρ†Π²Π΅Ρ‚Π°
const result = bridgeSetHeaderColor({ color: '#3498db' })

// ИспользованиС систСмного Ρ†Π²Π΅Ρ‚Π°
bridgeSetHeaderColor({ color_key: 'bg_color' })
{
  status: boolean | 'not_supported'
}
// ИспользованиС систСмного Ρ†Π²Π΅Ρ‚Π°
bridgeSetupClosingBehavior({ need_confirmation: true })
{
  status: boolean | 'not_supported'
}
bridgeShareMessage({ msg_id: 123 })
{
  status: boolean | 'not_supported'
}
bridgeOpenTgLink({ path_full: "apiteamru" })
{
  status: boolean | 'not_supported'
}

checkHomeScreen

ΠœΠ΅Ρ‚ΠΎΠ΄, ΠΊΠΎΡ‚ΠΎΡ€Ρ‹ΠΉ провСряСт, поддСрТиваСтся Π»ΠΈ Π΄ΠΎΠ±Π°Π²Π»Π΅Π½ΠΈΠ΅ Π½Π° Π³Π»Π°Π²Π½Ρ‹ΠΉ экран ΠΈ Π΄ΠΎΠ±Π°Π²Π»Π΅Π½ΠΎ Π»ΠΈ ΡƒΠΆΠ΅ ΠΌΠΈΠ½ΠΈ-ΠΏΡ€ΠΈΠ»ΠΎΠΆΠ΅Π½ΠΈΠ΅.

web_app_check_home_screen

setupFullScreen

ΠœΠ΅Ρ‚ΠΎΠ΄, ΠΊΠΎΡ‚ΠΎΡ€Ρ‹ΠΉ Π·Π°ΠΏΡ€Π°ΡˆΠΈΠ²Π°Π΅Ρ‚ ΠΎΡ‚ΠΊΡ€Ρ‹Ρ‚ΠΈΠ΅ ΠΌΠΈΠ½ΠΈ-прилоТСния Π² полноэкранном Ρ€Π΅ΠΆΠΈΠΌΠ΅.

web_app_request_fullscreen

setEmojiStatus

ΠœΠ΅Ρ‚ΠΎΠ΄, ΠΊΠΎΡ‚ΠΎΡ€Ρ‹ΠΉ ΠΎΡ‚ΠΊΡ€Ρ‹Π²Π°Π΅Ρ‚ Π΄ΠΈΠ°Π»ΠΎΠ³ΠΎΠ²ΠΎΠ΅ ΠΎΠΊΠ½ΠΎ, ΠΏΠΎΠ·Π²ΠΎΠ»ΡΡŽΡ‰Π΅Π΅ ΠΏΠΎΠ»ΡŒΠ·ΠΎΠ²Π°Ρ‚Π΅Π»ΡŽ ΡƒΡΡ‚Π°Π½ΠΎΠ²ΠΈΡ‚ΡŒ ΡƒΠΊΠ°Π·Π°Π½Π½Ρ‹ΠΉ ΠΏΠΎΠ»ΡŒΠ·ΠΎΠ²Π°Ρ‚Π΅Π»ΡŒΡΠΊΠΈΠΉ эмодзи Π² качСствС своСго статуса.

web_app_set_emoji_status

switchInlineQuery

ΠœΠ΅Ρ‚ΠΎΠ΄, ΠΊΠΎΡ‚ΠΎΡ€Ρ‹ΠΉ вставляСт имя ΠΏΠΎΠ»ΡŒΠ·ΠΎΠ²Π°Ρ‚Π΅Π»Ρ Π±ΠΎΡ‚Π° ΠΈ ΡƒΠΊΠ°Π·Π°Π½Π½Ρ‹ΠΉ встроСнный запрос Π² ΠΏΠΎΠ»Π΅ Π²Π²ΠΎΠ΄Π° Ρ‚Π΅ΠΊΡƒΡ‰Π΅Π³ΠΎ Ρ‡Π°Ρ‚Π°. Запрос ΠΌΠΎΠΆΠ΅Ρ‚ Π±Ρ‹Ρ‚ΡŒ пустым, Π² этом случаС Π±ΡƒΠ΄Π΅Ρ‚ вставлСно Ρ‚ΠΎΠ»ΡŒΠΊΠΎ имя ΠΏΠΎΠ»ΡŒΠ·ΠΎΠ²Π°Ρ‚Π΅Π»Ρ Π±ΠΎΡ‚Π°. Если Π±Ρ‹Π»

web_app_switch_inline_query

addToHomeScreen

ΠœΠ΅Ρ‚ΠΎΠ΄, ΠΊΠΎΡ‚ΠΎΡ€Ρ‹ΠΉ ΠΏΡ€Π΅Π΄Π»Π°Π³Π°Π΅Ρ‚ ΠΏΠΎΠ»ΡŒΠ·ΠΎΠ²Π°Ρ‚Π΅Π»ΡŽ Π΄ΠΎΠ±Π°Π²ΠΈΡ‚ΡŒ ΠΌΠΈΠ½ΠΈ-ΠΏΡ€ΠΈΠ»ΠΎΠΆΠ΅Π½ΠΈΠ΅ Π½Π° Π³Π»Π°Π²Π½Ρ‹ΠΉ экран.

web_app_add_to_home_screen

ΠŸΠΎΠ΄Π΄Π΅Ρ€ΠΆΠΊΠ°

Минимальная вСрсия Telegram API: 8.0+

  • Telegram Desktop

  • Telegram Mobile (iOS/Android)

ИспользованиС

Π’ΠΎΠ·Π²Ρ€Π°Ρ‰Π°Π΅ΠΌΠΎΠ΅ Π·Π½Π°Ρ‡Π΅Π½ΠΈΠ΅

Data

status
ОписаниС

unsupported

Ѐункция Π½Π΅ поддСрТиваСтся, ΠΈ Π½Π΅Π²ΠΎΠ·ΠΌΠΎΠΆΠ½ΠΎ Π΄ΠΎΠ±Π°Π²ΠΈΡ‚ΡŒ Π·Π½Π°Ρ‡ΠΎΠΊ Π½Π° Π³Π»Π°Π²Π½Ρ‹ΠΉ экран.

unknown

Ѐункция поддСрТиваСтся, ΠΈ Π·Π½Π°Ρ‡ΠΎΠΊ ΠΌΠΎΠΆΠ½ΠΎ Π΄ΠΎΠ±Π°Π²ΠΈΡ‚ΡŒ, Π½ΠΎ Π½Π΅Π²ΠΎΠ·ΠΌΠΎΠΆΠ½ΠΎ ΠΎΠΏΡ€Π΅Π΄Π΅Π»ΠΈΡ‚ΡŒ, Π±Ρ‹Π» Π»ΠΈ ΠΎΠ½ ΡƒΠΆΠ΅ Π΄ΠΎΠ±Π°Π²Π»Π΅Π½.

added

Π—Π½Π°Ρ‡ΠΎΠΊ ΡƒΠΆΠ΅ Π΄ΠΎΠ±Π°Π²Π»Π΅Π½ Π½Π° Π³Π»Π°Π²Π½Ρ‹ΠΉ экран.

unknown

Π—Π½Π°Ρ‡ΠΎΠΊ Π½Π΅ Π±Ρ‹Π» Π΄ΠΎΠ±Π°Π²Π»Π΅Π½ Π½Π° Π³Π»Π°Π²Π½Ρ‹ΠΉ экран.

Π₯отя Π·Π°Π³ΠΎΠ»ΠΎΠ²ΠΎΠΊ ΠΏΡ€ΠΎΠ·Ρ€Π°Ρ‡Π΅Π½ Π² полноэкранном Ρ€Π΅ΠΆΠΈΠΌΠ΅, рСкомСндуСтся, Ρ‡Ρ‚ΠΎΠ±Ρ‹ ΠΌΠΈΠ½ΠΈ-ΠΏΡ€ΠΈΠ»ΠΎΠΆΠ΅Π½ΠΈΠ΅ Π·Π°Π΄Π°Π²Π°Π»ΠΎ Ρ†Π²Π΅Ρ‚ Π·Π°Π³ΠΎΠ»ΠΎΠ²ΠΊΠ° с ΠΏΠΎΠΌΠΎΡ‰ΡŒΡŽ ΠΌΠ΅Ρ‚ΠΎΠ΄Π° setHeaderColor. Π­Ρ‚ΠΎΡ‚ Ρ†Π²Π΅Ρ‚ ΠΏΠΎΠΌΠΎΠ³Π°Π΅Ρ‚ ΠΎΠΏΡ€Π΅Π΄Π΅Π»ΠΈΡ‚ΡŒ контрастный Ρ†Π²Π΅Ρ‚ для строки состояния ΠΈ Π΄Ρ€ΡƒΠ³ΠΈΡ… элСмСнтов управлСния ΠΏΠΎΠ»ΡŒΠ·ΠΎΠ²Π°Ρ‚Π΅Π»ΡŒΡΠΊΠΎΠ³ΠΎ интСрфСйса.

ΠŸΠΎΠ΄Π΄Π΅Ρ€ΠΆΠΊΠ°

Минимальная вСрсия Telegram API: 8.0+

  • Telegram Web

  • Telegram Desktop

  • Telegram Mobile (iOS/Android)

ИспользованиС

ΠŸΠ°Ρ€Π°ΠΌΠ΅Ρ‚Ρ€Ρ‹

ΠŸΠ°Ρ€Π°ΠΌΠ΅Ρ‚Ρ€
Π’ΠΈΠΏ
ОписаниС

is_full

boolean

Π’ΠΊΠ»ΡŽΡ‡Π΅Π½ΠΈΠ΅/Π’Ρ‹ΠΊΠ»ΡŽΡ‡Π΅Π½ΠΈΠ΅ полноэкранного Ρ€Π΅ΠΆΠΈΠΌΠ°

Π’ΠΎΠ·Π²Ρ€Π°Ρ‰Π°Π΅ΠΌΠΎΠ΅ Π·Π½Π°Ρ‡Π΅Π½ΠΈΠ΅

ΠŸΠΎΠ΄Π΄Π΅Ρ€ΠΆΠΊΠ°

Минимальная вСрсия Telegram API: 8.0+

  • Telegram Web

  • Telegram Desktop

  • Telegram Mobile (iOS/Android)

ИспользованиС

ΠŸΠ°Ρ€Π°ΠΌΠ΅Ρ‚Ρ€Ρ‹

ΠŸΠ°Ρ€Π°ΠΌΠ΅Ρ‚Ρ€
Π’ΠΈΠΏ
ОписаниС

custom_emoji_id

string

Π˜Π΄Π΅Π½Ρ‚ΠΈΡ„ΠΈΠΊΠ°Ρ‚ΠΎΡ€

duration

number

ΠΠ΅ΠΎΠ±ΡΠ·Π°Ρ‚Π΅Π»ΡŒΠ½ΠΎ. ΠŸΡ€ΠΎΠ΄ΠΎΠ»ΠΆΠΈΡ‚Π΅Π»ΡŒΠ½ΠΎΡΡ‚ΡŒ, Π² Ρ‚Π΅Ρ‡Π΅Π½ΠΈΠ΅ ΠΊΠΎΡ‚ΠΎΡ€ΠΎΠΉ статус Π±ΡƒΠ΄Π΅Ρ‚ ΠΎΡΡ‚Π°Π²Π°Ρ‚ΡŒΡΡ установлСнным, Π² сСкундах.

Π’ΠΎΠ·Π²Ρ€Π°Ρ‰Π°Π΅ΠΌΠΎΠ΅ Π·Π½Π°Ρ‡Π΅Π½ΠΈΠ΅

ΠŸΠΎΠ΄Π΄Π΅Ρ€ΠΆΠΊΠ°

Минимальная вСрсия Telegram API: 6.7+

  • Telegram Web

  • Telegram Desktop

  • Telegram Mobile (iOS/Android)

ИспользованиС

ΠŸΠ°Ρ€Π°ΠΌΠ΅Ρ‚Ρ€Ρ‹

ΠŸΠ°Ρ€Π°ΠΌΠ΅Ρ‚Ρ€
Π’ΠΈΠΏ
ОписаниС

query

string

ВСкст, ΠΊΠΎΡ‚ΠΎΡ€Ρ‹ΠΉ Π½Π΅ΠΎΠ±Ρ…ΠΎΠ΄ΠΈΠΌΠΎ Π²ΡΡ‚Π°Π²ΠΈΡ‚ΡŒ Π² ΠΏΠΎΠ»Π΅ Π²Π²ΠΎΠ΄Π° послС Ρ‚Π΅ΠΊΡƒΡ‰Π΅Π³ΠΎ ΠΈΠΌΠ΅Π½ΠΈ Π±ΠΎΡ‚Π°. Максимальная Π΄Π»ΠΈΠ½Π° β€” 256 символов.

chat_types

"users", "bots", "groups", "channels"

ΠΠ΅ΠΎΠ±ΡΠ·Π°Ρ‚Π΅Π»ΡŒΠ½Ρ‹ΠΉ. Бписок Ρ‚ΠΈΠΏΠΎΠ² Ρ‡Π°Ρ‚ΠΎΠ², ΠΊΠΎΡ‚ΠΎΡ€Ρ‹Π΅ ΠΌΠΎΠΆΠ½ΠΎ Π²Ρ‹Π±Ρ€Π°Ρ‚ΡŒ для ΠΎΡ‚ΠΏΡ€Π°Π²ΠΊΠΈ сообщСния. ΠœΠΎΠΆΠ΅Ρ‚ Π±Ρ‹Ρ‚ΡŒ пустым списком.

Π’ΠΎΠ·Π²Ρ€Π°Ρ‰Π°Π΅ΠΌΠΎΠ΅ Π·Π½Π°Ρ‡Π΅Π½ΠΈΠ΅

ΠœΠ΅Ρ‚ΠΎΠ΄ Π½Π΅ провСряСт Π΄ΠΎΠ±Π°Π²Π»Π΅Π½ΠΎ Π»ΠΈ ΠΌΠΈΠ½ΠΈ-ΠΏΡ€ΠΈΠ»ΠΎΠΆΠ΅Π½ΠΈΠ΅ Π½Π° Π³Π»Π°Π²Π½Ρ‹ΠΉ экран.

ΠŸΠΎΠ΄Π΄Π΅Ρ€ΠΆΠΊΠ°

Минимальная вСрсия Telegram API: 8.0+

  • Telegram Desktop

  • Telegram Mobile (iOS/Android)

ИспользованиС

Π’ΠΎΠ·Π²Ρ€Π°Ρ‰Π°Π΅ΠΌΠΎΠ΅ Π·Π½Π°Ρ‡Π΅Π½ΠΈΠ΅

const result = await bridgeCheckHomeScreen({})
{
  status: boolean | 'not_supported'
  data: {
    status: "unsupported" | "unknown" | "added" | "missed"
  }
}
bridgeSetupFullScreen({ is_full:true })
{
  status: boolean | 'not_supported'
}
const result = await bridgeSetEmojiStatus({ custom_emoji_id: "123" })
{
  status: boolean | 'not_supported'
}
// ИспользованиС систСмного Ρ†Π²Π΅Ρ‚Π°
bridgeSwitchInlineQuery({ query: "data", chat_types: ["users", "groups"] })
{
  status: boolean | 'not_supported'
}
bridgeAddToHomeScreen({})
{
  status: boolean | 'not_supported'
}

setupOrientation

ΠœΠ΅Ρ‚ΠΎΠ΄, ΠΊΠΎΡ‚ΠΎΡ€Ρ‹ΠΉ фиксируСт ΠΎΡ€ΠΈΠ΅Π½Ρ‚Π°Ρ†ΠΈΡŽ ΠΌΠΈΠ½ΠΈ-прилоТСния Π² Ρ‚Π΅ΠΊΡƒΡ‰Π΅ΠΌ Ρ€Π΅ΠΆΠΈΠΌΠ΅ (ΠΏΠΎΡ€Ρ‚Ρ€Π΅Ρ‚Π½ΠΎΠΌ ΠΈΠ»ΠΈ альбомном). ПослС Π±Π»ΠΎΠΊΠΈΡ€ΠΎΠ²ΠΊΠΈ ориСнтация остаСтся фиксированной, нСзависимо ΠΎΡ‚ ΠΏΠΎΠ²ΠΎΡ€ΠΎΡ‚Π° устройства. Π­Ρ‚ΠΎ ΠΏΠΎΠ»Π΅Π·Π½ΠΎ, Ссл

web_app_toggle_orientation_lock

ΠŸΠΎΠ΄Π΄Π΅Ρ€ΠΆΠΊΠ°

Минимальная вСрсия Telegram API: 8.0+

  • Telegram Web

  • Telegram Desktop

  • Telegram Mobile (iOS/Android)

ИспользованиС

ΠŸΠ°Ρ€Π°ΠΌΠ΅Ρ‚Ρ€Ρ‹

ΠŸΠ°Ρ€Π°ΠΌΠ΅Ρ‚Ρ€
Π’ΠΈΠΏ
ОписаниС

Π’ΠΎΠ·Π²Ρ€Π°Ρ‰Π°Π΅ΠΌΠΎΠ΅ Π·Π½Π°Ρ‡Π΅Π½ΠΈΠ΅

invokeCustomMethod

ΠœΠ΅Ρ‚ΠΎΠ΄, для Π²Ρ‹Π·ΠΎΠ²Π° кастомных событий.

web_app_invoke_custom_method

locked

boolean

Π’ΠΊΠ»ΡŽΡ‡Π°Π΅Ρ‚/Π’Ρ‹ΠΊΠ»ΡŽΡ‡Π°Π΅Ρ‚ Ρ„ΠΈΠΊΡΠ°Ρ†ΠΈΡŽ экрана

ΠŸΠΎΠ΄Π΄Π΅Ρ€ΠΆΠΊΠ°

Минимальная вСрсия Telegram API: 6.9+

  • Telegram Web

  • Telegram Desktop

  • Telegram Mobile (iOS/Android)

ИспользованиС

ΠŸΠ°Ρ€Π°ΠΌΠ΅Ρ‚Ρ€Ρ‹

ΠŸΠ°Ρ€Π°ΠΌΠ΅Ρ‚Ρ€
Π’ΠΈΠΏ
ОписаниС

req_id

string

ΠΠ΅ΠΎΠ±ΡΠ·Π°Ρ‚Π΅Π»ΡŒΠ½Ρ‹ΠΉ. Π£Π½ΠΈΠΊΠ°Π»ΡŒΠ½Ρ‹ΠΉ ΠΈΠ΄Π΅Π½Ρ‚ΠΈΡ„ΠΈΠΊΠ°Ρ‚ΠΎΡ€

method

string

Имя ΠΌΠ΅Ρ‚ΠΎΠ΄Π°.

params

unknown

ΠŸΠ°Ρ€Π°ΠΌΠ΅Ρ‚Ρ€Ρ‹ согласно ΠΌΠ΅Ρ‚ΠΎΠ΄Ρƒ.

Π’ΠΎΠ·Π²Ρ€Π°Ρ‰Π°Π΅ΠΌΠΎΠ΅ Π·Π½Π°Ρ‡Π΅Π½ΠΈΠ΅

bridgeSetupOrientation({ locked: true })
{
  status: boolean | 'not_supported'
}
// ИспользованиС систСмного Ρ†Π²Π΅Ρ‚Π°
bridgeInvokeCustomMethod({ method: "test_method", params: { test_id: 1 } })
{
  status: boolean | 'not_supported'
  data: undefined | {
    req_id: string
    result: undefined | unknown
    error: undefined | string
  }
}