# LINE OA Streaming Export連携

LINE公式アカウント(LINE OA) Streaming Export連携を使うと、Treasure AIのアクティベーションワークフローの一部として、LINEユーザーへリアルタイムにメッセージを配信できます。

この連携では、リアルタイムトリガー型アクティベーションを使って、LINEユーザーへ即座にメッセージを送信できます。

## 前提条件

- Treasure AIの基礎知識
- LINE公式アカウントとLINE Messaging APIの基礎知識
- Messaging APIが有効なLINE公式アカウントへのアクセス権
- LINE OAのチャネルアクセストークンとチャネルシークレット


## ユースケース

このストリーミング連携の主なユースケースは、リアルタイムアクティベーションワークフローに組み込んで、次のことを行うことです。

- LINE OAユーザーへのメッセージ配信をトリガーする


配信をトリガーするワークフローの設定手順の概要は次のとおりです。

1. LINE Developers Consoleで、LINE公式アカウントを作成または選択し、Messaging APIを有効化します。
2. Messaging APIの設定画面から、Channel Access Tokenを取得します。
3. この連携がLINE OAと通信するための認証を作成します。
4. Real-time Journeyで、新しいトリガー型アクティベーションにこの認証を選択します。


## 要件と制限事項

- このコネクタには、LINE Messaging APIの制限が適用されます。詳細は[LINE Messaging APIのレート制限](https://developers.line.biz/en/docs/messaging-api/limits/)を参照してください。


## Treasure コンソールからLINE OA Streaming Exportを設定

Treasure AIでデータ接続を作成して設定する必要があります。データ接続の一部として、連携にアクセスするための認証情報を指定します。

### 認証の作成

認証情報を使って新しい認証を作成するには、次の手順を実行します。

1. Integrations Hubを選択します。
2. Catalogを選択します。
3. Catalogで連携を検索し、アイコンにマウスカーソルを合わせて、Create Authenticationを選択します。


![Integrations HubのCatalogに表示されたLINE OAコネクタのタイル](/assets/line-oa-streaming-logo.4b5114345157c2691bd2f667419dc9b3854d7359aa557f451dbd3ab7415b01aa.c9dfba80.png)

1. Credentialsタブが選択されていることを確認し、連携の認証情報を入力します。


### 新しい認証フィールド

![Channel Access Tokenのフィールドが表示された認証設定画面](/assets/line-oa-streaming-channel-access-token.f0b7c4505d94c89da83afee27880fdca06eefd8e1f5de88116705778b6ca64c7.c9dfba80.webp)

| パラメータ | 説明 |
|  --- | --- |
| Channel Access Token | LINE公式アカウントのチャネルのMessaging API設定にあるChannel Access Tokenです |


1. **Continue**を選択します。
2. 接続の名前を入力します。
3. **Done**を選択します。


LINE OA Streaming連携を設定すると、リアルタイムのカスタマージャーニーのアクティベーションに組み込めるようになります。詳細は[リアルタイムトリガー型アクティベーションの作成](/ja/products/customer-data-platform/journey-orchestration/realtime/creating-a-real-time-triggered-activation)を参照してください。

### リアルタイムトリガー型アクティベーション

トリガー型アクティベーションを作成または更新するには、次の手順を実行します。

1. 設定するトリガー型アクティベーションを選択します ![トリガー型アクティベーションのアイコン](/assets/triggeredactivation.66e546b8c4cc774c0bdd804d0d099b63cf12b1916181d85d7c715be95bd61810.9e7171ae.png)。
2. トリガー型アクティベーションのウィンドウで、Copy triggered activation fromドロップダウンメニューからアクティベーションを選択します。
3. Triggered activation nameを入力します。
4. 必要に応じて、アクティベーションの説明(Optional description)を入力します。
5. Authenticationドロップダウンメニューから、アクティベーションで使用する認証を選択します。


入力が必要な項目は、選択した認証の種類によって異なります。詳細は、以下の連携ごとの表を参照してください。

![LINE OA Output Streamingのアクティベーション設定](/assets/line-oa-streaming-triggered-activation.ad4a4275fb903f91424542bf22936676048cb277690b2d8b74f7ceb11880d36c.c9dfba80.png)

1. Detailsページの各フィールドに必要な情報を確認または入力します。
2. Detailsの設定が終わったら、**Create**または**Update**を選択します。


### 連携パラメータ

| パラメータ | 値 | 説明 |
|  --- | --- | --- |
| **Recipient ID** | 必須 - String | 受信者のユーザーID(LINEが発行したもの) |
| **Messages Payload** | 必須 - JSON Array | 送信するメッセージオブジェクトの配列([LINE Messaging APIリファレンス](https://developers.line.biz/en/reference/messaging-api/#send-message)を参照) |
| **Maximum Number Of Retry** | 任意、デフォルト 3 | 送信を断念するまでのリトライ回数です。0から5までの整数です。 |
| **Initial Retry Delay** | 任意、デフォルト 2 | 最初のリトライまでの待機時間（秒）です。0から60までの整数です。 |
| **Retry Delay Multiple** | 任意、デフォルト 2 | リトライのたびに待機時間に掛ける倍率です。1から2までの整数です。 |


## リトライとログのロジック

- ステータスコード429、500、502、503、504を受け取った場合、コネクタはリクエストを再送します。
- **Maximum Number of Retry**に達する前にリクエストの送信に成功した場合、ログには成功と表示されます。
- **Maximum Number of Retry**に達してもリクエストが失敗する場合、コネクタはジョブを停止します。
- リクエストの送信が失敗するたびに、クライアントのアクティベーションテーブルにエラーメッセージとステータスコードが記録されます。
- **Maximum Number of Retry**は、Activation Configで設定できます。