Alexa.Business.ErrorResponse Interface
If Alexa sends an Alexa.Business
directive to your skill and you can't handle it successfully, respond with an Alexa.Business.ErrorResponse
event. For an overview of the Alexa.Business
interface, see Understand Alexa for Business.
Error response event
In the payload for the Alexa.Business.ErrorResponse
, specify the type of the error and include a message with information about the error. For the list of Alexa.Business
error types, see Error type values.
ErrorResponse event payload details
Field | Description | Type | Required |
---|---|---|---|
type |
The type of error. | String | Yes |
message |
The error message for the error. | String | Yes |
ErrorResponse event format
{
"event": {
"header": {
"namespace": "Alexa.Business",
"name": "ErrorResponse",
"messageId": "a unique identifier, preferably a version 4 UUID",
"payloadVersion": "1.0"
},
"payload": {
"type": "<error type>",
"message": "<error message>"
}
}
}
Error type values
The following table shows the valid Alexa.Business
error types.
Type | Description |
---|---|
RESERVATION_ALREADY_EXISTS | A reservation already exists for the requested meeting time. |
RESERVATION_NOT_ALLOWED | The room does not allow the reservation. Reservations for the room might be restricted. |
RESERVATION_NOT_FOUND | The reservation can't be found. |
RESERVATION_OUTSIDE_BUSINESS_HOURS | The requested meeting time is outside of the normal business hours. |
RESERVATION_TOO_FAR_IN_ADVANCE | The requested meeting time is too far into the future. |
RESERVATION_TOO_LONG | The requested meeting duration is too long. |
RESERVATION_TOO_SHORT | The requested meeting duration is too short. |
RESOURCE_NOT_AVAILABLE | The requested room is unavailable. |
RESOURCE_NOT_FOUND | The requested room does not exist. The room may have existed previously and been deleted, or the room id might be misconfigured. |
UNSUPPORTED_OPERATION | The action requested by the user is not supported by the skill. |
In addition to the Alexa.Business
error types, you can also use Alexa error types. For more information, see Alexa.ErrorResponse error type values.
The following list shows some Alexa error types that you can use in an Alexa.Business.ErrorResponse
event:
- EXPIRED_AUTHORIZATION_CREDENTIAL
- INVALID_AUTHORIZATION_CREDENTIAL
- INTERNAL_ERROR