question

Hi Davide,

we would need the following information:

- All capabilities of your device (JSON)
- Sample utterances that you are using to retrieve temperature and targetSetpoint
- Skill-ID

thanks,
Gaetano

Hello Gaetano

here's the required informations:

1. Capabilities:

{
    "event": {
        "endpoint": {
            "endpointId": "INVALID",
            "scope": {
                "type": "BearerToken",
                "token": "INVALID"
            }
        },
        "payload": {
            "endpoints": [
                {
                    "displayCategories": [
                        "THERMOSTAT"
                    ],
                    "capabilities": [
                        {
                            "type": "AlexaInterface",
                            "interface": "Alexa",
                            "version": "3"
                        },
                        {
                            "type": "AlexaInterface",
                            "interface": "Alexa.PowerController",
                            "version": "3",
                            "properties": {
                                "retrievable": true,
                                "supported": [
                                    {
                                        "name": "powerState"
                                    }
                                ],
                                "proactivelyReported": true
                            }
                        },
                        {
                            "type": "AlexaInterface",
                            "interface": "Alexa.ThermostatController",
                            "version": "3",
                            "properties": {
                                "retrievable": true,
                                "supported": [
                                    {
                                        "name": "targetSetpoint"
                                    },
                                    {
                                        "name": "thermostatMode"
                                    }
                                ],
                                "proactivelyReported": true
                            }
                        },
                        {
                            "type": "AlexaInterface",
                            "interface": "Alexa.TemperatureSensor",
                            "version": "3",
                            "properties": {
                                "retrievable": true,
                                "supported": [
                                    {
                                        "name": "temperature"
                                    }
                                ],
                                "proactivelyReported": true
                            }
                        }
                    ],
                    "manufacturerName": "Sample Manufacturer",
                    "endpointId": "smart-thermostat-01",
                    "description": "Sample Endpoint Description",
                    "friendlyName": "Termostato"
                }
            ]
        },
        "header": {
            "payloadVersion": "3",
            "namespace": "Alexa.Discovery",
            "name": "Discover.Response",
            "messageId": "4a80a415-017e-4c94-9428-c456c80de073"
        }
    }
}

2. Skill ID: amzn1.ask.skill.894dc9fa-8121-4792-b194-10bcaf84a298

3. Utterances I use for retrieving the measured temperature (TemperatureSensor):

- Alexa, qual è la temperatura di termostato?

- Alexa, che temperatura sta misurando termostato?

- Alexa, qual è la temperatura misurata dal termostato?

4. Utterances I use for retrieving the targetSetPoint (TermostatController):

- Alexa, quale temperatura è impostata su termostato ?

- Alexa, a che temperatura è impostato termostato ?

- Alexa, com' è impostato il termostato ?

Generally speaking I think that the documentation should contain some samples related to the utterances which can be used for the retrieval of any single "retrievable" property....

Thanks in advance

Davide

Hi Davide,

currently, it is not possible to retrieve the powerState info through the voice. It is only available for smart locks and thermostats.

I'd suggest posting these as feature requests in Uservoice for Alexa over here.

Regards,
Gaetano

Hi Gaetano

thank you for the suggestions.

I still have a couple of questions:

1. When you say that the poweState is retrievable for thermostats, what do you exactly mean? I am working on a smart thermostat device but I'm unable to retrieve the powerState by voice. Could you please provide a sample working utterance I should use?

2. Could you please tell me if some sort of properties list (retrievable by voice) is available anywhere?It's a bit hard to understand which ones are retrievable or not... For example I'm experiencing the same issue also for the retrieval of the "connectivity" property of "EndpointHealth". Am I failing to ask or is also this property unretrievable (by voice) ?

Thank you

Davide

Hi Davide,

I've actually made a typo. I was meaning that you can retrieve properties by voice only from the Alexa.ThermostatController and the Alexa.LockController interface.

So the properties you can query by voice for these devices are respectively temperature and state. In Italian, they would be:

Thermostat:

A quanto è impostato <device name>? 
Su quanto è impostato <device name>?
A quanto è messo <device name>? 
Su quanto è messo <device name>?
Qual è la temperatura di <device name>?

Lock:

<lock name> è chiuso?
<lock name> è chiusa?
è aperto <lock name>?
è aperta <lock name>?
<lock name> è aperto?
<lock name> è aperta?

Feel free to post any suggestion/request to the UserVoice for Alexa portal, linked above.

Kind regards,

Gaetano