Команды

Передача команды

Команды передаются в массиве items сообщения ANSWER_TO_USER. Пример команд в массиве payload.items:

object

{

• "payload": {

  • "items": [

    • {

      • "command": {

        • "type": "action",
        • "action": {

          • "type": "text",
          • "text": "Текст",
          • "should_send_to_backend": true

          }

        }

      }

    ]

  }

}

Типы команд

Действия

action — команда, внутри которой можно указать любое из действий.

Пример

type	string Тип команды. Команда, содержащая одно из действий (передать текст, открыть диплинк, действие на бэкенде смартапа) Value: "action"
	text (object) or deep_link (object) or server_action (object)

{

• "type": "action",
• "action": {

  • "type": "text",
  • "text": "Текст",
  • "should_send_to_backend": true

  }

}

Описание

type	string Тип команды. Команда, содержащая одно из действий (передать текст, открыть диплинк, действие на бэкенде смартапа) Value: "action"
	text (object) or deep_link (object) or server_action (object)

{

• "type": "action",
• "action": {

  • "type": "text",
  • "text": "Текст",
  • "should_send_to_backend": true

  }

}

Персональные данные

request_permissions — запрос разрешений на получение и обработку данных пользователя.

Пример

type	string Тип команды. Запрос разрешений на получение и обработку данных пользователя Value: "request_permissions"
permissions	Array of strings Items Enum: "geo" "read_contacts" "record_audio" "push" Cписок разрешений, которые требуется запросить у пользователя. Доступные значения: geo — запрос на получение геолокации; read_contacts — запрос на получение доступа к списку контактов; record_audio — запрос на запись аудио; push — запрос на отправку push-уведомлений.

{

• "type": "request_permissions",
• "permissions": [

  • "geo"

  ]

}

Описание

type	string Тип команды. Запрос разрешений на получение и обработку данных пользователя Value: "request_permissions"
permissions	Array of strings Items Enum: "geo" "read_contacts" "record_audio" "push" Cписок разрешений, которые требуется запросить у пользователя. Доступные значения: geo — запрос на получение геолокации; read_contacts — запрос на получение доступа к списку контактов; record_audio — запрос на запись аудио; push — запрос на отправку push-уведомлений.

{

• "type": "request_permissions",
• "permissions": [

  • "geo"

  ]

}

Данные для Canvas App

smart_app_data — команда для передачи данных в Canvas App.

Пример

type	string Тип команды. Команда для передачи данных в Canvas App Value: "smart_app_data"
smart_app_data	object Объект с произвольыми данными для смартапа

{

• "type": "smart_app_data",
• "smart_app_data": { }

}

Описание

type	string Тип команды. Команда для передачи данных в Canvas App Value: "smart_app_data"
smart_app_data	object Объект с произвольыми данными для смартапа

{

• "type": "smart_app_data",
• "smart_app_data": { }

}

Закрытие смартапа

close_app — закрытие смартапа.

Пример

type	string Тип команды. Команда закрытия смартапа Value: "close_app"

{

• "type": "close_app"

}

Описание

type	string Тип команды. Команда закрытия смартапа Value: "close_app"

{

• "type": "close_app"

}

Получение инвойса

payment_invoice — команда для получения инвойса платежа.

Пример

type	string Тип команды Value: "payment_invoice"
	object

{

• "type": "payment_invoice",
• "payment_invoice": {

  • "invoice_id": "118462a"

  }

}

Описание

type	string Тип команды Value: "payment_invoice"
	object

{

• "type": "payment_invoice",
• "payment_invoice": {

  • "invoice_id": "118462a"

  }

}

Отсутствие ответа

do_nothing — команда, которая используется, если на запрос отвечать не надо. При этом с экрана будут удалены все подсказки, добавленные в предыдущем ответе.

Пример

type	string Тип команды Value: "do_nothing"

{

• "type": "do_nothing"

}

Описание

type	string Тип команды Value: "do_nothing"

{

• "type": "do_nothing"

}

Обновлено 29 июня 2022

Заметили ошибку?

Выделите текст и нажмите Ctrl + Enter, чтобы сообщить нам о ней