Интеграция для разработчиков

URL-схема

Bot Connector регистрирует пользовательскую URL-схему botconnector:// на iOS. Любое приложение или веб-страница может открыть приложение или запустить нужный сценарий с помощью этой схемы.

botconnector://[v1]/[action]?[params]

Добавить подписку

Самая распространённая интеграция — открыть Bot Connector и предложить пользователю добавить URL подписки.

botconnector://add-subscription?url={url}&name={name}&autoConnect={true|false}

JavaScript

jsif (await tryOpen('botconnector://add-subscription?url=' + encodeURIComponent(subUrl))) {
  return // app opened
}
window.location.href = 'https://apps.apple.com/app/id${APP_STORE_ID}'

Python

pyimport urllib.parse
url = "botconnector://add-subscription?url=" + urllib.parse.quote(sub_url)

Bash (macOS)

bashopen "botconnector://add-subscription?url=$(python3 -c 'import urllib.parse,sys; print(urllib.parse.quote(sys.argv[1]))' "$SUB_URL")"

Swift

swiftlet encoded = subscriptionURL.addingPercentEncoding(withAllowedCharacters: .urlQueryAllowed)!
let url = URL(string: "botconnector://add-subscription?url=\(encoded)")!
UIApplication.shared.open(url)

Открыть приложение

Используйте botconnector:// (без пути), чтобы просто открыть приложение.

Пример HTML-кнопки

html<a href="botconnector://add-subscription?url=https%3A%2F%2Fexample.com%2Fsub.txt"
   style="display:inline-block;padding:.75rem 1.25rem;border-radius:9999px;background:#1E5BFF;color:#fff;text-decoration:none;font-weight:600;">
  Open in Bot Connector
</a>

Интеграция через QR-код

Закодируйте botconnector:// URL в QR-код, чтобы мобильные пользователи могли импортировать подписку без ввода текста.

Smart App Banner

Добавьте этот мета-тег на свою страницу, чтобы показать Smart App Banner в iOS Safari со ссылкой на Bot Connector в App Store.

html<meta name="apple-itunes-app" content="app-id=6767189747, app-argument=botconnector://" />

Поведение при установленном и неустановленном приложении

• • Если приложение установлено, deep-link открывается мгновенно.
• • Если приложение не установлено, iOS предложит открыть App Store. Это можно определить в JavaScript с помощью таймаута.

Проверка установки приложения

Перед вызовом deep-link проверьте, установлен ли Bot Connector.

Universal Links (скоро)

Версионирование

Версия схемы deep-link кодируется в префиксе пути. Текущая версия: v1. Если версия не указана, по умолчанию используется v1.

v1

Тестирование

Тестируйте deep-link через адресную строку Safari на реальном устройстве или в симуляторе iOS.

Что не поддерживается