Troubleshoot the Zendesk data dip connector


コネクターは、プログラムの実行で起きたすべてのイベントを記録する標準ログ ファイルを含みます。これらのファイルでは追跡と診断が可能です。

コネクターのログ ファイルには 2 つのタイプがあります。

  • ininbridgehost_{X}: これらのログ ファイルは、Bridge サーバーがコネクターを読み込んだときに作成されます。
  • {connector group name}_{X}.ininlog: これらのログ ファイルは、コネクターと設定の読み込みからの両方の追跡、およびコネクターによってログされた追跡を含みます。これらのログ ファイルは毎日作成され、また、コネクターが再起動するたびに作成されます。

これらのログ ファイルのコピーについては、次の手順に従います:

  1. [コネクターの詳細] ページに進みます。
    • At the top of the Admin page, click Admin > Integrations.
    • Bridge ページで、[コネクター] タブをクリックします。
    • 閲覧したいログ ファイルのコネクターをクリックします。
  2. [インスタンス] セクションで、[ログ] をクリックします。
  3. クリックします。 コネクタのログを要求します。.
  4. ダウンロードするファイルをクリックします。

ダウンロードした zip ファイルに両方のタイプのコネクター ログ ファイルが含まれています。

The Bridge Server includes its own logging system for logging information about the internals of the server. These log files contain low-level process details that can describe any problems with starting the server as a whole or with receiving messages. For example, if the Windows processes of the server do not start or there are no relevant traces in the connector log files, check the Bridge Server log files.

サーバーのログ ファイルの 4 つのタイプがあります。

  • ininbridgeprocesslauncher.ininlog: these log files record information about Bridge Server processes, suchas crashes and restarts.
  • ininbridgeserver_{X}.ininlog: これらのログ ファイルは、コネクターおよびそのプロセスの管理についての情報を含みます。
  • ininbridgeservices_{X}.ininlog: これらのログ ファイルは、Bridge サーバーと Amazon Web サービス間の通信についての情報を含みます。
  • ininupdate_ {×} .ininlog: これらのログ ファイルをブリッジ サーバーをシャット ダウンする、新しい更新プログラム パッケージをインストールして、再起動に関する情報を記録します。

これらのログ ファイルのコピーについては、次の手順に従います:

  1. [サーバーの詳細] ページに進みます。
    1. At the top of the Admin page, click Admin > Integrations.
    2. On the Bridge page, click the Servers tab.
    3. Click the server whose log files you want to view.
  2. [ログ] をクリックします。
  3. [サーバーのログをリクエスト] をクリックします。
  4. ダウンロードするファイルをクリックします。

問題

Architectブリッジ アクション下ブリッジ アクションが表示されません。

原因

PureCloud のセットアップでエラーが原因は、Architectのブリッジ アクションは表示されません。

  • 選択していない場合 メタデータを平らにします。 ときに PureCloud のブリッジ アクションを作成します。

    一覧に表示する特定ブリッジ アクション名の代わりに「による互換性のないデータ。 除外アクション {1}」のメッセージが表示されます。 

    Architect での Bridge アクション エラーメッセージのスクリーンショット

  • PureCloud のブリッジ操作を公開していません。

ソリューション

PureCloud でブリッジ アクションを開きます。

  • [メタデータのフラット化]が選択されていることを確認します。
  • ブリッジ アクションが公開されていることを確認します。

問題

A bridge action takes the failure path in the call flow in Architect. 

原因

ブリッジ アクションは、いくつかの理由のため失敗パスを取ることができます。

  • Credential and account issues
    • コネクタ構成の変更は、アカウントの Zendesk ユーザー権限。
    • Zendesk 資格情報は変更がコネクタの構成に反映されていません。
  • Search result issues
    • コネクター アクションで検索結果が見つからないか、複数見つかります。

      各コネクター アクションで、コネクターは CRM から 1 つの検索結果を取得します。検索結果がないか複数の検索結果がある場合、コネクター アクションは Architect の Bridge の呼び出しアクションからの失敗経路を取り、CRM から情報を返しません。

  • Connection issues
    • コネクタは Zendesk サーバーに接続することができます。 

      この問題は、コネクタの構成で無効なまたは不足しているサーバーの資格情報のため通常です。 ただし、この問題はネットワーク トラフィックをブロックしてセキュリティ設定によりまたは Zendesk サーバーの停止にできます。

