Skip to main content

Amazon Alexa Requests

Run in Postman

Please refer to request objects in Amazon Alexa's documentation.

curl --include \
--request POST \
--header "Authorization: Token BOTANALYTICS_CHANNEL_TOKEN" \
--header "Content-Type: application/json"
--data "{
   'messages': [
      {
         'message': {
           
         }
      }
   ]
}" \
https://api.beta.botanalytics.co/v2/messages

Field Descriptions

  • messages (array): An array containing messages.
    • message (object): Represents an individual message.

Please note that the message object within messages array above has the Amazon Alexa's native request object format.

Example of single message payload in JSON format

{
  "messages": [
    {
    	  "message": {
		    "version": "1.0",
		    "session": {
		      "new": true,
		      "sessionId": "amzn1.echo-api.session.ec389df4-8963-4e1a-b7db-daf029249990",
		      "application": {
		        "applicationId": "amzn1.ask.skill.1c491832-7b2e-4247-8300-a5f6f8041df3"
		      },
		      "user": {
		        "userId": "amzn1.ask.account.AGNXEZOAZXB4GG44YZZTDHYCKGUYNH3GTBMY3L6K5FOHGFTR3V3A7ZKJ2EYAIPILK3E44XYRLIF4QW7RRHQVQJK66LYQU7CL2CB23E6WVTN2WQYLQKQSCEW3HRLU3MHR3E5ZGPLCSSDKUH34SO53IJ75IDYCNZNQV3UOZOF4IF52HRUUD2K7NU3NHAYRY5ZTAITAASDJACHZ5JA"
		      }
		    },
		    "context": {
		      "Extensions": {
		        "available": {}
		      },
		      "System": {
		        "application": {
		          "applicationId": "amzn1.ask.skill.1c491832-7b2e-4247-8300-a5f6f8041df3"
		        },
		        "user": {
		          "userId": "amzn1.ask.account.AGNXEZOAZXB4GG44YZZTDHYCKGUYNH3GTBMY3L6K5FOHGFTR3V3A7ZKJ2EYAIPILK3E44XYRLIF4QW7RRHQVQJK66LYQU7CL2CB23E6WVTN2WQYLQKQSCEW3HRLU3MHR3E5ZGPLCSSDKUH34SO53IJ75IDYCNZNQV3UOZOF4IF52HRUUD2K7NU3NHAYRY5ZTAITAASDJACHZ5JA"
		        },
		        "device": {
		          "deviceId": "amzn1.ask.device.AE3SAOAZ23RI24BCEO54JULKAGKRHXQHO7MINX5QX3NWNS7LBEC4J4XHPHWCWIL7PJJFVKC6NLV7JE26AKWVDKKBGMK42ZHU5KMAPY5QRY6AGGG5PRQOQMQNAFNOEO6UGCVPJDRHECGWAOFYCUCJFP6ERA7VI6KGDAN6HMSCA3QUVHZEMGPEC",
		          "supportedInterfaces": {
		            "AudioPlayer": {
		            }
		          }
		        },
		        "apiEndpoint": "https://api.amazonalexa.com",
		        "apiAccessToken": "eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImtpZCI6IjEifQ.eyJhdWQiOiJodHRwczovL2FwaS5hbWF6b25hbGV4YS5jb20iLCJpc3MiOiJBbGV4YVNraWxsS2l0Iiwic3ViIjoiYW16bjEuYXNrLnNraWxsLjIxYzczMzgyLTQ0YTMtNDMzYS04NWFjLTgwNGExN2UzYTNmMCIsImV4cCI6MTYxMDg0MzMzOSwiaWF0IjoxNjEwODQzMDM5LCJuYmYiOjE2MTA4NDMwMzksInByaXZhdGVDbGFpbXMiOnsiY29udGV4dCI6IkFBQUFBQUFBQUFBQTVqdWRqamt0Sjd5Q2JIdHJOSXhUS2dFQUFBQUFBQUIvb2JGUzQySG10SFUzeTRXZ05RRjBLVmM2MWE2OVc0ZU5VSGVrMEhMR0J0YTRvK1QwS2pjdkZvbXNpSTNJNmQzanB1NVEyeThhSmhnYjRnZ3pkbGVkY3NBN3pqZSszR01FYnIvSVVyRTJqOFEzVWpmb1huczNjYUlwTTVjWjFaQXY3OGR5QnJmK05ET1dDVUNPZ1ozeDkxY0tQN0V1dFlmLzNnZU5hQ21kVTIvNE9SZEQ1OHZwZ0pJdENwQnpZZ3lnc1o3elZBVEtQRlJWMThIMzhHekkxMmNDMXhxL2NMSWRncGNPeTBONFFRTFZlS3pVQzlQUmpnNEdOOVlWa3JaOVlDTnpMN0paY0RWd0VUa1JXVmlIQ1ZqWWR4UmtUcXpYM2djQWpJUnJMdWYyemg2c3dFWWZ0b2ZBZzBGVFZCUjdheGtpQkRsdE1aMjRYeGFiUkgrTDYyZW1xRWdicE5WSWRVa0xYV1R2NWFnRjNkUXJtVnN1eGNNMm4xdWNiQXRLVHFSQWR0TnhNamRRIiwiY29uc2VudFRva2VuIjpudWxsLCJkZXZpY2VJZCI6ImFtem4xLmFzay5kZXZpY2UuQUUzU0FPQVoyM1JJMjRCQ0VPNTRKVUxLQUdLUkhYUUhPN01JTlg1UVgzTldOUzdMQkVDNEo0WEhQSFdDV0lMN1BKSkZWS0M2TkxWN0pFMjZBS1dWREtLQkdNSzQyWkhVNUtNQVBZNVFSWTZBR0dHNVBSUU9RTVFOQUZOT0VPNlVHQ1ZQSkRSSEVDR1dBT0ZZQ1VDSkZQNkVSQTdWSTZLR0RBTjZITVNDQTNRVVZIWkVNR1BFQyIsInVzZXJJZCI6ImFtem4xLmFzay5hY2NvdW50LkFIVElFTjNEVlVFQkpVNjRPVko2QTZCWjZBUkJEWUZSRDJWRVZPR0JSTkxNUktMV1gzWEhMVkdHM1pOVVRZVUxOVVlBMlNMSzJSM1AzSkJFSU01RkFWSE1MMlZOS1hLTlNYWFpUTjRYVllVUDU2N1JOTEwzSkc2S1hPWUlXR1M2VDVLSUZCQlJRWElXNzY2T1VBWkFCTUNHWlUySjJMRVE2VjNYSElXTUpTT1pBWU1NTU1NTkhFRVVHNkY3WVNVN1U1WFZPVlRCUkhYWDdTWSJ9fQ.K_1l7hD9qcYo500qaW_wyQwhzrD73eICZ_S-F4Kf4pkYoPNz_qPV62fplQA4J3uNMTAg-KZRjSDbgLu2XWhnjMO4kNod5U4aTs91qRTQ-BRksCNwMmVihcSOhuNx49cAuL2M1gW9Te8Zi6z590S0x02Xnipkm27sWyRK9-tF5ScFM347ccSbdG_SjlHT1fUuwR3pngeArdFG0ABWYUejrwX_qosRoU61MDIOGmFqIHfaFnSSyhAP5Rh0ewb6M2dcIE7U_2Ep0mIhlxMaU61gCKkFZrAqgDEQ_zBItUvFyvNm7qox-SaqsqTJmhi8rVOk119JEz0gJHtf3RM9IAKNvA",
		        "unit": {
		          "unitId": "amzn1.ask.unit.AEIRFWKIPA5SVFEVMW5XVGL5ET6CCJ7AJ5NMCTRUFXD3MIHESUD2GM5BOPDGCXDKMCA3KW65LPNTJO7SWMMOK3FUIMQYVDDKLMZV22PJMF7AYYACAS77FWH6AX6SGCFGPM"
		        }
		      },
		      "AudioPlayer": {
		        "playerActivity": "PLAYING",
		        "token": "audioplayer-token",
		        "offsetInMilliseconds": 0
		      }
		    },
		    "request": {
		      "type": "IntentRequest",
		      "requestId": "amzn1.echo-api.request.e0275bd3-af29-4722-add8-94f3fb7c00d4",
		      "timestamp": "2021-01-18T13:38:53Z",
		      "locale": "en-US",
		      "intent":
		      {
		        "name":"RecommendationIntent",
		        "confirmationStatus":"NONE",
		        "slots":{
		          "I_Am":{
		            "name":"I_Am",
		            "confirmationStatus":"NONE",
		            "source":"USER"
		          },
		          "bloodTolerance":{
		            "name":"bloodTolerance",
		            "confirmationStatus":"NONE",
		            "source":"USER"
		          },
		          "I_Want":{
		            "name":"I_Want",
		            "confirmationStatus":"NONE",
		            "source":"USER"
		          },
		          "personality":{
		            "name":"personality",
		            "confirmationStatus":"NONE",
		            "source":"USER"
		          }
		        }
		      },
		      "dialogState": "STARTED"
		    }
		  }
    }
  ]
}

