HubSpotや連携システムとのワークフロー自動化が動作しない場合の原因調査と修正方法を解説します。
ワークフロー動作確認の基本手順
ワークフローが動作しない場合、まず管理画面の「ワークフロー」→「実行履歴」を確認してください。各ワークフローの実行履歴とステータス(成功・失敗・スキップ)が一覧表示されます。エラーが発生している場合は、エラー詳細をクリックして具体的なエラーメッセージを確認できます。
ワークフローの「テスト実行」機能を使って、実際のデータを使わずにワークフローの動作を確認してください。テスト実行では実際のアクション(メール送信、HubSpot更新など)は実行されませんが、各ステップのトリガー条件が正しく評価されるかを確認できます。
ワークフローのトリガー条件が満たされていないためにスキップされているケースが多く見られます。トリガーとなるイベント(予約完了、キャンセルなど)が発生しているにもかかわらずワークフローが動作しない場合は、条件フィルタを一時的に取り除いてテストしてみてください。
HubSpotワークフロー連携の問題
EventSyncとHubSpotのワークフロー連携が機能しない場合、まずEventSync側の「HubSpot Webhook設定」とHubSpot側の「Webhook連携」設定が正しく構成されているかを確認してください。WebhookのURLが最新のものであることと、認証トークンが有効であることを確認してください。
HubSpotのワークフローがEventSyncのデータをトリガーとして動作する場合、HubSpot側でのデータ受信を確認する必要があります。HubSpotの「ワークフロー」→「分析」で、ワークフローへのエンロール数を確認し、エンロールが発生していない場合はトリガーの設定(コンタクトプロパティの条件など)を見直してください。
HubSpot APIのレート制限(1秒あたり10リクエスト)に達している場合、Webhookの受信処理が遅延しワークフローのタイミングがずれることがあります。高頻度でイベントが発生する場合は、バッファリングまたはバッチ処理を検討してください。
ワークフローのデバッグとメンテナンス
ワークフローに条件分岐が含まれている場合、意図しないブランチに処理が流れている可能性があります。各分岐の条件を詳細にログ出力する「デバッグモード」を有効にすると、どの条件がどう評価されたかをトレースできます。デバッグモードは「ワークフロー設定」→「高度な設定」から有効化してください。
外部サービス(メール送信サービス、Slack、Google Sheetsなど)との連携ステップでエラーが発生している場合は、各サービスのAPIキーや認証情報が有効であることを確認してください。外部サービスの仕様変更により、既存のワークフローが動作しなくなることがあります。
ワークフローを長期間運用していると、削除されたフィールドや変更されたプロパティを参照して失敗するケースがあります。定期的にワークフローの設定を見直し、参照しているフィールドやプロパティが現在も有効かを確認することをお勧めします。四半期に1回程度のメンテナンスレビューを推奨します。