DomoでInContact Echoデータに接続する

​

はじめに

InContact Echoは、通話直後にフィードバックを収集して顧客満足度を測定するアンケートシステムです。DomoのJSON Advancedコネクターを使って、InContact Echo APIからアンケート結果を取得できます。InContact Echo APIの詳細については、http://echo.incontact.com/echo/help.taf?_UserReference=7F00000146FFB91CDA7A004BDD05589A3AF8&topic=Echo%20APIを参照してください。

​

必要条件

InContact Echoデータに接続するには、InContact担当者からEcho APIキーを取得する必要があります。このAPIキーはリクエストのHTTPヘッダーに使用されます。ヘッダーは以下のようになります。

auth: ABCDEFG8-ABCD-1234-5678-ABCDEF123456

認証に関する詳細は、Echo APIドキュメントの「Authorization」セクションを参照してください。

​

接続するステップ

InContact Echoデータに接続するには：

1. Domoで、JSON Advanced接続を新規に作成します。

   1. **［認証情報］**セクションで：

      1. アカウントプロバイダーのタイトルを「JSON Account」から「Blank」に変更して、このセクションには認証情報が入力されていないことを示します（代わりに、認証情報はコネクターのHTTPSヘッダーセクションに入力されます）。
      2. **［Username］フィールドと［Password］**フィールドは空白のままにします。
      3. **［Connect］**をクリックします。
         アカウントプロバイダー「Blank」が作成されます。
      4. **［Save］**をクリックします。

   2. **［詳細］**セクションで：

      1. **［What is the connection method to access the JSON file?］ドロップダウンで、［HTTP Request］**を選択します。

      2. **［Enter the URL to Your JSON File］フィールドで、リクエストするURLを入力します。
         手順については、APIドキュメントの［Request］**セクションを参照してください。

         リクエストURLの例は以下のようになります：

         https://echo.incontact.com/company/api/echoapi.taf?classname=surveys&method=getSurveyName&outputtype=JSON&p1=101

**注記：**出力をJSONとして取得するには、&outputtype=JSONパラメーターを含める必要があります。

• **［Do you require additional options?］ドロップダウンで、［Yes］**を選択します。

• **［HTTPS Headers］**フィールドに、InContactから受け取ったAPIキーを入力します。
  詳細は、上述の「必要条件」を参照してください。

• **［Save］**をクリックします。

  

​

ベストプラクティス

• InContact Echoに接続する場合のベストプラクティスは、完全な「Replace」で1日1回実行するようにスケジュールすることです。ただし、「Append」で実行して、時系列でスナップショットを提供することも可能です。
• APIには既知の制限がないので、最大15分までコネクターを実行するようにスケジュールすることができます。ただし、特定のアカウントにこの更新頻度を妨げるようなAPI制限があるかどうかは、InContact担当者に確認してください。
• このAPIの主な用途は、アンケートデータの収集です。アンケートのエンドポイントは、https://echo.incontact.com/company/api/echoapi.taf?classname=surveys&method=getSurveyResults&p1=101のようになります。これについては、APIドキュメントの「SURVEYS/getSurveyResults」セクションで説明されています。1回のAPIプルで複数のアンケートを取得することができます。これについては、APIドキュメントの「Request」セクションで説明されています。