ソリューション

  • Credential and account issues
    • Zendesk ユーザーのアクセス許可を確認します。
    • 確認するための要件、 Zendesk ユーザー 満たされています。
    • Change your Zendesk credentials in the connector configuration. 
  • Search result issues
    • コネクタで検索同じデータのための CRM を検索します。
      • あなたの CRM に結果が返されない場合、エラー パスはあなたの呼び出しのフローに続いた正しく。
      • 御社の CRM が複数の結果を返す場合、エラー パスはコール フローに続いた正しく。
      • あなたの CRM は、1 つだけの結果を返しますエラー パスが続いた場合は、障害パスが続いた理由を決定するコネクタ ログ ファイルをチェックし、結果が返されませんでした。 ログは結果または複数の結果が返される場合をトレースしません。 
  • Connection issues
    • Change your Zendesk credentials in the connector configuration.
    • コネクタへの接続を確認します。

      Check the Interactive Intelligence log files for the following. 

      ZendeskPlugin.ConfigureApi: ZenDesk ユーザーに接続しよう: '[Zendesk 管理者のユーザー メール アドレス]' の url: https://inintest.zendesk.com/api/v2 ININZendeskApi.Configure: ユーザーの ZendeskAPI の構成: '[Zendesk 管理者のユーザー メール アドレス]' の url: https://inintest.zendesk.com/api/v2 CrmPluginFactory.CreatePlugin: 作成された新しい ZenDesk プラグイン
      • これらのメッセージが存在すれば、接続に成功したことを意味します。
      • これらのメッセージがあれば、接続に成功しなかったことを意味します。

        セキュリティ設定をチェックし、 ファイアウォールのアクセス許可 あなたのネットワーク接続します。

    • Zendesk ユーザー アカウントの設定を確認します。
      • Zendesk ユーザーのアクセス許可を確認します。
      • 確認するための要件、 Zendesk ユーザー 満たされています。

問題

プロキシ サーバーを使用すると、いくつかの分後ブリッジ サーバーが切断されます。

原因

ブリッジ サーバーは、PureCloud との双方向通信用長寿命安全な WebSocket 接続を使用します。

ソリューション

長寿命、非アイドル状態の接続を許可する web プロキシを構成します。

問題

コネクターの起動に失敗しました。

原因

コネクターの起動に失敗した理由としては、次のようなものが考えられます:

  • Zendesk ユーザーのアクセス許可が正しくありません。
  • コネクタ構成の [Zendesk 資格情報が正しくありません。
  • プロキシ サーバーの設定が正しくありません。
  • 他の予期されないエラーが発生した。

ソリューション

  • 確認するための要件、 Zendesk ユーザー 満たされています。
  • Change your Zendesk credentials in the connector configuration. 
  • 設定し、構成されていることを確認、 プロキシ サーバー 正しく。
  • コネクタ ログ ファイルでエラーに関する情報を確認します。 

問題

The information that the bridge actions retrieve from Zendesk is incomplete or incorrect.

原因

Zendesk の API 呼び出しが失敗しました。 

ソリューション

  • API 呼び出しに失敗しました Zendesk をことを確認するコネクタのログ ファイルを確認します。 
  • Wait for the connector to attempt to retrieve information from Zendesk again.

    Note: Entries added or updated in Zendesk may not be available for use by the connector for up to 10 minutes.

  • Zendesk をする API 呼び出しの数を減らします。 
  • Change your Zendesk credentials in the connector configuration.

問題

コネクタは Zendesk サーバーに接続することができます。

原因

この問題は、コネクタの構成で無効なまたは不足しているサーバーの資格情報のため通常です。 ただし、この問題はネットワーク トラフィックをブロックしてセキュリティ設定によりまたは Zendesk サーバーの停止にできます。

ソリューション

  • 接続設定を確認します。

    • Zendesk の Zendesk ユーザー名ログイン ID

      このユーザー Zendesk の管理者である必要があります。

    • Zendesk Security Token: API token generated for the Zendesk organization

  • 問題の原因が設定の誤りでない場合、Salesforce サーバーへの接続に成功したことを確認します。

    次のインタラクティブ ・ インテリジェンスのログ ファイルを確認します。 

    ZendeskPlugin.ConfigureApi: ZenDesk ユーザーに接続しようとすると。 ' [Zendesk 管理者のユーザー電子メール アドレス]' の url: https://inintest.zendesk.com/api/v2
    ININZendeskApi.Configure: ユーザーの ZendeskAPI を構成します。 '[Zendesk 管理者のユーザー電子メール アドレス]' の url: https://inintest.zendesk.com/api/v2
    CrmPluginFactory.CreatePlugin: 作成された新しい ZenDesk プラグイン
    • これらのメッセージが存在すれば、接続に成功したことを意味します。
    • これらのメッセージがあれば、接続に成功しなかったことを意味します。

      ネットワーク接続のセキュリティ設定とファイアウォールの権限をチェックします。

  • Zendesk のユーザー アカウントの設定を確認します。

    Zendesk ユーザーに API へのアクセスがあるない場合、コネクタは、Zendesk に接続できません。 

    ININZendeskApi.Configure:
    トップ例外 Type=ININ.Alliances.Common.BadCredentialsException Source=inin.zendesk.api-w64r-15-3 メッセージ = ユーザー: [Zendesk 管理者のユーザー電子メール アドレス] は、ログインから禁じられていた。 資格情報を確認して、ユーザー アクセス スタック トレースを確認: ININ で。(ServerUrl 文字列、文字列名、文字列トークン) の Zendesk.Api.ININZendeskApi.Configure c:\workspace\jenkins_workspace\workspace\alliances-zendesk-common\src\api\ININZendeskApi.cs:line 55

    確認するための要件、 Zendesk ユーザー 満たされています。