トラブルシューティング

統合が切断されました

アプリが未接続と表示されたり、再接続を求められたり、ステップがアカウントに到達できない場合の対処方法。

統合とは、ワークスペースと外部アカウント(Slack、Google、HubSpot など)の間の接続です。統合が存在しない、期限切れ、または権限が不足している場合、それを利用するエージェントやステップは動作を停止します。

症状#

  • ステップまたはエージェントが「NAME が設定されていません。先に統合を設定してください。」というエラーで失敗する。
  • 「NAME は接続されていますが、必要な権限が不足しています。統合を再接続し、追加の権限を付与してください。」というエラーが表示される。
  • 「NAME には再認証が必要です。リフレッシュトークンが期限切れまたは失効しています。統合を再接続してください。」というエラーが表示される。
  • エディターで「NAME 統合が必要ですが、見つかりませんでした」、「一部のコンポーネントには次の統合が必要です:」、「コンポーネントが統合されていません」という警告が表示される。
  • エージェントの アプリ 一覧で、アプリが 接続済み ではなく 接続 と表示される。
  • 統合 ページで、以前は 統合済み と表示されていたカードに 統合 と表示される。

考えられる原因(順に)#

  1. このワークスペースで接続されたことがない。 統合はワークスペースに属します。別のワークスペースでの接続は引き継がれません。
  2. ログインが期限切れまたは失効した。 保存されたログインが期限切れまたは失効したため、プロバイダーはそれを受け入れなくなりました。これにより「再認証が必要」というエラーが発生します。
  3. 権限が不足している。 アカウントは接続されていますが、接続時にすべての権限を承認していません。これにより「権限が不足しています」というエラーが発生します。たとえば、YouTube へのアップロードには、YouTube の権限を付与して Google アカウントを再接続する必要があります。
  4. Microsoft では管理者の同意が必要。 Microsoft 組織を接続した場合、統合に「Microsoft 組織を FlowHunt に統合したようです。統合を正しく機能させるには、管理者の同意を付与してください」というメッセージと 管理者の同意を付与 ボタンが表示されます。
  5. 統合の上限に達した。 新規作成時に「統合の許容上限に達しました。プランをアップグレードしてください。」というエラーで失敗します。スターターでは 1 つ、プロでは 5 つまで許可されています。プランと制限 を参照してください。
  6. 自分のロールでは表示できない。 メンバーとゲストは 統合 ページにアクセスできず、メンテナーは閲覧のみ可能です。

修正方法#

  1. サイドバーの 統合 をクリックし、アプリを開きます。ステータスバッジには 接続済み または 未接続 と表示され、リンクされていた場合は 最終接続日: が表示されます。
  2. NAME を接続 をクリックします。Google と Bing の場合、すでに接続があるときはボタンが NAME を再接続 と表示されます。正しいアカウントでサインインし、要求されるすべての権限を承認してください。
  3. 接続が混乱している場合は、NAME を切断 をクリックして確認し、もう一度接続します。接続された Google アカウントはすべての Google 製品をカバーするため、切断すると同じメールアドレスで接続されているすべてのワークスペースで、それらすべてが削除されます。その後、必要な各製品を再接続します。
  4. エージェントまたはワークフローに戻り、もう一度実行します。エージェントの アプリ 一覧では、アプリのメニューに 接続を設定 があります。

オーナー、管理者、編集者は接続と切断ができます。アカウントの接続 と 統合の使用 を参照してください。

切断するとすべてのエージェントのアクセスが失われます

統合を削除すると、アカウントがワークスペース全体から切断されます。それを利用するすべてのエージェントとワークフローは、再接続するまで失敗します。