Skip to content
This repository has been archived by the owner on Jul 2, 2024. It is now read-only.

Commit

Permalink
add notices for deprecated Alexa integration support
Browse files Browse the repository at this point in the history
  • Loading branch information
michael-genson committed Jun 25, 2024
1 parent beb8328 commit 159af8a
Show file tree
Hide file tree
Showing 3 changed files with 10 additions and 4 deletions.
4 changes: 4 additions & 0 deletions AppLambda/src/static/templates/alexa_config.html
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,10 @@
{% block content %}

<div>
<div class="alert alert-warning" role="alert">
Starting July 1, 2024, <a href="https://developer.amazon.com/en-US/docs/alexa/custom-skills/access-the-alexa-shopping-and-to-do-lists.html">Amazon is removing all support for integrating with Alexa lists</a>.
Since USL depends on these features to integrate with Alexa, support for Alexa will be removed from USL.
</div>
<div class="row pb-3">
<h4>Alexa Settings</h4>
</div>
Expand Down
4 changes: 4 additions & 0 deletions AppLambda/src/static/templates/home.html
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,10 @@
{% block content %}

<div>
<div class="alert alert-warning" role="alert">
Starting July 1, 2024, <a href="https://developer.amazon.com/en-US/docs/alexa/custom-skills/access-the-alexa-shopping-and-to-do-lists.html">Amazon is removing all support for integrating with Alexa lists</a>.
Since USL depends on these features to integrate with Alexa, support for Alexa will be removed.
</div>
{% if user %}
Welcome to the Unified Shopping List! Add or change your integration configurations above.
{% if docs_url %}
Expand Down
6 changes: 2 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,9 +18,7 @@ Why host a centralized app? Why not build a self-hosted solution / build this fu
---
I am a huge supporter of self-hosted applications; this app is built entirely around Mealie, which itself is a self-hosted app. It's hard to consider data that you have "somewhere else" truly yours.

That said, one of the major roadblocks with integrations comes down to the exposed APIs and authentication schemes. The goal of this app at its inception was to integrate Mealie with [Todoist](https://todoist.com/) and [Amazon's Alexa](https://alexa.amazon.com/) (and, at this time, those are the only supported apps).

The only way to use the [Alexa List Management API](https://developer.amazon.com/en-US/docs/alexa/list-skills/list-management-api-reference.html) is to request an access token from an authorized Alexa skill. To connect to an Alexa skill you need to [build an Alexa skill and connect using OAuth](https://developer.amazon.com/en-US/docs/alexa/custom-skills/access-the-alexa-shopping-and-to-do-lists.html#alexa-lists-access), which requires a central authentication server that connects to an Alexa skill. If you wanted to do this yourself, you would need to [build your own Alexa skill](https://github.com/michael-genson/Unified-Shopping-List-Helper).
That said, one of the major roadblocks with integrations comes down to the exposed APIs and authentication schemes. The goal of this app at its inception was to integrate Mealie with [Todoist](https://todoist.com/) and [Amazon's Alexa](https://alexa.amazon.com/). Sadly, [Amazon is removing all support for integrating with Alexa lists](https://developer.amazon.com/en-US/docs/alexa/custom-skills/access-the-alexa-shopping-and-to-do-lists.html). However, while this was still supported, any and all Alexa integrations require an Alexa skill, which connects via OAuth, which requires a central authentication server. If you wanted to do this yourself, you would need to [build and host your own Alexa skill](https://github.com/michael-genson/Unified-Shopping-List-Helper).

While Todoist has a [REST API](https://developer.todoist.com/rest/v2/#overview), their webhook subscriptions (which this app uses to initiate a sync) [require an app using OAuth](https://developer.todoist.com/sync/v9/#webhooks), which (you guessed it) requires a central authentication server. You *can* get it working without one, but it's not particularly easy if you're not experienced with OAuth.

Expand All @@ -30,9 +28,9 @@ Which applications are supported?
Since we are *just* releasing the Unified Shopping List, we don't support too many applications yet. Feel free to explore GitHub discussions and suggest new apps to support.

Supported applications:
- [Alexa](https://alexa.amazon.com/)
- [Mealie](https://github.com/hay-kot/mealie/) (required, only the *official v1 releases* and *latest release* are supported)
- [Todoist](https://todoist.com/)
- ~~Alexa *[no longer supported by Amazon](https://developer.amazon.com/en-US/docs/alexa/custom-skills/access-the-alexa-shopping-and-to-do-lists.html)*~~


(Soft) Roadmap
Expand Down

0 comments on commit 159af8a

Please sign in to comment.