開発者
ウェブフック
アカウントが生成するすべての通知は、署名付きのJSON POSTとしてお客様のシステムに直接送信できるため、ホスティング環境での出来事を他の場所でのワークフローのトリガーとして使用できます。
接続できるサービス
Webhookは通常のHTTPSリクエストであるため、それを受信できるものであればどのようなものでも処理を実行できます。お客様のツール用にインテグレーションを弊社側で開発する必要はありません。
自動化プラットフォーム
n8n, Make, Zapier, Pipedream, Activepieces内のワークフローにウェブフックを指定するだけで、あらゆるイベントがトリガーになります。チャンネルへの投稿、チケットの作成、スプレッドシートの更新、別APIの呼び出しなどが可能です。HTTPS経由でエンドポイントにアクセスできる限り、セルフホスト型プラットフォームでも全く同様に機能します。
CRMおよびヘルプデスク
請求およびアカウントのイベントを HubSpot, Pipedrive, Salesforce や、インバウンドWebhooksに対応するヘルプデスクまたは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タイプの送信先を追加してください。
- HTTPSエンドポイントを指定し、表示される署名シークレットをコピーしてください。
- 「テスト送信」をクリックしてください。本番と同じ形式の本物のリクエストを送信するため、実際に何かが起こる前に、そのリクエストに対応する開発を行うことができます。
- その宛先が受け取るカテゴリを選択してください。新しい種類の通知は自動的に有効になります。
配信先はいくつでも追加でき、ウェブフックとメール、Slack、Telegramを組み合わせて、それぞれに異なるカテゴリーを設定できます。