Chatwork通知の実行エラー(届かない・ルームアクセス・入力・月間上限)
ワークフローの通知と実行履歴を確認するとき
通知が届かないときは、まずワークフローの実行履歴でアクション「Chatworkに通知」のエラーの内容を見ます。内容ごとの直し方は下のとおりです。
通知が Chatwork に届かない
原因
実行履歴にエラーが出ていれば、その内容が原因です。エラーが出ておらず、アクションの実行も残っていないときは、通知ではなくワークフローの条件や有効化の問題です。
直し方
- 接続を確かめる
設定画面の「接続」タブで Chatwork が「接続済み」か確かめます。「要再接続」「未接続」なら 接続し直します。
- ワークフローを確かめる
ワークフローが有効で、対象のレコードが登録の条件を満たしているか、履歴で「Chatworkに通知」が実行されているかを見ます。実行されていれば、エラーコードと内容が出ています。
- エラーの内容から探す
下の表で対処を探します。ルームIDの確認は、Chatwork でルームを開いたときの URL の「rid」に続く数字です。
| エラーの内容 | 直し方 |
|---|---|
| 指定されたChatworkルームにアクセスできません | ルームにアクセスできない |
| 月間通知上限(10件)に達しました。Professionalプランにアップグレードしてください | 月間上限に達した |
| Chatworkが接続されていません。設定画面から接続してください/接続のタブで Chatwork に接続してください | 接続が必要 |
| inputFields.room_idが必須です/inputFields.message_bodyが必須です/サポートされていないobjectTypeです | 入力エラー |
| Chatwork APIのレート制限に達しました/一時的な問題で処理できませんでした | 回数の上限・一時的な問題 |
届いているのに本文に {{…}} が残る、レコードへのリンクがない、という場合は 通知の内容がおかしい をご覧ください。
「指定されたChatworkルームにアクセスできません」と表示される
原因
Chatwork がそのルームへのアクセスを拒否しています。ワークフローでは BUSINESS_RULE の分岐に入り、チャットでは読み込み・送信・メンバー再同期のときに赤い文字で出ます。ルームIDの入力ミス(桁の欠け、別のルームのID)、接続中のアカウントがルームに参加していない、ルームの削除やアカウントの除外、差し込んだプロパティの値が古い・誤っている、のいずれかです。
直し方
- Chatwork でルームを開き、URL の「rid」に続く数字を確かめます。
- 設定画面の Chatwork の欄の「アカウント」を見て、そのアカウントがルームのメンバーか確かめます。参加していなければルームに追加します(接続する Chatwork アカウントの選び方)。
- ルームIDを差し込んでいる場合は、対象レコードの「Chatwork Room ID」の値を確かめます。
- ワークフローを再実行するか、チャットの「更新」を押します。
切り分けには、同じルームをカードの「ルームIDを直接入力」で紐付けてみます。ルームが取得できて参加しているときだけ成功するので、IDと参加状況をまとめて確かめられます(紐付けのトラブル)。
「inputFields.room_idが必須です」などの入力エラーが出る
原因
入力に誤りがあるときは、エラーコード INVALID_INPUT で、ワークフローが止まらずに次のアクションへ進みます。分岐の文言は「入力に誤りがあるため処理できませんでした:(エラーの内容)」です。
直し方
| エラーの内容 | 原因と直し方 |
|---|---|
| inputFields.room_idが必須です | 「送信先ルームID」の入力欄が空。値または差し込みを入力する |
| inputFields.message_bodyが必須です | メッセージ本文が空。本文を入力する |
| サポートされていないobjectTypeです | 対象が取引・会社・コンタクト・チケット以外。対応するオブジェクトのワークフローで使う(対応するオブジェクトと機能の対応表) |
| リクエストボディのパースに失敗しました | HubSpot から届いた内容を読み取れなかった。時間をおいて再実行する |
| origin.portalIdが不正です | ポータルを特定できなかった。同上 |
レコードごとにルームを振り分けるワークフローでは、プロパティが空でも差し込みを入力していれば「inputFields.room_idが必須です」の入力チェックは通過します。登録条件に「Chatwork Room ID」が入力されていることを加えて、空のレコードを外してください(レコードごとに別のルームへ通知を振り分ける)。差し込みの方法は プロパティの差し込みとルームIDの指定 をご覧ください。
「月間通知上限(10件)に達しました」と表示される
原因
実行履歴に「月間通知上限(10件)に達しました。Professionalプランにアップグレードしてください」と出るときは、Free プランの月10件を使い切っています(エラーコードは BUSINESS_RULE)。動作確認の送信、HubSpot による自動の再実行、送信に失敗した分も件数に含まれます。「プラン・お支払い」タブの「今月の使用量」で、「Chatwork への通知」の件数を確かめられます(今月の使用量の欄)。
直し方
- Professional 以上に アップグレード する。上限がなくなります。
- 月が変わるのを待つ。月の区切りは世界標準時で、日本時間では毎月1日の午前9時です。
上限に達した月の通知は送られず、あとから再送する機能もありません。必要な通知は、アップグレードのあとにワークフローを再度実行してください。チャット画面からの送信は、この件数に数えられません。