kintoneのWebhookを設定したのに、「連携先にデータが届いていない」「原因が分からない」と困った経験はありませんか。
kintone標準のWebhookには、送信結果を確認する画面もリトライ機能もありません。そのため、いったん失敗すると気づく手段がなく、お客様からの指摘で発覚するケースも少なくありません。
本記事では、Webhookが届かない・失敗するときに確認すべきポイントを、症状別のチェックリストとして整理しました。
まず確認すべき5つの基本設定
多くの「届かない」トラブルは、まず以下の基本設定を見直すだけで解決します。
| チェック項目 | 確認方法 |
|---|---|
| Webhook設定が有効になっているか | アプリの設定 > Webhook画面で、対象のWebhookがオン（有効）になっているか確認 |
| 送信先URLが正しいか | httpsで始まっているか、末尾の余分なスラッシュや空白がないかを目視で確認 |
| 通知対象の操作が合っているか | 「レコードの追加」「更新」「削除」のうち、意図した操作にチェックが入っているか確認 |
| 条件式による絞り込みが影響していないか | Webhookに条件式を設定している場合、今回の操作対象レコードがその条件に合致しているか確認 |
| 送信先サーバーの証明書が有効か | 送信先のSSL証明書が期限切れ・不正になっていないか確認（証明書エラーは送信失敗の典型的な原因） |
これらは初歩的に見えて、実際のトラブル相談でも多く報告されている原因です。
kintoneの仕様に起因する、見落としやすい制約
設定に問題がなくても、kintoneの仕様そのものに起因して「届かない」ことがあります。
ドメイン単位で1分間に60回までの送信上限
kintoneのWebhook通知には、ドメイン単位で1分間に60回までという送信上限があります。この上限を超えた分の通知は送信されません。
CSVの一括インポートやAPI経由での連続更新など、短時間に大量のレコード操作を行う場面では、この上限に引っかかりやすくなります。「普段は問題ないのに、一括更新のときだけ一部が抜ける」という症状に心当たりがあれば、まずこの上限を疑ってください。
標準Webhookにはリトライ機構がない
kintone標準のWebhookは、送信先が一時的にダウンしていたりタイムアウトしたりした場合でも、自動的に再送信することはありません。そのイベントは送信されたきり失われます。
連携先システムのメンテナンス中にたまたま発生した操作のデータが、そのまま欠落してしまう——これは設定ミスではなく、標準仕様上の制約です。
送信結果を確認する画面がない
kintone側には、Webhookが「成功したか」「失敗したか」を確認できる管理画面がありません。届いていないことに気づくきっかけは、連携先のデータを見て「あれ、抜けている」と気づくか、お客様からの指摘くらいしかないのが実情です。
症状別・原因と対処のチェックリスト
ここまでの内容を、症状から原因を辿れる形で整理します。
| 症状 | 想定される原因 | 対処法 |
|---|---|---|
| 特定の操作をしても全く届かない | URLの誤り、Webhookが無効化されている | URL・有効化状態を再確認する |
| 一部の操作の時だけ届かない | 通知条件・絞り込み条件式で対象外になっている | 条件設定を見直す |
| 大量更新時にだけ一部が抜ける | 1分間60回の送信上限に達している | 更新を分散させる、またはSureHookなどの中継サービスでキューイングする |
| 連携先メンテナンス中の操作分だけ消える | 標準Webhookにリトライがない | 受信側でキューを持つ、またはリトライ機能を持つSureHookなどの中継サービスを導入する |
| 届いているかどうかも分からない | 送信結果・ペイロードを確認する手段がない | SureHookなどの中継サービスでログを保存する（ペイロードの確認方法はこちら） |
恒久対策：Webhookとkintoneの間に「中継」を挟むという選択肢
ここまでの原因の多くは、kintone標準のWebhookが「送りっぱなし」の仕組みであることに起因します。設定を見直しても解決しない場合、根本的な対策は、kintoneと連携先の間にリトライ・ログ保存・失敗通知を備えたSureHookなどの中継サービスを挟むことです。
私たちが開発している「SureHook」は、まさにこの課題を解決するために作ったkintone Webhook中継SaaSです。kintoneからのWebhookをいったん受け取り、自動リトライやログ保存を行った上で、あらためて連携先へ転送します。転送に失敗し続けた場合はDLQ（Dead Letter Queue）へ退避し、原因を直したあとに手動で再送することもできます。
「SureHook」は、kintone標準Webhookにはない自動リトライ・失敗時のログ保存・手動再送を追加するkintone Webhook中継SaaSです。
kintoneへのポーリングや認証情報の預かりは一切なく、Webhookの送信先URLを差し替えるだけで導入できます。