第3章 Twitter to Salesforce サンプルインテグレーションの実装

このサンプルインテグレーションは、特定の Twitter ユーザーをメンションするツイートを Twitter で監視します。インテグレーションはそのようなツイートを見つけると、指定のテキストが含まれるツイートのみによってインテグレーションが続行されるよう、ツイートをフィルタリングします。

指定されたテキストが含まれるツイートでは、インテグレーションは Twitter ユーザー名などのそのツイートに関連するデータを Salesforce に渡し、Salesforce は新しい取引先責任者を作成します。

前提条件

  • Twitter 開発者アカウントが必要です。まだ Twitter 開発者アカウントを持っていない場合は、https://apps.twitter.com にアクセスし、Twitter にサインインしてから Apply for a developer account をクリックします。you@gmail.com のような個人アドレスではなく、me@redhat.com のような企業のアドレスを提供すると、迅速に開発者アカウントを取得できます。
  • 開発に使用される Salesforce インストールでアカウントが必要になります。このアカウントは Salesforce API にアクセスできる必要があります。Salesforce Enterprise アカウントまたは Salesforce Developer アカウントは Salesforce API にアクセスできます。無料の開発者アカウントを取得するには、https://developer.salesforce.com/signup にアクさきほどセスしてください。Salesforce アカウントの取得には最大 2 分かかります。
  • Fuse Online 環境にログインしている必要があります。まだログインしていない場合は、Fuse Online を初めて使用するときに想定される手順 を参照してください。

このサンプルインテグレーションを実装、デプロイ、およびテストするための主なステップは次のとおりです。

3.1. Fuse Online を Twitter クライアントアプリケーションとして登録

インテグレーションで Twitter に接続するには、最初に Fuse Online 環境を Twitter にアクセスできるクライアントアプリケーションとして登録する必要があります。これにより、Twitter に接続するインテグレーションをいくつでも作成することができます。そのため、特定の Fuse Online 環境を 1 度だけ Twitter に登録する必要があります。

Fuse Online を Twitter クライアントアプリケーションとして登録できるのは、Fuse Online 環境ごとに 1 回のみです。しかし、各 Twitter コネクションは同じ登録を使用しますが、異なるユーザークレデンシャルを使用することができます。

前提条件

Fuse Online にログインしている必要があります。Fuse Online にアクセスできる URL は、Red Hat Fuse Online Evaluation プログラムのウェルカムメールメッセージにあります。

手順

  1. Fuse Online で以下を行います。

    1. 左側のパネルで Settings をクリックします。
    2. Settings ページで、上部付近にあるコールバック URL の右側で Copy Callback URL をクリックし、Fuse Online インストールのコールバック URL をクリップボードにコピーします。この手順の後半でこの URL が必要になります。
    3. Twitter エントリーをクリックし、Consumer API Key および Consumer API Secret Key フィールドを表示します。
  2. 別のブラウザータブで、Twitter 開発者アカウント にアクセスし、必要な場合はログインしてから以下を行います。

    1. 右上で、開発者プロジェクトの名前の横にある下向きのキャレットをクリックし、Apps をクリックします。
    2. 右上の Create an app をクリックします。
    3. App name フィールドに My Fuse Online Client などの名前を入力します。
    4. Application description フィールドに、For leveraging tweets などのヒントを入力します。
    5. Website URL フィールドに、この手順の最初でコピーした URL を貼り付け、URL の最後にある api/v1/credentials/callback を削除します。
    6. Enable Sign in with Twitter を選択します。
    7. Callback URLs フィールドに URL を再度貼り付けます。https://app-proj912876.7b63.fuse-ignite.openshiftapps.com/api/v1/credentials/callback のようになるはずです。

      続くフィールドをいくつかスキップします。

    8. Tell us how this app will be used には説明を 100 文字以内で追加する必要があります。This is a demo application so that I can evaluate how to integrate Twitter with my enterprise applications. をコピーおよび貼り付けて対応することができます。
    9. Create をクリックします。
    10. 再度 Create をクリックし、開発者規約を読んだことを確認します。
    11. 作成したアプリのページ上部にある Keys and tokens タブをクリックします。
    12. コンシューマー API キーをコピーします。
  3. Fuse Online の Settings ページに戻り、Twitter のコンシューマー API キーを Fuse Online の Twitter Consumer API Key フィールドに貼り付けます。
  4. Twitter の Keys and tokens タブに戻り、コンシューマー API シークレットキーをコピーします。
  5. Fuse Online の Settings ページに戻り、Twitter のコンシューマー API シークレットキーを Fuse Online の Twitter Consumer API Secret Key フィールドに貼り付けます。
  6. Save をクリックします。
  7. Twitter エントリーをクリックして折りたたみます。