Webhookを受信したとき

​

AIで構築する

​

設定

​

設定方法

1. オートメーションを開き、新しいトリガーを追加します。
2. Webhookを受信したときを選択します。
3. トリガーによって固有の Webhook URL がすぐに生成されます。外部システムで必要になるため、このURLをコピーします。
4. （任意、推奨）トークンを生成をクリックして Bearer Token 認証を有効にします。受信リクエストの Authorization ヘッダーに含める必要があるトークンが生成されます。
5. オートメーションを保存して有効化します。
6. Webhook URL へ POST リクエストを送るよう外部システムを設定します。認証を有効にした場合は、ヘッダーにトークンを含めます。
7. 以下の例を使用してテストリクエストを送ります。オートメーションの実行履歴で、データが正しく受信されたことを確認します。
8. アクションステップを追加します。アクションフィールドの + をクリックすると、Webhook の JSON 本文の値を参照できます。

​

後続ステップで利用できるデータ

{
  "order_id": "12345",
  "customer": "Alice",
  "amount": 99.95
}

​

レスポンスをカスタマイズする

{"challenge":"{{body.challenge}}"}

​

Webhookをテストする

curl -X POST https://your-teable-instance.com/api/webhook/base/bseXXXXXXXXXXXX/workflow/wflXXXXXXXXXXXX \
  -H "Content-Type: application/json" \
  -d '{"test": true, "message": "curl からこんにちは"}'

curl -X POST https://your-teable-instance.com/api/webhook/base/bseXXXXXXXXXXXX/workflow/wflXXXXXXXXXXXX \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer your-generated-token" \
  -d '{"order_id": "12345", "status": "paid"}'

curl -X POST https://your-teable-instance.com/api/webhook/base/bseXXXXXXXXXXXX/workflow/wflXXXXXXXXXXXX \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer your-generated-token" \
  -d '{
    "event": "invoice.paid",
    "data": {
      "invoice_id": "INV-001",
      "amount": 250.00,
      "currency": "USD",
      "customer_email": "alice@example.com"
    }
  }'

​

レート制限

​

セキュリティの推奨事項

• 本番環境の Webhook では、必ず Bearer Token 認証を使用してください。公開 Webhook URL は、URLを知った人なら誰でも実行できます。
• Webhook URL は非公開にしてください。 パスワードと同様に扱い、公開リポジトリへコミットしたり、公開チャンネルで共有したりしないでください。
• トークンが漏えいした可能性がある場合は、トークンを再生成してください。トリガーパネルからいつでも新しいトークンを生成できます。
• ワークフローでデータを検証してください。 受信データが正しい形式であると決めつけないでください。処理前にフィルターやスクリプトステップを使用し、必須フィールドが存在することを確認します。
• 実行履歴を監視してください。 オートメーションの実行ログを定期的に確認し、予期しないリクエストや未認証リクエストを見つけます。

​

使用例

• Stripe や PayPal から支払いイベントを受信する。 Stripe の Webhook から invoice.paid イベントを Teable のオートメーションへ送信し、注文レコードを自動作成または更新します。
• Webサイトのフォーム送信を受け付ける。 Webサイトのお問い合わせフォームや登録フォームの送信先を Webhook URL にして、Teable にレコードを直接作成します。
• IoTデバイスからデータを取り込む。 HTTP リクエストを送信できるセンサーやデバイスから Teable へデータを送り、監視やアラートに使用します。
• CI/CD パイプラインを接続する。 ビルドの成功時または失敗時にワークフローを実行し、レコードの作成、通知の送信、プロジェクトステータスの更新を行います。
• 任意の SaaS ツールからイベントを受信する。 GitHub、Jira、Shopify、Twilio など、多くのツールが Webhook 通知に対応しています。Teable の Webhook を送信先に設定して、ツール間のワークフローを自動化します。

​

ヒント

• Webhook は POST リクエストだけを受け付けます。GET、PUT などのメソッドではオートメーションを開始しません。
• 必ず Content-Type: application/json ヘッダーを送信してください。本文が有効な JSON でない場合、トリガーがデータを正しく解析できないことがあります。
• Bearer 認証用のカスタムヘッダーに対応していないシステムからデータを送る場合は、公開モードを使用し、JSON 本文に秘密鍵を追加して、ワークフロー内のフィルターやスクリプトで検証する方法を検討してください。
• デバッグでは、webhook.site のようなサービスを使い、外部システムから実際に送信される内容を確認してから Teable を送信先に設定できます。

​

関連ページ

• HTTP リクエストアクション — ワークフローから外部APIを呼び出す、送信側の機能です
• スクリプトを実行 — Webhook ペイロードの高度な処理に使用します
• ループ（一括）アクション — Webhook ペイロード内の配列を処理します