Примеры Deeplink для мобильного приложения Салют

Обновлено 27 февраля 2024

Диплинк можно использовать для запуска смартапа в мобильном приложении Салют и для передачи собственных параметров в это приложение. Раздел содержит подробное описание доступных параметров.

Передача фразы

Данный вид диплинка позволяет передать ассистенту любую заданную фразу:

companionapp://navigation?pageId=assistant&text=фраза%20для%20ассистента

Вместо фраза%20для%20ассистента нужно указать необходимый текст, используя вместо пробелов сочетание симвоолов %20. Фраза передается так, как если бы пользователь сам продиктовал или написал ее.

Примеры

После перехода по этому диплинку откроется игра «Города»:

companionapp://navigation?pageId=assistant&text=запусти%20игру%20города

После перехода по этому диплинку ассистент расскажет пользователю о погоде:

companionapp://navigation?pageId=assistant&text=скажи%20погоду

Запуск смартапа

Данный вид диплинка позволяет запустить навык по значению projectId:

companionapp://navigation?pageId=assistant&projectId=идентификатор_проекта_смартапа

Вместо идентификатор_проекта_смартапа нужно указать projectId смартапа, который нужно запустить.

Примеры

После перехода по этому диплинку откроется смартап «Финбо»:

companionapp://navigation?pageId=assistant&projectId=1bb07d4c-33ee-46c3-a5ca-b177182d39c8

При запуске смартапа по диплинкам такого вида в Graph не будет срабатывать событие «Запуск приложения по deeplink».

Передача события «Запуск приложения по deeplink»

Данный вид диплинка позволяет запустить смартап по значению projectId и передать в смартап информацию о том, что запуск происходит через диплинк.

companionapp://navigation?pageId=assistant&projectId=идентификатор_проекта_смартапа&deeplink_guid=deeplink

Вместо идентификатор_проекта_смартапа нужно указать projectId смартапа, который нужно запустить.

При запуске смартапа по диплинкам такого вида не происходит автоматического попадания в начало сценария или отправки команды /start. Для корректного запуска смартапа:

• Graph
• Code

Создайте блок Событие > Запуск приложения по deeplink.

Добавьте event!: RUN_APP_DEEPLINK в стейт, который вы хотите сделать началом сценария.

Примеры

После перехода по этому диплинку откроется смартап с projectId = e2b3eb40-95c1-4975-8db6-ca8bdda2f338 и в него будет отправлено событие «Запуск приложения по deeplink». Сценарий запустится корректно только если в нем будет предусмотрена обработка данного события.

companionapp://navigation?pageId=assistant&projectId=e2b3eb40-95c1-4975-8db6-ca8bdda2f338&deeplink_guid=deeplink

• Graph
• Code

Пример обработки события в сценарии Graph:

Пример обработки события в сценарии Code:

    state: Начало сценария, при запуске по данному диплинку
        event!: RUN_APP_DEEPLINK
        a: Вы запустили смартап по диплинку

Запуск и передача произвольного события

Данный вид диплинка позволяет запустить навык по значению projectId и передать в смартап произвольное событие. Разные произвольные события заданные в диплинках помогут вам открывать соответствующие разделы сценария смартапа.

companionapp://navigation?pageId=assistant&projectId=идентификатор_проекта_смартапа&deeplink_guid=deeplink&action_id=имя_события

Вместо идентификатор_проекта_смартапа нужно указать projectId смартапа, который нужно запустить. Вместо имя_события нужно указать название произвольного события на латинице.

Для корректного запуска смартапа:

• Graph
• Code

Создайте блок Событие и добавьте в него собственное событие с тем же названием, которое указано в диплинке.

Добавьте event!: <имя_события> в стейт, который вы хотите сделать началом сценария.

Примеры

После перехода по этому диплинку откроется смартап с projectId = e2b3eb40-95c1-4975-8db6-ca8bdda2f338 и в него будет отправлено событие QWERTY. Сценарий запустится корректно только если в нем будет предусмотрена обработка данного события.

companionapp://navigation?pageId=assistant&projectId=e2b3eb40-95c1-4975-8db6-ca8bdda2f338&deeplink_guid=deeplink&action_id=QWERTY

• Graph
• Code

Пример обработки события в сценарии Graph:

Пример обработки события в сценарии Code:

    state: Запуск с событием QWERTY
        event!: QWERTY
        a: Вы запустили смартап по диплинку с событием QWERTY

Запуск и передача произвольного параметра

Данный вид диплинка позволяет запустить навык по значению projectId и передать в смартап любой параметр и его значение.

(сделать строку вставкой кода)

companionapp://navigation?pageId=assistant&projectId=идентификатор_проекта_смартапа&deeplink_guid=deeplink&название_параметра=значение_параметра

Правила заполнения:

• Вместо идентификатор_проекта_смартапа укажите projectId смартапа, который нужно запускать.
• Вместо название_параметра укажите название параметра, который нужно обработать в смартапе.
• Вместо значение_параметра укажите значение, которое нужно задать параметру.