ワークフローのよくあるエラーのトラブルシューティング
更新日時 2023年 10月 10日
ワークフローダッシュボードから、登録したレコードにエラーが発生したワークフローを一覧で確認できます。そこから、ワークフローに移動してエラーを修正することができます。
レコードが登録されない理由を知りたい場合は、代わりにワークフロー登録のトラブルシューティングの詳細をご覧ください。
エラーのあるワークフローの特定
エラーが発生したワークフローを表示する。
- HubSpotアカウントにて、[自動化]>[ワークフロー]の順に進みます。
- ワークフローのいずれかにエラーがある場合、Needs reviewタブに赤いインジケータが表示されます。ワークフローを表示するには、「Needs review」タブをクリックします。
- 課題のあるワークフローの一覧を表示します。特定のワークフローの課題を表示するには、ワークフロー名の上にカーソルを置き、「課題のレビュー」をクリックします。
- ワークフローの詳細ページでは、アクションログやワークフローの登録履歴など、過去90日以内に発生したイベントを確認することができます。ワークフローの詳細画面からワークフローの履歴を確認する方法については、こちらをご覧ください。
- 課題の説明にカーソルを合わせ、「この課題をレビューする」をクリックすると、課題に関する詳細が表示されます。
- 右側のIssue詳細パネルで、確認することができます:
- 課題:課題の説明を表示します。
- 問題への対処方法問題が解決されたかどうか、問題について思い出されたいかどうか、問題を無視したいかを選択します。
- エラーログ:エラーが発生した都度、表示されます。フィルターを使って、対象物や日付で絞り込むことができます。
- 以下のよくあるワークフローエラーを確認してください。エラーは、ワークフローの設定に起因するものと、登録されたレコードに起因するものとがあります。
- ワークフローに関連付けされたエラーを修正するには、右上の「Edit actions」をクリックして、ワークフローエディターにアクセスします。
- レコードに関連付けされたエラーを修正するには、レコードの名前をクリックして、オブジェクトレコードにアクセスします。
- 再び起こるまですべてのリスクを無視するには、「繰り返すまですべて無視する」をクリックします。ワークフローでこれを選択した場合、そのワークフローは危険度タブ から削除されます。リスクが繰り返されたり、新たなリスクが発生した場合は、すぐにこのリストに表示され、ワークフローが再びリスクにさらされることになります。
ワークフローエディターでのワークフローアラートとエラーの把握
ワークフローエディターから、変更が必要なアクションやエラーが発生したアクションを確認することができます。
- HubSpotアカウントにて、[自動化]>[ワークフロー]の順に進みます。
- エラーのあるワークフロー]タブをクリックします。
- ワークフローにカーソルを合わせ、[ 編集 ]をクリックします。
- ワークフローエディターの左上で、[アラート]をクリックします。エラーや変更が必要なワークフローアクションのリストが表示されます。
- アラートの詳細を表示するには、アクションに関連付けされた要変更またはエラーをクリックします。
- 右側のパネルで、選択したアクションに必要な変更や最近のエラーを表示します:
- 必要な変更:アクションが正しく実行されるために必要な変更を確認します。例えば、Eメール送信アクションで自動送信メールを発行する。
- 履歴の最近のエラー:先週からの最近のエラーを、エラーの種類ごとにグループ化して確認することができます。
- このワークフローのすべてのエラーを表示するには、「履歴のすべてのエラーを表示する」をクリックします。アクションログが表示され、すべてのエラーが表示されます。
- 特定のエラーの発生回数を表示するには、「過去1週間にx回発生」をクリックします。アクションログは、この特定のエラーのインスタンスに絞り込みされて表示されます。
既存のエラーを解除することはできませんので、アクションのすべてのエラーを解決する必要があります。今後7日間、アクションに新たなエラーが発生しない場合、アクションのパネルからクリアされ、アラートからも削除されます。
よくあるワークフローエラー
以下は、よくあるワークフローエラーの例です。いくつかのエラーは解決するための手順が必要ですが、その他のアクションは自動的に再試行されます。Action logsタブでは、Success、Information、Error のログイベントが表示されます。
エラーログ
ワークフローまたはレコードを更新した後、手動でコンタクトをワークフローに再度登録することを試みることができます。
エラー | エラーの意味 | エラーを解決する手順 |
コンタクト/会社/取引がターゲットレコードに関連付けされていないため、プロパティーを設定できませんでした。 | Set property valueまたは「プロパティー値をコピー」アクションを実行しようとしていますが、更新する関連付けされたレコードがありません。 たとえば、コンタクトベースのワークフローを使用していて、プロパティー値のコピーアクションでコンタクトの関連付けされた会社に業種プロパティーをコピーする場合、コンタクトに関連付けされた会社がない場合です。 |
個々のレコードについては、再登録する前に、登録したレコードを対象レコードに手動で関連付けすることができます。 このエラーを回避するために、関連付けされたターゲットレコードを持つレコードのみが登録されるように、登録トリガーにアンドクライテリアを追加することができます。例えば、コンタクトベースのワークフローでは、会社IDが既知であるという条件を使用することができます。 ![]() |
コンタクトが会社IDに関連付けされていない | 上記と同様に、コンタクトベースのワークフローで[会社のプロパティー値をコピー]アクションを使用しているにもかかわらず、コンタクトに関連付けされた会社がない場合に、このエラーが発生します。 | |
ライフサイクルステージの更新ができなかったのは、後ろ向きに設定されてしまうからです | Set propertyvalueアクションは、レコードのデフォルトのLifecycle Stageプロパティを、ファネルのさらに下の値にのみ設定できます。 このエラーは、ワークフローがリードから登録読者など、レコードのLifecycle Stageプロパティを逆方向に設定しようとした場合に発生します。 ライフサイクルステージの活用についてはこちら。 |
レコードのライフサイクルステージを、現在のライフサイクルステージに関係なく特定の値に設定するには、プロパティーの値をクリアするアクションを最初に使用します。![]() |
このコンタクトはマーケティング対象外コンタクトであるため、Eメールは送信されませんでした。 | ワークフローの[Eメール送信]アクションは、マーケティングコンタクトに対してのみ実行できます。 マーケティングコンタクトについて詳しくはこちら。 |
このワークフローで既存のマーケティングコンタクトのみを登録し、Eメールを送信するには、登録トリガーにアンド条件を追加し、マーケティングコンタクトのステータスプロパティがマーケティングコンタクトのみであるコンタクトを登録することができます。 ワークフローに登録されているすべてのコンタクトにこのEメールを送信するには、「マーケティングコンタクトのステータスを設定」アクションを追加し、Send emailアクションの前に遅延させることができます。この操作を行うと、マーケティングコンタクトの数が増え、課金に影響する可能性がありますのでご注意ください。 |
以前にこの配信カテゴリーから配信解除済み | このエラーは2つの理由で発生することがあります。
|
この場合、エラーの原因によって解決方法が異なります。
|
この受信者へのEメールが過去にバウンス(不達)になったことがある | このコンタクトのEメールアドレスに送った過去のメールはハードバウンスされています。 E メールのバウンスの種類についてはこちらをご覧ください。 |
コンタクトのEメールアドレスが有効であることを確認します。その場合、手動でハードバウンスを記録から削除し、Eメールの送信を再試行してください。 自動送信されたEメールを再送信することはできませんが、再送信することは可能です。
|
このEメールはHubSpotで審査中のため送信されませんでした。 | HubSpot の自動セキュリティーツールは、このメールにフラグを立て、確認するよう指示しました。 | EメールはHubSpotのコンテンツモデレーションチームによって確認されます。
|
このEメールはHubSpotによってブロックされているため、送信されませんでした。 | 検討の結果、このEメールはHubSpotの利用規定に記載されているポリシーに違反していると判断されたか、HubSpotの自動システムによってEメールがブロックされました。 |
このEメールは、HubSpotのコンテンツ・モデレーション・チームによって審査されます。
|
受信者はエンゲージメントが少ないため、抑制されました | グレーメール抑制がどちらかで有効になっている。
HubSpot のグレーメールとエンゲージドコンタクトの詳細についてはこちらをご覧ください。 |
まず、ワークフローの自動送信メールの送信タブで、「エンゲージドコンタクトに送信しない」チェックボックスがオフになっていることを確認します。 ![]() その後、アカウントのマーケティングメール配信登録設定で、「エンゲージされていないコンタクトには送信しない」スイッチがオフになっていることを確認します。 ![]() |
過去に実行されたため、アクションはスキップされました | ワークフローがCenter on a dateまたはCenter on a dateプロパティーのコンタクトベースのワークフローであり、アクションの設定日が経過した後にコンタクトが登録された場合。 例えば、11月11日にEメールを送信するようにワークフローを設定したが、11月12日の実行日以降にコンタクトが登録された場合。 |
特定の日付にトリガーされるアクションを持つワークフローでは、このエラーを無視することができます。登録されたコンタクトは、次の利用可能なアクションにスキップされます。 顧客の誕生日や記念日にEメールを送信するなど、定期的な目的を持つワークフローでは、毎年繰り返されるように設定することが可能です。これにより、お客様はワークフローに登録し、登録した時期にかかわらず、すべてのワークフローのアクションを実行することができるようになります。 ![]() |
アウトサイドタイムウィンドウの設定。アクションは[新しい日付と時刻]に再スケジュールされました。 | ワークフローの「何時にアクションを実行するか」の設定が特定の時間枠に設定されているが、登録されたレコードがこの時間枠の外にある間にアクションに到達している。 | ワークフローエディターで、ワークフローのアクションをいつでも実行できるようにする。
![]() また、特定の時間帯にのみアクションを実行する場合は、エラーを無視して、次の対象日時にアクションを実行させることもできます。 |
Eメール通知を送信できません | 内部通知Eメールを指定したユーザーに送信できませんでした。 | Eメールによる内部通知を受けるため:
|
情報ログ
ワークフローのアクションログでよく見かけるワークフロー情報のログを以下に示します。後日、自動的に再試行されます。
情報 | 情報の意味するもの |
他のアップデートが同時に試みられたため、Rotateが失敗しました。アクションはすぐにリトライします。 | HubSpotでは、配布の公平性を保つため、一度に1つのオブジェクトしか回転させることができません。複数のオブジェクトが同時にrotate objectアクションを実行している場合、1つだけ、他のオブジェクトがリトライする間、通過が許可されます。これは、同じワークフロー内の複数のオブジェクトが、同時に回転していたためです。 |
カスタムコードは実行できませんでしたが、近日中に再試行します。 | 作成されたアクションは、実行することができませんでした。詳しくは、サポートチームまでお問い合わせください。 |
HubSpotが接続されたアプリによってレート制限を受けているため、アクションは失敗しましたが、すぐに再試行します。 | HubSpotと接続アプリ間のデータ転送中に制限に達しました。アクションは再試行します。 |
Webhookは実行できませんでしたが、すぐに再試行します。 | HubSpotでは、Webhookが実行され、応答が返送されるまでに一定の期間を設けています。サーバーの応答が遅すぎる場合、HubSpotはfailedとして記録し、アクションを再試行します。 応答するサーバーが遅い場合、Webhookに関連付けされたアクションは実行されるかもしれませんが、時間内に返信がなかったため、HubSpotはfailedとして記録し、後の時点で再試行します。 |
Webhookはサーバーエラーのため失敗しましたが、すぐに再試行します。 | HubSpotが外部Webhookサーバーからfailed responseを受信しました。 |
このアクションは実行できませんでしたが、すぐに再試行します。 | 作成されたアクションは、実行することができませんでした。詳しくは、サポートチームまでお問い合わせください。 |
接続されたアプリが応答するのに時間がかかりすぎたため、アクションは失敗しましたが、すぐに再試行します。 | 接続されているアプリから要求されたアクションにタイムアウトが発生しました。アクションは再試行します。 |