2026 OpenClaw レンタル Mac Mini 実戦:Zendesk Webhook で夜間バッチのチケット要約・サイレンス窓・退避再試行を再現する
想定リスク(夜間に効く三点)
- 共有トークンは権限が広がり、launchd 漏洩が致命傷になります。
- 二〇〇でも JSON 検証失敗でキューだけ膨らみます。
- 四二九にジッタなし再試行はスロットルを延ばします。
受信 Webhook と外向き Support API
面の選択とサブドメイン単位の許可が重要です。
| ニーズ | トリガー Webhook | Support API(Mini から) |
|---|---|---|
| リアルタイム | HTTPS へ即 POST | ポーリングは遅延増 |
| 夜間要約 | 集計には不向き | 内部コメントへ POST |
| 外向き | TLS 検証が要る | *.zendesk.com のみ出せば簡潔 |
サイレンス窓・バックオフ・重複抑止
| 制御 | 初期値の例 | 運用メモ |
|---|---|---|
| 余白 | 終了+十五〜三十分 | 同一 UTCフラグを OpenClaw に |
| バックオフ | 二秒基準・六十秒上限・五回・二割ジッタ | Retry-After を最優先 |
| 重複 | 五分はスキップ | external_id で冪等 |
| アラート | 五系が三回連続 | TLS 期限を先に疑う |
ゲートウェイ基礎排障(インストール直後に)
Caddy/nginx で終端し、openssl s_client でチェーン確認。四〇一/四〇三は認証、五〇二はボディ上限とkeepaliveを先に。x-zendesk-request-id とステータスのみログし本文はマスク。
再現手順(七ステップ)
- 導入どおり OpenClaw を入れ launchd 固定。
- API トークンは
email/tokenを git 外 chmod 600 で注入。 - トリガーに HTTPS を登録しテストで 二〇〇・五秒以内。
- ゲートウェイを切り分け構造化ログへ。
- 夜間集計は サイレンス窓で Support API を止める。
- 四二九/五系退避と x-zendesk-request-id、予算枯渇後のみページ。
- ログを転送し七時二十四分閾値を可視化。
引用値:重複五分・試行五回・上限六十秒・余白十五〜三十分・五系三連でアラート。
FAQ
- OAuth か
- マルチテナントは OAuth、単一ホストは API トークン。
- 配信成功でも無反応
- エッジが先に ACK。署名・生バイト長・パースを段階ログ。
- 内部メモが二重
- external_id と窓ごとの最終 ID を永続化。
まとめ:認証・UTC 窓・バックオフ上限・ゲートウェイ排障で夜間連携を安定化。料金・ヘルプ・公開購入(ログイン不要可)。