Example of multiple messages payload in JSON format

{
  "messages": [
    {
        "message": {
		    "version": "1.0",
		    "session": {
		      "new": true,
		      "sessionId": "amzn1.echo-api.session.ec389df4-8963-4e1a-b7db-daf029249990",
		      "application": {
		        "applicationId": "amzn1.ask.skill.1c491832-7b2e-4247-8300-a5f6f8041df3"
		      },
		      "user": {
		        "userId": "amzn1.ask.account.AGNXEZOAZXB4GG44YZZTDHYCKGUYNH3GTBMY3L6K5FOHGFTR3V3A7ZKJ2EYAIPILK3E44XYRLIF4QW7RRHQVQJK66LYQU7CL2CB23E6WVTN2WQYLQKQSCEW3HRLU3MHR3E5ZGPLCSSDKUH34SO53IJ75IDYCNZNQV3UOZOF4IF52HRUUD2K7NU3NHAYRY5ZTAITAASDJACHZ5JA"
		      }
		    },
		    "context": {
		      "Extensions": {
		        "available": {}
		      },
		      "System": {
		        "application": {
		          "applicationId": "amzn1.ask.skill.1c491832-7b2e-4247-8300-a5f6f8041df3"
		        },
		        "user": {
		          "userId": "amzn1.ask.account.AGNXEZOAZXB4GG44YZZTDHYCKGUYNH3GTBMY3L6K5FOHGFTR3V3A7ZKJ2EYAIPILK3E44XYRLIF4QW7RRHQVQJK66LYQU7CL2CB23E6WVTN2WQYLQKQSCEW3HRLU3MHR3E5ZGPLCSSDKUH34SO53IJ75IDYCNZNQV3UOZOF4IF52HRUUD2K7NU3NHAYRY5ZTAITAASDJACHZ5JA"
		        },
		        "device": {
		          "deviceId": "amzn1.ask.device.AE3SAOAZ23RI24BCEO54JULKAGKRHXQHO7MINX5QX3NWNS7LBEC4J4XHPHWCWIL7PJJFVKC6NLV7JE26AKWVDKKBGMK42ZHU5KMAPY5QRY6AGGG5PRQOQMQNAFNOEO6UGCVPJDRHECGWAOFYCUCJFP6ERA7VI6KGDAN6HMSCA3QUVHZEMGPEC",
		          "supportedInterfaces": {
		            "AudioPlayer": {
		            }
		          }
		        },
		        "apiEndpoint": "https://api.amazonalexa.com",
		        "apiAccessToken": "eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImtpZCI6IjEifQ.eyJhdWQiOiJodHRwczovL2FwaS5hbWF6b25hbGV4YS5jb20iLCJpc3MiOiJBbGV4YVNraWxsS2l0Iiwic3ViIjoiYW16bjEuYXNrLnNraWxsLjIxYzczMzgyLTQ0YTMtNDMzYS04NWFjLTgwNGExN2UzYTNmMCIsImV4cCI6MTYxMDg0MzMzOSwiaWF0IjoxNjEwODQzMDM5LCJuYmYiOjE2MTA4NDMwMzksInByaXZhdGVDbGFpbXMiOnsiY29udGV4dCI6IkFBQUFBQUFBQUFBQTVqdWRqamt0Sjd5Q2JIdHJOSXhUS2dFQUFBQUFBQUIvb2JGUzQySG10SFUzeTRXZ05RRjBLVmM2MWE2OVc0ZU5VSGVrMEhMR0J0YTRvK1QwS2pjdkZvbXNpSTNJNmQzanB1NVEyeThhSmhnYjRnZ3pkbGVkY3NBN3pqZSszR01FYnIvSVVyRTJqOFEzVWpmb1huczNjYUlwTTVjWjFaQXY3OGR5QnJmK05ET1dDVUNPZ1ozeDkxY0tQN0V1dFlmLzNnZU5hQ21kVTIvNE9SZEQ1OHZwZ0pJdENwQnpZZ3lnc1o3elZBVEtQRlJWMThIMzhHekkxMmNDMXhxL2NMSWRncGNPeTBONFFRTFZlS3pVQzlQUmpnNEdOOVlWa3JaOVlDTnpMN0paY0RWd0VUa1JXVmlIQ1ZqWWR4UmtUcXpYM2djQWpJUnJMdWYyemg2c3dFWWZ0b2ZBZzBGVFZCUjdheGtpQkRsdE1aMjRYeGFiUkgrTDYyZW1xRWdicE5WSWRVa0xYV1R2NWFnRjNkUXJtVnN1eGNNMm4xdWNiQXRLVHFSQWR0TnhNamRRIiwiY29uc2VudFRva2VuIjpudWxsLCJkZXZpY2VJZCI6ImFtem4xLmFzay5kZXZpY2UuQUUzU0FPQVoyM1JJMjRCQ0VPNTRKVUxLQUdLUkhYUUhPN01JTlg1UVgzTldOUzdMQkVDNEo0WEhQSFdDV0lMN1BKSkZWS0M2TkxWN0pFMjZBS1dWREtLQkdNSzQyWkhVNUtNQVBZNVFSWTZBR0dHNVBSUU9RTVFOQUZOT0VPNlVHQ1ZQSkRSSEVDR1dBT0ZZQ1VDSkZQNkVSQTdWSTZLR0RBTjZITVNDQTNRVVZIWkVNR1BFQyIsInVzZXJJZCI6ImFtem4xLmFzay5hY2NvdW50LkFIVElFTjNEVlVFQkpVNjRPVko2QTZCWjZBUkJEWUZSRDJWRVZPR0JSTkxNUktMV1gzWEhMVkdHM1pOVVRZVUxOVVlBMlNMSzJSM1AzSkJFSU01RkFWSE1MMlZOS1hLTlNYWFpUTjRYVllVUDU2N1JOTEwzSkc2S1hPWUlXR1M2VDVLSUZCQlJRWElXNzY2T1VBWkFCTUNHWlUySjJMRVE2VjNYSElXTUpTT1pBWU1NTU1NTkhFRVVHNkY3WVNVN1U1WFZPVlRCUkhYWDdTWSJ9fQ.K_1l7hD9qcYo500qaW_wyQwhzrD73eICZ_S-F4Kf4pkYoPNz_qPV62fplQA4J3uNMTAg-KZRjSDbgLu2XWhnjMO4kNod5U4aTs91qRTQ-BRksCNwMmVihcSOhuNx49cAuL2M1gW9Te8Zi6z590S0x02Xnipkm27sWyRK9-tF5ScFM347ccSbdG_SjlHT1fUuwR3pngeArdFG0ABWYUejrwX_qosRoU61MDIOGmFqIHfaFnSSyhAP5Rh0ewb6M2dcIE7U_2Ep0mIhlxMaU61gCKkFZrAqgDEQ_zBItUvFyvNm7qox-SaqsqTJmhi8rVOk119JEz0gJHtf3RM9IAKNvA",
		        "unit": {
		          "unitId": "amzn1.ask.unit.AEIRFWKIPA5SVFEVMW5XVGL5ET6CCJ7AJ5NMCTRUFXD3MIHESUD2GM5BOPDGCXDKMCA3KW65LPNTJO7SWMMOK3FUIMQYVDDKLMZV22PJMF7AYYACAS77FWH6AX6SGCFGPM"
		        }
		      },
		      "AudioPlayer": {
		        "playerActivity": "PLAYING",
		        "token": "audioplayer-token",
		        "offsetInMilliseconds": 0
		      }
		    },
		    "request": {
		      "type": "IntentRequest",
		      "requestId": "amzn1.echo-api.request.e0275bd3-af29-4722-add8-94f3fb7c00d4",
		      "timestamp": "2021-01-18T13:38:53Z",
		      "locale": "en-US",
		      "intent":
		      {
		        "name":"RecommendationIntent",
		        "confirmationStatus":"NONE",
		        "slots":{
		          "I_Am":{
		            "name":"I_Am",
		            "confirmationStatus":"NONE",
		            "source":"USER"
		          },
		          "bloodTolerance":{
		            "name":"bloodTolerance",
		            "confirmationStatus":"NONE",
		            "source":"USER"
		          },
		          "I_Want":{
		            "name":"I_Want",
		            "confirmationStatus":"NONE",
		            "source":"USER"
		          },
		          "personality":{
		            "name":"personality",
		            "confirmationStatus":"NONE",
		            "source":"USER"
		          }
		        }
		      },
		      "dialogState": "STARTED"
		    }
		  }
    },
    {
       "message": {
	      "version": "1.0",
	      "session":
	      {
	        "new": false,
	        "sessionId":  "amzn1.echo-api.session.ec389df4-8963-4e1a-b7db-daf029249990",
	        "application":
	        {
	          "applicationId": "amzn1.ask.skill.1c491832-7b2e-4247-8300-a5f6f8041df3"
	        },
	        "user":
	        {
	          "userId": "amzn1.ask.account.AGNXEZOAZXB4GG44YZZTDHYCKGUYNH3GTBMY3L6K5FOHGFTR3V3A7ZKJ2EYAIPILK3E44XYRLIF4QW7RRHQVQJK66LYQU7CL2CB23E6WVTN2WQYLQKQSCEW3HRLU3MHR3E5ZGPLCSSDKUH34SO53IJ75IDYCNZNQV3UOZOF4IF52HRUUD2K7NU3NHAYRY5ZTAITAASDJACHZ5JA"
	        }
	      },
	      "context":
	      {
	        "Extensions":
	        {
	          "available":
	          {}
	        },
	        "System":
	        {
	          "application":
	          {
	            "applicationId": "amzn1.ask.skill.1c491832-7b2e-4247-8300-a5f6f8041df3"
	          },
	          "user":
	          {
	            "userId": "amzn1.ask.account.AGNXEZOAZXB4GG44YZZTDHYCKGUYNH3GTBMY3L6K5FOHGFTR3V3A7ZKJ2EYAIPILK3E44XYRLIF4QW7RRHQVQJK66LYQU7CL2CB23E6WVTN2WQYLQKQSCEW3HRLU3MHR3E5ZGPLCSSDKUH34SO53IJ75IDYCNZNQV3UOZOF4IF52HRUUD2K7NU3NHAYRY5ZTAITAASDJACHZ5JA"
	          },
	          "device": {
	            "deviceId": "amzn1.ask.device.AE3SAOAZ23RI24BCEO54JULKAGKRHXQHO7MINX5QX3NWNS7LBEC4J4XHPHWCWIL7PJJFVKC6NLV7JE26AKWVDKKBGMK42ZHU5KMAPY5QRY6AGGG5PRQOQMQNAFNOEO6UGCVPJDRHECGWAOFYCUCJFP6ERA7VI6KGDAN6HMSCA3QUVHZEMGPEC",
	            "supportedInterfaces": {
	              "AudioPlayer": {
	              }
	            }
	          },
	          "apiEndpoint": "https://api.amazonalexa.com",
	          "apiAccessToken": "eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImtpZCI6IjEifQ.eyJhdWQiOiJodHRwczovL2FwaS5hbWF6b25hbGV4YS5jb20iLCJpc3MiOiJBbGV4YVNraWxsS2l0Iiwic3ViIjoiYW16bjEuYXNrLnNraWxsLjJkZDhlM2FhLTdmMzctNDczMi04NjhjLTkzNWZjMWZmYzEwYiIsImV4cCI6MTYxMDg5MjEyMCwiaWF0IjoxNjEwODkxODIwLCJuYmYiOjE2MTA4OTE4MjAsInByaXZhdGVDbGFpbXMiOnsiY29udGV4dCI6IkFBQUFBQUFBQUFBanZZelpQMS9lTVBCWEpmSy9YeDVsS2dFQUFBQUFBQUFMZTFDMHhDeU52M2d4Ymhxc2NSTExhRFN5d3NMM1JqQWc5Qi9TUHBSOHdIMDFHVXhrWVpXVGRWZU1LTEx2M3IxNHVtclZFb2RZWnRpSjkxMnNQRUVJclNZajRmWG1STXRwOGJzVkdlWWlWRkdnREtoVzF6M3dXeVhaRFdrWmc1TkZHeG13TUlheTEzclhUWUloeXpJdlVYQXd1djFwOURsYmJxVEFSQVlGemsyaFZ0M3B0bnJRdS8xdVB4MjBHWW5OTW5QeG12MU5aTGJHcW1FTC9DczJpb1ZKaFU4Sk5hL2twNGlGempid25wWUVkYUVuZVpSS3lNNktKdzMrMTQxTXlOSDQ0ZWZPSUVIaVVlZUk4TnNJZGNuUW8vT0ExRGZJdFcxSWMwcm85NENsRVh6dDBINWhKOWQ4WDIxYTE2cmlOM3ExcmdCYy9mMzllTEIzUnNkWm92K3N3dUpUa0ZIMFRyV1U0bStrSUVnR2JZd3lSWWVTMFUwYlVvSVYxR3ZmYWZlM1JVeTJIT2xZIiwiY29uc2VudFRva2VuIjpudWxsLCJkZXZpY2VJZCI6ImFtem4xLmFzay5kZXZpY2UuQUZJSVFZSFNOUVlPQ0pSMkVERjJKQktGMzY1NVM0N0pXUTZMNkpNMzZESzNTSkdRUEtJVzVCMjZYQzMySE5BRkNRWlZBVjU2U0w2RUJDM1dESkNHU0tPUE1LSFc2UFdWUFRFTk9aSDJZSURKMlBQUU42SkdNVjNKVVpWS0xaUUs3TjI3S09GUUtDTUJLTlZQNVNZSzJSQjZBUlpDU1lZVEJCVTVGUkNZMk9DVUJSR1ZKVDdXSSIsInVzZXJJZCI6ImFtem4xLmFzay5hY2NvdW50LkFHRFJZQVpTR0gySDNIMjZFTVkyT1NVVUxNSTJUUlE3Nkc1TUxBSElFT04yMjdQSlIzWlg2VFc3VzdCNE42WldYTURaS1JWSlJOQlVBM1VEWlZONENDUVdCVkc3Q1ZMM0hHTlFJU0VCWkhDUENIMzQ0SkJHTk5OM0hXM01WREI0T1E0T0lBTjQ3S0ROQVhXNjU0UkFJT0dWTlBCUkY2VlZEVjdEVzVaUjU3RVdKWTRUT0RTSTJZWlAzQU9WNU83TDJDTDVWQkRFUkFYUFJWQSJ9fQ.BYOfyJZ12dhXh5NN-PQyU47dQLH3v5M_81rBoS25KXkHn_cmZXfOWjEAfs4PcHmmuFBs6tekHp_nMsNkZw9Q4EqVmSMu4T63pffD9OUq0yI5hwS5TePYUFYbNer5sxXvtR7zuJKUWCoGQ0V2ZDskF-9xZz6FtN39NYMLTBhKTRb8BDNEaXbjkcjYNDpyaOXQK9emx0LXfTs-ztFaYEt-j-l51fO7frysivUm8f-xMcZ5Dk3-JheBjZiJ0wXoNO-_tbu03XsSNZt4iS6vnStKanzjK9mnjiDGHXFFCEyBTbtQVuJszh_Q_cp8vLnfzP14CIsCBcrV03airGAVE6NiCw"
	        }
	      },
	      "request":
	      {
	        "type": "SessionEndedRequest",
	        "requestId": "amzn1.echo-api.request.e0275bd3-af29-4722-add8-94f3fb7c00d4",
	        "timestamp": "2021-01-18T13:38:53Z",
	        "locale": "en-US",
	        "reason": "EXCEEDED_MAX_REPROMPTS"
	      }
	  }
    }
  ]
}