Alexa.DoorbellEventSource Interface
Implement the Alexa.DoorbellEventSource
interface in your Alexa skill for devices that raise doorbell events. The customer selects which of their Echo devices respond to doorbell events. Alexa uses doorbell events for announcements, mobile notifications, routines, and other use cases. For more details about security skills, see Smart Home Security Overview.
When a doorbell event occurs, Alexa plays the doorbell announcement on the selected Echo devices. If the customer selected an Echo device without a screen, the Echo device plays the doorbell announcement. If the customer selected an Echo Show device and the doorbell implements the Alexa.RTCSessionController interface, the Echo Show device plays the doorbell announcement and automatically displays a live feed from the doorbell video camera when the doorbell event occurs.
For the list of languages that the DoorbellEventSource
interface supports, see List of Alexa Interfaces and Supported Languages.
Discovery
You describe endpoints that support Alexa.DoorbellEventSource
using the standard discovery mechanism described in Alexa.Discovery.
Use DOORBELL
for the display category. For the full list of display categories, see display categories.
Discover response example
{
"event": {
"header": {
"namespace":"Alexa.Discovery",
"name":"Discover.Response",
"payloadVersion":"3",
"messageId": "a unique identifier, preferably a version 4 UUID"
},
"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": ["DOORBELL"],
"cookie": {},
"capabilities": [
{
"type": "AlexaInterface",
"interface": "Alexa.DoorbellEventSource",
"version": "3",
"proactivelyReported" : true
}
]
}
]
}
}
}
DoorbellPress event
Send a DoorbellPress
event to the Alexa Event Gateway whenever your device detects the doorbell press. For details, see Send Events to the Event Gateway.
When your skill reports a DoorbellPress
event, you must wait at least 30 seconds before sending another DoorbellPress
event for the same device.
DoorbellPress event payload details
Field | Description | Type | Required |
---|---|---|---|
cause |
Describes why this event occurred. | A cause object | Yes |
timestamp |
When the activation event occurred, specified in UTC. | A string in ISO 8601 format, YYYY-MM-DDThh:mm:ssZ . |
Yes |
DoorbellPress event example
{
"context": { },
"event": {
"header": {
"messageId": "9eac4fa2-9de0-4e75-ac38-9dde79abb1bd",
"namespace" : "Alexa.DoorbellEventSource",
"name": "DoorbellPress",
"payloadVersion": "3"
},
"endpoint": {
"scope": {
"type": "BearerToken",
"token": "access-token-from-Amazon"
},
"endpointId": "appliance-001"
},
"payload" : {
"cause": {
"type": "PHYSICAL_INTERACTION"
},
"timestamp": "2018-06-09T23:23:23.23Z"
}
}
}