ym88659208ym87991671
Портирование навыков Алисы | Документация для разработчиков

Портирование навыков Алисы

Обновлено 14 декабря 2023

Формат сообщений SmartApp API отличается от протокола работы навыков Алисы. Поэтому использовать один веб-сервис без доработок не получится.

Правила портирования

Если вы хотите указать тот же Webhook URL, который вы используете для навыка Алисы, убедитесь, что ваш веб-сервис поддерживает формат сообщений SmartApp API и может переключать протоколы в зависимости от источника запроса.

Для предоставления медиафайлов ассистенту вам также потребуется использовать отдельную сеть CDN.

В отличие от Алисы голоса ассистента Салют могут быть не только женского, но и мужского пола. Учитывайте это при портировании реплик. Информация о поле голоса ассистента содержится в payload.character.gender запросов.

Сопоставление протоколов

Ассистент не поддерживает автоматический маппинг сообщений протоколов Алисы и SmartApp API. Ниже вы найдете сопоставление полей обоих протоколов.

Сопоставление полей запросов

Протокол АлисыПротокол ассистента
meta.clientIduuid.userChannel
request.commandpayload.message.original_text
request.originalUtterancepayload.message.original_text
session.application.application_iduuid.userId
session.user.user_iduuid.sub
session.message_idmessageId
session.skill_idpayload.skillId
session.newpayload.new_session
meta.interfaces.screenpayload.device.capabilities.screen.available
request.payloadpayload.server_action.parameters
request.nlu.tokenspayload.message.tokenized_elements_list
request.nlu.entities.typepayload.message.entities.X
request.nlu.entities.valuepayload.message.entities.X.value
request.nlu.intents.Xpayload.intent payload.intent_meta

Сопоставление полей ответов

Протокол АлисыПротокол ассистента
response.textpayload.pronounceText
payload.items.bubble.text
response.end_sessionpayload.finished
response.ttspayload.pronounceText
response.card.typepayload.items[].card.type
response.card.image_idpayload.items[].card.cells[].content.url
response.card.titlepayload.items[].card.cells[].left.texts.title.text
response.card.descriptionpayload.items[].card.cells[].left.texts.subtitle.text
response.card.button.textpayload.items[].card.cells[].content.actions[].text
response.card.button.urlpayload.items[].card.cells[].content.actions[].deep_link
response.card.button.payloadpayload.items[].card.cells[].content.actions[].server_action.parameters
response.card.header.textpayload.items[].card.cells[].left.texts.title.text
response.card.items[].image_idpayload.items[].card.cells[].left.icon.address.url
response.card.items[].titlepayload.items[].card.cells[].left.texts.title.text
response.card.items[].descriptionpayload.items[].card.cells[].left.texts.subtitle.text
response.card.items[].button.textpayload.items[].card.cells[].actions[].text
response.card.items[].button.urlpayload.items[].card.cells[].actions[].deep_link
response.card.items[].button.payloadpayload.items[].card.cells[].actions[].server_action.parameters
card.footer.textpayload.items[].card.cells[].content.text
card.footer.button.textpayload.items[].card.cells[].actions[].text
card.footer.button.urlpayload.items[].card.cells[].actions[].deep_link
card.footer.button.payloadpayload.items[].card.cells[].actions[].server_action.parameters
buttons.titlepayload.suggestions.buttons[].title
buttons.urlpayload.suggestions.buttons[].action.deep_link
buttons.payloadpayload.suggestions.buttons[].action.server_action.parameters
ПАО Сбербанк использует cookie для персонализации сервисов и удобства пользователей.
Вы можете запретить сохранение cookie в настройках своего браузера.