HubSpot の再接続

HubSpot の認証情報の期限切れは、HubSpot トリガーのワークフローが停止する最も一般的な原因です。その特徴として、何もエラーを報告しません。HubSpot ワークフローは実行済みと表示されているにもかかわらず、Portant のステップが完了しないままになります。

症状

以下のいずれかが確認される場合は、HubSpot を再接続してください。

Run a Portant Workflow アクションが waiting (待機中) のまま止まっており、遅延ステップが設定されていない。
Portant のオートメーションを解除するために手動でのアンエンロールが必要になっている。
新しく作成したワークフローが、HubSpot の Portant カードまたはアクションリストに表示されない。
メールが、ワークフローオーナーのアドレスではなく、元チームメンバーのアドレスから送信されている。
署名リクエストで、2 番目の受信者がスキップされている。
ドキュメントが HubSpot レコードに添付されなくなっている。

これらのいずれも、認証情報の期限切れに起因することが確認されています。場合によっては、数週間にわたって別の原因を調査した末に判明することもあります。

再接続

Portant Settings → Integrations に移動します。
Teams Permissions (チーム権限) の下にある HubSpot を見つけ、Manage (管理) をクリックします。
再接続し、HubSpot の権限プロンプトを承認します。

再接続すると、HubSpot が参照するワークフローリストも更新されます。そのため、Portant には存在しているがレコードに表示されないワークフローに対しても、この操作が解決策となります。

HubSpot は Individual Permissions (個人権限) ではなく Teams Permissions (チーム権限) の下に表示されます。これは、この接続がチームおよび承認を行ったユーザーに帰属するためです。この欄には接続したユーザーの名前も表示されるため、まずそちらを確認することをお勧めします。そのユーザーがすでに退職している場合、別のユーザーとして再接続するだけでは不十分です。チームオーナーが再接続を行う必要があり、さらにチームオーナーシップの移転が必要になる場合もあります。

よくある原因

接続を設定した管理者が退職した場合

ワークフローは退職したユーザーの認証情報を使って動作し続け、その認証情報が期限切れになるまで停止しません。そのため、退職後数週間が経ってから問題が発覚することが多いです。オーナーシップを現在のユーザーに移転し、そのユーザーとして HubSpot を再接続してください。

会社が合併した、または HubSpot ポータルが変更された場合

Portant アカウントのオーナーと HubSpot ユーザーが異なるユーザーになった場合、またはポータル ID が変更された場合、インテグレーションは権限バグのような形で機能しなくなります。まず再接続を試みてください。それでもワークフローが誤ったポータルを参照している場合は、サポートに連絡してください。ソースリンクの修正は弊社側で対応します。

サンドボックスから本番ポータルに移行した場合

HubSpot サンドボックスに接続した状態で構築されたワークフローは、そのポータルに紐付いており、本番環境には引き継がれません。再接続しても、それらのワークフローは表示されません。本番ポータルでワークフローを再構築するか、移行前にサポートに連絡してアドバイスを受けてください。

正常に動作していることの確認

再接続後は、次のトリガーを待つのではなく、HubSpot レコードから 1 つのオートメーションを手動で再実行してください。処理が完了すれば、認証情報が原因であったことが確認できます。

それでも処理がハングアップする場合は、サポートコードをコピーしてサポートチケットを開いてください。