Social Engagement Setup リソース

管理ソーシャルアカウントを認証する場合、一般的なフローでは次のガイドラインに従います。

1. ソーシャルネットワークパラメータ (socialNetwork) と各自のサービスへのコールバック URL (callbackUrl) を使用して、/connect/social-engagement/setup/managed-social-accounts/authentication に対して GET 要求を実行します。
2. GET 要求に対する応答には、認証を開始するために使用される OAuth URL (oauthUrl) とセキュリティ上の目的で使用される OAuth JWT (oauthJWT) が含まれます。
3. システム管理者にブラウザフォームを表示します。このフォームのアクションは OAuth URL (oauthUrl) に設定されていて、フォームのメソッドは POST で、フォームの stringToken という 1 つの非表示項目は OAuth JWT (oauthJWT) 値に設定されています。
4. フォームを送信します。これにより、ブラウザが OAuth URL (oauthUrl) にリダイレクトされ、目的のソーシャルネットワークのログインページがシステム管理者に表示されます。
5. システム管理者は、ソーシャルネットワークのログイン情報を使用してログインし、権限をアプリケーションに付与します。
6. ブラウザがコールバック URL (callbackUrl) にリダイレクトされます。URL の末尾には accountId クエリパラメータが追加されています。
7. コールバック URL の場所で実行されているサービスは、accountId クエリパラメータをキャプチャし、/connect/social-engagement/setup/managed-social-accounts に対して GET 要求を実行します。クエリパラメータから取得した accountId 値を managedAccountId パラメータに設定します。
8. GET に対する応答には、すでに追加されているアカウントと共にソーシャルカスタマーサービスに追加できるソーシャルネットワークのソーシャルアカウントのリストが含まれます。すでに追加されているアカウントには、id 値が指定されています。
9. 前のステップから ID のないソーシャルアカウントを取得し、/connect/social-engagement/setup/managed-social-accounts に対する POST 要求に情報コピーします。これにより、ソーシャルアカウントがソーシャルカスタマーサービスに追加されます。