Categories:
Aura response error messages
Sometimes, Aura could return some errors due to authentication or other APIs errors. This document describes the most common errors and how clients should handle them.
Unauthenticated error
In some channels that require authentication, Aura could return an unauthenticated error if the auraId is invalid. In this cases, the client should
authenticate the user again and create a new auraId.
ChannelData v3 example:
{
"type": "message",
"id": "4VJyNMnfcQLHuvOAbXMLAK-fr|0000005",
"timestamp": "2024-06-27T14:01:24.9377437Z",
"channelId": "directline",
"from": {
"id": "aura-bot-x",
"name": "aura-bot-x"
},
"conversation": {
"id": "4VJyNMnfcQLHuvOAbXMLAK-fr"
},
"text": "Desculpe, não consegui verificar suas informações. Por favor, reinicie o aplicativo e tente novamente.",
"inputHint": "acceptingInput",
"channelData": {
"correlator": "5b25cd4a-aa57-420d-9fb3-8db437df01cf",
"version": "3",
"status": {
"code": "ERROR.USER.UNAUTHENTICATED",
"message": "Invalid aura user",
"params": {
"auraId": "asdf"
}
}
},
"replyToId": "4VJyNMnfcQLHuvOAbXMLAK-fr|0000004"
}
ChannelData v1 example:
{
"type": "message",
"id": "4VJyNMnfcQLHuvOAbXMLAK-fr|0000003",
"timestamp": "2024-06-27T14:01:07.7998256Z",
"channelId": "directline",
"from": {
"id": "aura-bot-x",
"name": "aura-bot-x"
},
"conversation": {
"id": "4VJyNMnfcQLHuvOAbXMLAK-fr"
},
"text": "Desculpe, não consegui verificar suas informações. Por favor, reinicie o aplicativo e tente novamente.",
"speak": "Desculpe, não consegui verificar suas informações. Por favor, reinicie o aplicativo e tente novamente.",
"inputHint": "acceptingInput",
"channelData": {
"hasMoreMessages": false,
"correlator": "593a44ac-3974-472b-a7e4-610b3c760679",
"Error": {
"code": "UNAUTHENTICATED",
"data": "invalidAuraId",
"message": "Invalid auraId"
}
},
"replyToId": "4VJyNMnfcQLHuvOAbXMLAK-fr|0000002"
}
Too many requests error
In some cases, certain APIs could return an error 429 due to quota limits or other reasons. In these scenarios, the client should wait the returned
value of the parameter retryAfter and try again after this time.
ChannelData v3 example:
{
"type": "message",
"id": "H2JRTbQW25d6Jyccs7PfEb-fr|0000007",
"timestamp": "2024-06-27T14:08:26.8101993Z",
"channelId": "directline",
"from": {
"id": "aura-bot-x",
"name": "aura-bot-x"
},
"conversation": {
"id": "H2JRTbQW25d6Jyccs7PfEb-fr"
},
"text": "Lo sentimos, ha ocurrido un error inesperado.",
"inputHint": "acceptingInput",
"channelData": {
"correlator": "9df5cb1b-966c-4db4-9df8-e269c682a58b",
"version": "3",
"status": {
"code": "ERROR.API.TOO_MANY_REQUESTS",
"message": "Too many requests",
"params": {
"retryAfter": "10"
}
}
},
"replyToId": "H2JRTbQW25d6Jyccs7PfEb-fr|0000006"
}
ChannelData v1 example:
{
"type": "message",
"id": "H2JRTbQW25d6Jyccs7PfEb-fr|0000009",
"timestamp": "2024-06-27T14:08:45.5260908Z",
"channelId": "directline",
"from": {
"id": "aura-bot-x",
"name": "aura-bot-x"
},
"conversation": {
"id": "H2JRTbQW25d6Jyccs7PfEb-fr"
},
"text": "Lo sentimos, ha ocurrido un error inesperado.",
"speak": "Lo sentimos, ha ocurrido un error inesperado.",
"inputHint": "acceptingInput",
"channelData": {
"hasMoreMessages": false,
"correlator": "cd06e100-7783-46e8-8051-ee99e8b72f43",
"Error": {
"code": "TOO_MANY_REQUESTS",
"data": {
"retryAfter": "10"
},
"message": "Too many requests"
}
},
"replyToId": "H2JRTbQW25d6Jyccs7PfEb-fr|0000008"
}
Last modified January 15, 2025: feat: Documentation Assistant and ATRIA for Linkin Park release #AURA-26619 [RTM] (409958c0)