API経由のカカオトーク
Infobipは 、専用API (opens in a new tab)を通じてカカオトークをサポートしています。
- Infobip Kakao Alim API (opens in a new tab): 顧客ベースに通知メッセージを送信します。通信用のテンプレートを登録したら、カカオアリムAPIメッセージメソッドを使用してリクエストを作成して送信します。
- Infobip Kakao Sangdam API (opens in a new tab): 顧客とのリアルタイムの会話を設定し、ライブエージェントサポートを提供し、エージェントが最高のカスタマーサービスを提供できるようにします。
- Infobip カカオ チング API (opens in a new tab): カカオ チング API を使用して、プロモーション コンテンツを配信し、カスタマイズされたメッセージで顧客を引き付けます。この API を使用すると、企業はフレンド トーク メッセージの送信、プロモーション コードの共有、限定オファーの提供、動的なキャンペーンの作成を行って、認知度を高め、売上を伸ばし、顧客ロイヤルティを育成できます。
追加機能の恩恵を受けたい場合に備えて、送信リクエストに補足オプションを追加することを忘れないでください。
メッセージ・オプション
追加のメッセージ オプションを API 要求に適用できます。
一括メッセージ
1 つの API リクエストで複数のテキストメッセージまたはメッセージテンプレートを送信できます。
メッセージのスケジューリング
すべての通信をスケジュールできます。開始日、時刻、タイムゾーンを設定できます。この機能は、夜間に顧客の邪魔をしたくない場合や、最適なコンバージョンのために特定の期間にのみメッセージを送信したい場合に便利です。
"SendAt": 2015-07-07T17:00:00.000+01:00
追加のスケジュールオプションは、送信速度制限を設定することです。たとえば、メッセージを一括送信して、より長い期間にわたってメッセージを配信する場合、送信速度を制限できます。この機能は、ディスパッチされたメッセージに埋め込まれた行動喚起に受信者が反応することが予想される場合に役立ちます。そうすることで、エンドユーザーからの応答の流入でシステムやエージェントを圧倒することを回避し、運用上の負担を回避できます。定期的に送信される**メッセージの数(量)**を設定できます。使用可能な時間単位は、分、時間、日です。
"sendingSpeedLimit": {
"amount": 30,
"timeUnit": "HOUR"
}
また、メッセージを配信しない特定のメッセージ配信期間を設定することもできます。開始時刻(時/分)、終了時刻(時/分)、曜日を設定できます。時刻は UTC タイム ゾーンで表されます。
"deliveryTimeWindow": {
"days": [
"MONDAY",
"TUESDAY",
"WEDNESDAY",
"THURSDAY",
"FRIDAY",
"SATURDAY",
"SUNDAY"
],
"from": {
"hour": 6,
"minute": 0
},
"to": {
"hour": 15,
"minute": 30
}
}
有効期間
メッセージには、システムがメッセージの配信を試みる特定の期間があります。たとえば、オーディエンスにメッセージを送信するときに、一部のユーザーが携帯電話をオフにしている場合、システムは有効期間が経過するまでこれらのユーザーへの配信を再試行します。デフォルトおよび最大有効期間は 48 時間です。要求ごとに設定する必要はありません。より短い期間を設定する場合は、有効期間で定義する必要があります。使用可能な時間単位は、秒、分、時間です。デフォルト値は minutes です。
"validityPeriod": {
"amount": 30,
"timeUnit": "MINUTES"
}
SMS フェイルオーバー
定義された期間内にカカオアリムのメッセージが終了ユーザー届かない場合に備えてSMSオプションへのフェイルオーバーを追加します。また、SMSメッセージの有効期間を設定することもできます。
"smsFailover": {
"sender": "41793026726",
"text": "Failover message text",
"validityPeriod": {
"amount": 2,
"timeUnit": "HOURS"
}
}
プラットホーム
カカオAPIはCPaaS Xとシームレスに連携します。これにより、ニーズに合った方法で構成とリソースをより柔軟に管理できます。CPaaS Xの詳細については、CPaaS Xドキュメントを参照してください。
"platform": {
"entityId": "priorityCustomer",
"applicationId": "clientTestEnvironment"
}
Webhook (英語)
webhooks
> delivery
> url
パラメータ オプションは、ユーザーがAPI応答を受信するURLを設定できるようにする場合に使用します。API 要求の Webhook パラメーターの下に URL を定義します。
"webhooks": {
"delivery": {
"url": "https://www.example.com/kakaotalk"
},
}
URL の短縮と追跡
カカオチングメッセージは、URL短縮および追跡機能をサポートしています。これにより、短縮URLを カカオチングAPI (opens in a new tab) 経由で送信し、そのパフォーマンスを監視して、顧客エンゲージメントとインタラクションに関するより良い洞察を得ることができます。メッセージ本文と URL CTA を開くボタンのリンクを追跡できます。
この機能は、ブロードキャストを使用している場合にも利用できます。
この機能を有効にするには、次の手順を実行します。
-
URL の短縮とトラッキングを有効にする:
- API リクエストで、
shortenUrl
パラメータとtrackClicks
パラメータをtrue
に設定します。
- API リクエストで、
-
カスタム ドメインとトラッキング URL を構成する:
- 短縮 URL にブランディングを反映させる場合は、
customDomain
パラメーターを使用して、登録済みのカスタム ドメインを定義します。以前に カスタム ドメインを登録 していることを確認します。 - コールバック サーバーでクリック レポートを受信するには、
trackingUrl
を指定します。提供されない場合、追跡データには他の方法でアクセスできる場合があります。
- 短縮 URL にブランディングを反映させる場合は、
-
プロトコルの削除:
- 必要に応じて、
removeProtocol
をtrue
に設定して、プロトコルを削除して URL をさらに短縮します (例:https://
)。
- 必要に応じて、
"options": {
"tracking": {
"shortenUrl": true,
"trackClicks": true,
"trackingUrl": "https://example.com/click-report",
"removeProtocol": true,
"customDomain": "example.com"
}
}
受信メッセージ
着信メッセージは、カカオサンダムを双方向通信に使用すると、リアルタイムで転送されます。
配信レポート
この方法では、送信されたカカオアリムメッセージの1回限りの配信レポートを取得できます。
エンドポイントは、次の場所で定義されます。
- プラットフォーム内のアカウントレベルの設定
- (オプション)
webhooks
>delivery
>メッセージのAPIリクエストのurl
パラメータ。このエンドポイントを定義しない場合、レポートはプラットフォームで定義されているエンドポイントに転送されます