Alexa Interface

The Alexa interface is the top-level interface for Alexa skills. For the full list of Alexa interfaces, see List of Alexa Interfaces.

The Alexa interface contains general Alexa directives, response events, discovery, state reporting, change reporting, and error reporting. For more information, see Alexa Interface Message Guide.

Support the Alexa interface in all skills

You should explicitly identify your support for the Alexa interface in the Discover.Response for your skills. For more information about discovery, see Alexa.Discovery Interface.

The following example shows a Discover.Response message for an endpoint that supports the Alexa.PowerController. You also explicitly identify your support for the Alexa interface. For more discovery examples, see the documentation for each interface.

Copied to clipboard.

{
  "event": {
    "header": {
      "namespace": "Alexa.Discovery",
      "name": "Discover.Response",
      "payloadVersion": "3",
      "messageId": "<message id>"
    },
    "payload": {
      "endpoints":[
        {
          "endpointId": "<unique ID of the endpoint>",
          "manufacturerName": "<the manufacturer name of the endpoint>",
          "description": "<a description that is shown in the Alexa app>",
          "friendlyName": "<device name, displayed in the Alexa app>",
          "displayCategories": ["LIGHT"],
          "cookie": {},
          "capabilities": [
            {
              "type": "AlexaInterface",
              "interface": "Alexa.PowerController",
              "version": "3",
              "properties": {
                "supported": [
                  {
                    "name": "powerState"
                  }
                ],
                "proactivelyReported": true,
                "retrievable": true
              }
            },
            {
              "type": "AlexaInterface",
              "interface": "Alexa",
              "version": "3"
            }
          ]
        }
      ]
    }
  }
}