Webhookを作成
- Settings → APIs & Webhooks → Webhooksに移動
- + Webhookを作成をクリック
- ウェブフックの URL を入力(外部からアクセス可能である必要があります)
- 保存をクリック
Webhookを管理
編集: ウェブフックをクリック → URL を更新 → 保存 削除: ウェブフックをクリック → 削除 → 確認イベント
Twenty は次のイベントタイプに対してウェブフックを送信します。
すべてのイベントタイプはウェブフックの URL に送信されます。 イベントのフィルタリングは将来のリリースで追加される可能性があります。
ペイロード形式
各ウェブフックは JSON ボディを含む HTTP POST を送信します。受信を確認するために、2xx HTTP ステータス(200~299)で応答してください。 2xx 以外の応答は配信失敗として記録されます。
ウェブフックの検証
Twenty はセキュリティのために各ウェブフックリクエストに署名します。 リクエストが正当であることを確認するために署名を検証してください。ヘッダー
検証手順
X-Twenty-Webhook-Timestampからタイムスタンプを取得- 次の文字列を作成:
{timestamp}:{JSON payload} - ウェブフックシークレットを使用して HMAC SHA256 を計算
X-Twenty-Webhook-Signatureと比較
例(Node.js)
ウェブフック vs ワークフロー
外部データの受信については、Webhook トリガーを設定を参照してください。