## 概要 AftershipアカウントとBotpress Botを連携させることができます。リアルタイムで出荷を追跡し、更新が発生するとボットを通じてユーザーに直接通知します。 ## How it works 統合を有効にすると、提供された `API Key` を使ってWebhook サブスクリプションがあなたの Aftership アカウントに設定されます。webhook このサブスクリプションは、貨物の追跡ステータスに重要な変更があるたびに、統合に更新を送信します。 貨物の追跡を開始するには、`Track Shipment` アクションを使用します。追跡番号`が必要で、AftershipのAPIを利用して貨物のステータスを取得・監視し、追跡データ内に一意の`会話ID`を埋め込みます。この ID は会話内で `Aftership Event` をトリガーするために使用され、ボットが出荷の更新に応答できるようにします。 Conversation Id` は各会話に対して一意な識別子です。このフィールドに `` を渡すことで、ID を埋め込むことができます。Aftershipのアップデートを受信する際、`Aftership Event Trigger`のAdvanced Options `Conversation ID`フィールドで `` を使用することができます。これにより、更新は適切な会話に送られます。 完全な統合コードはSimply Great BotsのGitページで見ることができます:[Aftership Repo](https://github.com/SimplyGreatBots/aftership) ### アフターシップのセットアップ #### 前提条件 トラッキング用のwebhook イベントを受信するには、Aftership Pro プラン以上が必要です。 #### API キーの取得 1.Aftership Admin Dashboard](https://admin.aftership.com/)にアクセスします。 2.Developers` -> `API Keys` に移動する。 3.APIキーの作成」をクリックし、キーの名前を付けて「保存」を選択します。 4.APIキーをコピーして安全な場所に貼り付けてください。Botpress のセットアップの際に必要になります。 ####Webhook とシークレット 1.Tracking Dashboard -> Notifications -> Webhooks](https://admin.aftership.com/notifications/webhooks#)に移動します。 2.Webhook Secretをコピーし、安全な場所に貼り付けてください。Botpress のセットアップの際に必要になります。 3.AddWebhook をクリックします。 4.webhook のバージョンをデフォルトの "Legacy "に設定する。 5.Webhook URL`フィールドに、Botpress Aftership integrationのWebhook URLを貼り付ける。 6.webhook の設定を保存します。 ###Botpress セットアップ 1.Aftership SetupからAftership APIキーをコピーし、`API Key`フィールドに貼り付けます。 2.Webhook Secret」をコピーし、「Secret」フィールドに貼り付けます。