Alexa Proactive Notification Java Client Sender
Join the DZone community and get the full member experience.Join For Free
This article aims at simplifying sending proactive events to an Alexa Skill from an external Java process.
Based on the video, From Zero to Hero, Part 13: Proactive Events Notifications by German Viscuso, and the Github project by Luca Rosellini written in NodeJS. I have created a Java client so that it is easy to send notifications from any Java/Kotlin-based backend or, for example, from any Android device.
This code performs the following operations:
- Obtain an authentication token from Alexa by using the skill's
client_secret. You can obtain these in the Build Tab — Permissions section of your skill in the Alexa developer console.
- Use the authentication token obtained in the previous step to broadcast notifications to those users of the skill that granted permissions to notifications in the Alexa app. It sends events following the
Remember that if you want to send proactive events to your Skill, you need to modify the Skill's manifest (skill.json) to add notification permissions to the Skill and declare the schema(s) of the proactive events your Skill is allowed to send. Using SMAPI, you need to:
- Add the
permissionsobject to the skill's
- Add the
eventsobject to the skill's
- Redeploy your skill by running:
If you want to declare that the Skill accepts more than one schema, just add them into
events.publications above and remember to change the template in your
Event class from package
The process is more thoroughly described in the official Alexa Proactive Events API documentation.
You can find a working example on how to configure your Skill for Proactive Events in the official Alexa Github repository: https://github.com/alexa/alexa-cookbook/tree/master/feature-demos/skill-demo-proactive-events.
- You need Java >= 1.8 to run the code and Maven to download the required dependencies.
- How to install these two tools goes beyond the scope of this document.
To download project dependencies simply add this dependency to your
After adding the dependency, you can use the client, as shown below:
Environment: whether the target events will be sent to the
developmentendpoints. Allowed values are
Region: identifies the region of the Alexa endpoint to use to send proactive events. Allowed values are
NA(North America), and
FE(Far East). Remember: if your users are located in NA, and you are sending events trough the EU endpoint, users located in NA won't receive any notifications.
These are the values by default of an event when you create it:
You can find all the releases and source code in my GitHub.
Opinions expressed by DZone contributors are their own.