配信のトラブルシューティング

Ringhumは、連携アプリに何かを送信するたびに結果を記録します。通話がSlackに表示されなかったり、ヘルプデスクにチケットが作成されなかったりした場合、最近の配信一覧を見れば、送信された、スキップされた、拒否された、のいずれかとその理由がわかります。多くの問題は、期限切れのキー、削除されたチャンネルやリスト、設定の不足が原因です。

最近の配信状況を開く

1. 連携を開き、接続済みをクリックします。
2. アプリのカードで、最終配信から始まる行(例:「最終配信 5分前・ok」)をクリックします。

最近の配信状況ウィンドウには、そのアプリへの直近25件の試行が新しい順に表示されます。各行には、イベント、ステータス、時刻、あればメッセージが表示されます。長いメッセージにカーソルを合わせると全文を確認できます。配信記録は30日間保持されます。

カードに最終配信の行がない場合、そのアプリにはまだ何も送信されていません。

ステータスの意味

カードのバッジは、直近の結果に従います。成功またはスキップの場合は接続済み、失敗した場合はエラー、アプリを一時停止している場合は一時停止中です。

イベント名の意味

よくあるスキップメッセージ

これらは通常の動作であり、別の結果を期待していた場合を除き、対応は不要です。

エラーを修正する

キーが拒否された、またはメッセージに401か403が含まれる。 APIキーまたはトークンが取り消された、期限切れになった、または権限が不足しています。連携ダイアログに記載された権限で、相手のアプリ側で新しいキーを作成してください。その後、カードの設定をクリックして貼り付け、設定を保存をクリックしてください。

接続の期限が切れた(サインイン方式のアプリ)。 Google Calendar、Google Sheets、Google Drive、HubRiseの場合、カードの再接続をクリックし、再度サインインしてください。

「HTTP 404が返されました」または「Slackがメッセージを拒否しました。WebhookのURLを確認してください。」 WebhookのURLが機能しなくなっています。これは、SlackのWebhook、Teamsのワークフロー、DiscordやGoogle ChatのWebhook、Zap、Makeのシナリオ、n8nのワークフローが削除または無効化された場合に発生します。新しいものを作成し、設定にそのURLを貼り付けてください。

リスト、プロジェクト、ボード、データベースが見つからない。 設定内のIDが、削除された、またはそのキーではアクセスできないものを指しています。相手のアプリ側でIDとキーのアクセス権を確認してください。

エラーが1回だけ発生した。 相手のアプリの一時的な障害は再試行されません。次のイベントは通常どおり送信されます。相手のアプリ側で見落とした項目を確認し、必要であれば手動で追加してください。

原因を修正した後、カードのテストまたはテストを送信をクリックしてください。成功したテストは、一覧に緑色のtest行として表示されます。

配信失敗のメールアラート

同じアプリへの配信が3回連続で失敗すると、ワークスペースのオーナーに「アプリ名 の連携に対応が必要です」という件名のメールが届き、最後のエラー内容と連携へのリンクが記載されます。このメールは、アプリごとに1日1回までの送信です。

Google Calendarについては、Googleとの接続が期限切れになった際に「Google Calendarが切断されています — 予約が重複する可能性があります」という別のメールが送信されます。詳しくはカレンダーと予定のブロックをご覧ください。

よくある質問

通話が見当たらないが、エラーも表示されない。 設定でそのイベントにチェックが入っているか、対応が必要な通話のみによって除外されていないか、当時アプリが一時停止していなかったかを確認してください。テスト通話による通話の更新、受信トレイの項目、注文は送信されません。詳しくは送信する内容を選ぶをご覧ください。

失敗した配信を再送信できますか? できません。配信は後で再試行されるようキューに入ることはありません。原因を修正し、次のイベントが正しく届くようにしてください。

自分のWebhookエンドポイントへの配信はどこで確認できますか? 開発者で追加したエンドポイントは、そのページの最終配信列に直近の結果が表示されます。詳しくはWebhookをご覧ください。