Собрать deep link happ://add самому из https-ссылки

Как из обычной ссылки-подписки сделать deep link happ://add, который открывает Happ и добавляет профиль в одно касание: формат, где вставлять, зачем это нужно и ошибки.

Кнопка «Добавить в Happ» — это deep link happ://add/…, и никакой магии в нём нет. Если сервис выдал только текстовую ссылку https://…, а хочется добавлять её в одно касание, собрать такой deep link можно самому за десять секунд.

Формат

Правило одно: к адресу подписки спереди приписывается префикс happ://add/.

happ://add/https://домен-сервиса/sub/abc123…

Внутри — ваша обычная https-ссылка, целиком, включая параметры после ?. Ничего не кодируется и не обрезается: приложение снимает префикс и получает исходный адрес. Как устроены сами ссылки и чем deep link отличается от зашифрованного happ://crypt — в статье как выглядит ссылка.

Собрать и открыть

1. Скопируйте ссылку-подписку из кабинета или письма — с https:// в начале и без пробелов.
2. Вставьте её в любое текстовое поле (заметки, адресная строка) и допишите перед ней happ://add/ без пробела.
3. Проверьте, что получилось happ://add/https://… — два «двоеточия со слешами», это нормально.
4. На телефоне: скопируйте строку и в Happ нажмите «+» → из буфера, либо нажмите на строку как на ссылку в заметках или мессенджере.
5. На компьютере: вставьте строку в адресную строку браузера и нажмите Enter; браузер спросит «Открыть Happ?» — согласитесь.

Профиль появится в Happ, дальше — выбрать сервер и подключиться.

Зачем это нужно

• Сервис даёт только текст. Deep link превращает его в кнопку — например, в заметке, куда вы сохранили ссылку для всех своих устройств.
• Кнопка сервиса не сработала. Иногда причина — во встроенном браузере мессенджера; тот же deep link, открытый в обычном браузере, обычно проходит. Почему кнопка молчит.
• Вы делаете страницу для своих. Семейный доступ, инструкция для родителей: ссылка happ://add/… в тексте становится кнопкой сама.

Ограничение тоже одно: deep link понимает только Happ. У совместимых клиентов свои схемы, и happ://add/ они не откроют — для них остаётся исходная https-ссылка.

Где deep link не поможет

Если сервис перестал отдавать серверы — срок истёк, ссылка перевыпущена, — deep link добавит пустой профиль, как и любой другой способ: он только доставляет адрес в приложение. Что делать, когда нет серверов после добавления, — отдельная страница. У Вятка собирать ничего не нужно: кнопка «Добавить в Happ» в кабинете — это уже готовый happ://add/, а рядом лежит https-ссылка для других клиентов.