開発者

Webhook

アカウントが生成するすべての通知は、署名付きの JSON POST としてお客様のシステムに直接送信できます。そのため、ホスティング上で発生した事象をトリガーに、他のあらゆる場所でワークフローを開始できます。

すべての開発者向けドキュメント →

接続できる対象

Webhook は通常の HTTPS リクエストであるため、それを受信できるものであれば何でもそれに基づいて処理を実行できます。お客様のツールのための統合を当社が構築する必要はありません。

自動化プラットフォーム

Webhook を n8n, Make, Zapier, Pipedream, Activepieces のワークフローに向けると、すべてのイベントがトリガーになります。チャンネルへの投稿、チケットの起票、スプレッドシートの更新、別の API の呼び出しなどが可能です。エンドポイントに HTTPS 経由でアクセスできる限り、セルフホストのプラットフォームもまったく同様に機能します。

CRM とヘルプデスク

請求およびアカウントのイベントをHubSpot, Pipedrive, Salesforce、または受信 Webhook を備えた任意のヘルプデスクや CRM に送信することで、手動でデータを転記することなく、顧客レコードにホスティングの利用状況を反映させることができます。

リッスンしているその他のすべて

Slack, Discord, Google Sheets, Airtable, Notion、独自のモニタリング、データウェアハウス、またはご自身で作成した小さなスクリプト。HTTPS POST を受け入れ、JSON を読み取ることができれば、これらを受信できます。

送信される内容

どのカテゴリーをどの宛先に送信するかを選択できます。また、複数を接続できるため、請求情報は特定の場所に、サイトのアラートは別の場所に送信することが可能です。デフォルトですべて有効になっています。

請求とお支払い

発行済みおよび支払い済みの請求書、失敗した支払い、有効期限が近づいているカード、更新およびキャンセル。

サイトとセキュリティ

プロビジョニング完了、サイトの一時停止、マルウェアの検出、バックアップ、証明書の変更。

サポートとドメイン

オープンおよびエスカレーションされたチケット、ドメイン移管、更新、DNS の変更。

リクエストが当社からのものであることを証明する

すべてのリクエストは、お客様と当社のみが保持するシークレットで署名されています。本文に基づいて対応を行う前に署名を確認してください — これらのヘッダーは配信ごとに届きます:

X-Zinn-Signature: sha256=<hmac of `timestamp.body`>
X-Zinn-Timestamp: unix seconds
X-Zinn-Delivery: stable id for this delivery
X-Zinn-Event: invoice.paid

タイムスタンプは本文の横に添えて送信されるのではなく本文と一緒に署名されるため、傍受されたリクエストが後から再送されるのを防ぐことができます。数分以上経過したものはすべて拒否してください。

署名シークレットは、Webhook を追加した際に一度だけ表示されます。再表示することはできません。紛失した場合は、送信先を削除して再度追加してください。

設定中

  1. ダッシュボードで「通知」を開き、Webhook タイプの宛先を追加してください。
  2. HTTPS エンドポイントを指定し、表示されている署名シークレットをコピーしてください。
  3. Test を押してください。本番と同じ形式で実際のリクエストを送信するため、実際に何かが発生する前にそれに対して構築できます。
  4. その送信先が受信するカテゴリを選択してください。新しい種類の通知は自動的にオンになります。

送信先はいくつでも自由に追加でき、Webhook をメール、Slack、Telegram と組み合わせたり、それぞれに異なるカテゴリのセットを割り当てたりすることができます。

お電話でのお問い合わせをご希望ですか ?

Webhook は、何かが発生したことを通知します。API は、何かを実行するための手段です。ダッシュボードが実行するすべての操作をご利用いただけます。

API リファレンスを参照