dialogs

type Answer struct {
	// Версия протокола.
	Version string `json:"version"`

	// Данные о сессии.
	Session Session `json:"session"`

	// Данные для ответа пользователю.
	Response Response `json:"response"`
}

type Answers chan Answer

type Button struct {
	// Текст кнопки.
	Title string `json:"title"`

	// Произвольный JSON, который Яндекс.Диалоги должны отправить
	// обработчику, если данная кнопка будет нажата.
	Payload Payload `json:"payload,omitempty"`

	// URL, который должна открывать кнопка.
	URL string `json:"url"`

	// Признак того, что кнопку нужно убрать после следующего запроса
	// пользователя. Допустимые значения:
	// * false — кнопка должна оставаться активной (значение по умолчанию);
	// * true — кнопку нужно скрывать после нажатия.
	Hide bool `json:"hide"`
}

type Markup struct {
	// Признак реплики, которая содержит криминальный подтекст (самоубийство,
	// разжигание ненависти, угрозы). Вы можете настроить навык на
	// определенную реакцию для таких случаев — например, отвечать "Не
	// понимаю, о чем вы. Пожалуйста, переформулируйте вопрос."
	//
	// Возможно только значение true. Если признак не применим, это свойство
	// не включается в ответ.
	DangerousContext bool `json:"dangerous_context,omitempty"`
}

type Meta struct {
	// Язык в POSIX-формате.
	Locale string `json:"locale"`

	// Название часового пояса, включая алиасы.
	TimeZone string `json:"timezone"`

	// Идентификатор устройства и приложения, в котором идет разговор.
	ClientID string `json:"client_id"`
}

type Payload interface{}

type Question struct {
	// Информация об устройстве, с помощью которого пользователь
	// разговаривает с Алисой.
	Meta Meta `json:"meta"`

	// Данные, полученные от пользователя.
	Request Request `json:"request"`

	// Данные о сессии.
	Session Session `json:"session"`

	// Версия протокола.
	Version string `json:"version"`
}

type Questions <-chan Question

type Request struct {
	// Тип ввода:
	// * SimpleUtterance — голосовой ввод;
	// * ButtonPressed — нажатие кнопки.
	Type string `json:"type"`

	// Формальные характеристики реплики, которые удалось выделить
	// Яндекс.Диалогам. Отсутствует, если ни одно из вложенных свойств не
	// применимо.
	Markup Markup `json:"markup,omitempty"`

	// Текст пользовательского запроса без активационных фраз Алисы и
	// конкретного навыка.
	Command string `json:"command"`

	// Полный текст пользовательского запроса.
	OriginalUtterance string `json:"original_utterance"`

	// JSON, полученный с нажатой кнопкой от обработчика навыка (в ответе на
	// предыдущий запрос).
	Payload Payload `json:"payload,omitempty"`
}

type Response struct {
	// Текст, который следует показать пользователю.
	Text string `json:"text"`

	// Ответ в формате TTS (text-to-speech).
	TTS string `json:"tts"`

	// Кнопки, которые следует показать пользователю.
	Buttons []Button `json:"buttons"`

	// Признак конца разговора (получая этот флаг в ответе, Алиса
	// автоматически завершает работу навыка в приложении).
	EndSession bool `json:"end_session"`
}

type Session struct {
	// Признак новой сессии. Возможные значения:
	// * true — пользователь начал новый разговор с навыком;
	// * false — запрос отправлен в рамках уже начатого разговора.
	New bool `json:"new"`

	// Уникальный идентификатор сессии, 64 байта.
	SessionID string `json:"session_id"`

	// Идентификатор сообщения в рамках сессии. Инкрементируется с каждым
	// следующим запросом.
	MessageID int64 `json:"message_id"`

	// Идентификатор вызываемого навыка.
	SkillID string `json:"skill_id"`

	// Обфусцированный идентификатор пользователя.
	UserID string `json:"user_id"`
}