プロアクティブにエンドポイントを管理するには

プロアクティブにエンドポイントを管理するには

プロアクティブなエンドポイント管理とは、ユーザーがサービスを利用しているアカウントに変更を加えたときに、スキルに関連付けられたエンドポイントの追加、更新、削除をAlexaに通知できるということです。

はじめに

プロアクティブなエンドポイント管理とは、ユーザーがアカウントのデバイスを追加、更新、削除したときに、メッセージをプロアクティブに送信してAlexaに通知することです。これによって、ユーザーは検出ステップをスキップすることができ、デバイスが自動的にAlexaアプリに表示されます。プロアクティブな検出を機能させるには、ユーザーがスマートホームスキルを有効にし、アカウントをシステムにリンクする必要があります。

以前は、ユーザーが新しいエンドポイントを追加したときや既存のエンドポイントを更新したとき(新しいデバイスの追加やデバイスアカウントのシーンの名前変更など)に、Alexaにデバイスの検出やAlexaアプリの使用を指示する必要がありました。その後、Alexaは、ユーザーによって有効にされているすべてのスマートホームスキルに検出リクエストを送信していました。スキルは、ユーザーのアカウントに関連付けられているエンドポイントを記述した応答を送信していました。Alexaが有効にされているエンドポイントを削除する場合も同様に、ユーザーはデバイスを管理するアカウントとAlexaアプリの2か所でエンドポイントを削除する必要がありました。

デバイスをプロアクティブに追加または更新するには、更新されたエンドポイントまたはユーザーに関連付けられているすべてのエンドポイントに関する詳細を含むメッセージを送信します。メッセージはAlexaイベントゲートウェイに送信します。デバイスを削除するには、エンドポイントIDを含むメッセージをイベントゲートウェイに送信します。つまり、ユーザーはAlexaアプリからデバイスを削除する必要がありません。

前提条件

プロアクティブなエンドポイント管理を有効にするには、以下の要件を満たす必要があります。

新規または更新されたデバイスをAlexaに通知する

ユーザーがエンドポイントを追加したり、既存エンドポイントの名前の変更や更新を行ったりした場合、AddOrUpdateReportを送信します。ユーザーアカウントに関連付けられたすべてのエンドポイントか、新規または更新されたエンドポイントのみを含めることができます。スキルの実装内容に応じて選択できます。

削除されたデバイスをAlexaに通知する

ユーザーがアカウントからデバイスを削除した場合、DeleteReportを送信します。

エラーの処理

AlexaイベントゲートウェイがAddOrUpdateReportまたはDeleteReportイベントを正常に受け付けると、HTTP 202応答を受け取ります。それ以外の場合、イベントゲートウェイのエラーコードで説明されているエラーのいずれかを受け取ります。手順に従って問題を診断および修正します。