API 上の LINE

LINEメッセージ

NTT CPaaSは、専用のAPIを通じてLINEをサポートしています。NTT CPaaS LINE API を使用して、顧客ベースに通知メッセージを送信します。通信に使用するテンプレートを登録したら、LINE APIのメッセージメソッドを使用してリクエストを作成します。

1 つの API リクエストで複数のテンプレートメッセージを送信できます。追加機能の恩恵を受けたい場合に備えて、送信リクエストに補足オプションを追加することを忘れないでください。

メッセージ・オプション [#message-options-line-messages]

追加のメッセージオプションを API 要求に適用できます。

メッセージのスケジューリング [#scheduling-messages-line-messages]

すべての通信をスケジュールできます。開始日、時刻、およびタイムゾーンを設定できます。この機能は、夜間に顧客の邪魔をしたくない場合や、最適なコンバージョンのために特定の期間にのみメッセージを送信したい場合に便利です。

json

2 "SendAt": 2015-07-07T17:00:00.000+01:00

追加のスケジュールオプションは、送信速度制限を設定することです。たとえば、メッセージを一括送信して、より長い期間にわたってメッセージを配信する場合、送信速度を制限できます。この機能は、ディスパッチされたメッセージに埋め込まれた行動喚起に受信者が反応することが予想される場合に役立ちます。そうすることで、エンドユーザーからの応答の流入でシステムやエージェントを圧倒することを回避し、運用上の負担を回避できます。定期的に送信される**メッセージの数(量)**を設定できます。使用可能な時間単位は、**分、時間、日です。

json

2 "sendingSpeedLimit": { "amount": 30, "timeUnit": "HOUR" }

また、メッセージを配信しない特定のメッセージ配信期間を設定することもできます。開始時刻(時/分)、終了時刻(時/分)、曜日を設定できます。時刻は UTC タイムゾーンで表されます。

json

2 "deliveryTimeWindow": {"days": [ "MONDAY", "TUESDAY", "WEDNESDAY", "THURSDAY", "FRIDAY", "SATURDAY", "SUNDAY" ],"from": { "hour": 6, "minute": 0 },"to": { "hour": 15, "minute": 30 }}

有効期間 [#validity-period-line-messages]

メッセージには、システムがメッセージの配信を試みる特定の期間があります。たとえば、オーディエンスにメッセージを送信するときに、一部のユーザーが携帯電話をオフにしている場合、システムは有効期間が経過するまでこれらのユーザーへの配信を再試行します。デフォルトおよび最大有効期間は 48 時間です。要求ごとに設定する必要はありません。より短い期間を設定する場合は、有効期間で定義する必要があります。使用可能な時間単位は、秒、分、時間です。デフォルト値は minutes です。

json

2 "validityPeriod": { "amount": 30, "timeUnit": "MINUTES" }

SMS フェイルオーバー [#sms-failover-line-messages]

定義した期間内にLINEメッセージが終了ユーザーに届かない場合に備えて、SMSへのフェイルオーバーオプションを追加します。また、SMSメッセージの有効期間を設定することもできます。

json

2 "smsFailover": { "sender": "41793026726", "text": "Failover message text", "validityPeriod": { "amount": 2, "timeUnit": "HOURS" } }

プラットホーム [#platform-line-messages]

LINE APIは、CPaaS Xとシームレスに連携します。これにより、ニーズに合った方法で構成とリソースをより柔軟に管理できます。CPaaS Xの詳細については、CPaaS Xドキュメントを参照してください。

json

2 "platform": {"entityId": "priorityCustomer","applicationId": "clientTestEnvironment"}

Webhook (英語) [#webhooks-line-messages]

webhooks > delivery > url パラメータオプションは、ユーザーがAPI応答を受信するURLを設定できるようにする場合に使用します。API 要求の Webhook パラメーターの下に URL を定義します。

json

2 "webhooks": {"delivery": { "url": "https://www.example.com/line" },}

LINE配信レポート

配信レポートの受信方法では、送信したLINEメッセージの1回限りの配信レポートを取得できます。これを機能させるには、レポートの転送先となるエンドポイントが必要です。Webhooks > delivery > url パラメーターを使用して、各メッセージごとにエンドポイントを指定します。または、エンドポイントの URL をカスタマーサポートに提供すると、カスタマーサポートが設定してくれます。サポートが必要な場合は、[サポート](https://support.nttcpaas.com/hc/ja/requests/new)に連絡してください。

さまざまな理由でエンドポイントへのリアルタイム配信レポートを受信できない場合は、配信レポートのバッチをフェッチして、特定のメッセージが配信されたかどうかを確認する LON 配信レポートの取得方法を提供します。このエンドポイントに対する各要求は、最新の配信レポートのバッチを返します。返却は1回のみとなりますのでご了承ください。