HookSignal
サインインはじめる
APIドキュメント
Integrations

連携ガイド

主要なサービスとHookSignalを連携するための設定手順をまとめています。各サービスのWebhook設定画面からHookSignalのURLを登録するだけで連携できます。

事前準備（すべてのサービス共通）
1

HookSignalでプロジェクトを作成

ダッシュボード → 「新規プロジェクト」からプロジェクトを作成します。

2

アプリ（Webhook受信URL）を追加

プロジェクト設定 → 「アプリ管理」→ 「アプリを追加」で連携サービス用のWebhookアプリを作成します。 作成後に表示される Webhook URL と Signing Secret を控えます。

# 発行されるURL例
https://hooksignal.io/api/incoming/whk_xxxxxxxxxxxx

# 署名シークレット例
whsec_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
開発・CI/CD

GitHub

リポジトリの push、Pull Request、Issue、リリースなどのイベントをHookSignalに送信します。

1

リポジトリの Settings を開く

対象リポジトリ → Settings → 左メニュー Webhooks → Add webhook

2

Webhook設定を入力

項目値
Payload URLHookSignalで発行されたWebhook URL
Content typeapplication/json
SecretHookSignalのSigning Secret
Events「Let me select individual events」から必要なイベントを選択（推奨: Push, Pull Request, Issues, Releases）
3

署名検証ヘッダー

GitHubは X-Hub-Signature-256 ヘッダーで HMAC-SHA256 署名を送信します。HookSignalはこれを自動検証します。

Organization 全体に設定する場合は Organization Settings → Webhooks から同様に設定できます。

GitLab

Push、Merge Request、Pipeline、Issue などのイベントをHookSignalに送信します。

1

プロジェクトの Settings → Webhooks

対象プロジェクト → Settings → Webhooks → 「Add new webhook」。

2

Webhook設定を入力

項目値
URLHookSignalで発行されたWebhook URL
Secret tokenHookSignalのSigning Secret
TriggerPush events, Merge request events, Pipeline events, Issues events などから選択
SSL verificationEnable SSL verification（推奨）

GitLabは X-Gitlab-Token ヘッダーで Secret token を送信します。Group レベルでも同様に設定可能です。

Bitbucket

Push、Pull Request の作成・マージ、Pipeline 完了などのイベントをHookSignalに送信します。

1

リポジトリの Settings → Webhooks

対象リポジトリ → Repository settings → Webhooks → 「Add webhook」。

2

Webhook設定を入力

項目値
Title任意（例: HookSignal）
URLHookSignalで発行されたWebhook URL
TriggersRepository push, Pull Request (Created, Updated, Merged), Build status updated などから選択

Bitbucket Cloud のWebhookは署名検証をネイティブサポートしていません。IPホワイトリストまたは Webhook URL にトークンを含める方法で保護してください。

CircleCI

ビルドの成功・失敗、ワークフロー完了などのイベントをHookSignalに送信します。

1

Project Settings → Webhooks

対象プロジェクト → Project Settings → Webhooks → 「Add Webhook」。

2

Webhook設定を入力

項目値
Receiver URLHookSignalで発行されたWebhook URL
Name任意（例: HookSignal）
Eventsworkflow-completed, job-completed から選択
SecretHookSignalのSigning Secret

CircleCIは circleci-signature ヘッダーで HMAC-SHA256 署名を送信します。

Vercel

デプロイメントの開始・完了・エラーなどのイベントをHookSignalに送信します。

1

Vercel Dashboard → Settings → Webhooks

Account Settings（またはTeam Settings） → Webhooks → 「Create Webhook」。

2

設定を入力

項目値
Endpoint URLHookSignalで発行されたWebhook URL
Eventsdeployment.created, deployment.succeeded, deployment.failed, deployment.error
Projectsすべてのプロジェクト、または特定のプロジェクトを選択

Webhook作成後に表示される Secret をHookSignalのSigning Secretに設定してください。

Linear

Issue の作成・更新・完了、コメント追加などのイベントをHookSignalに送信します。

1

Linear → Settings → API → Webhooks

Workspace Settings → API → 「Webhooks」セクション → 「New webhook」。

2

設定を入力

項目値
URLHookSignalで発行されたWebhook URL
Label任意（例: HookSignal）
Resource typesIssues, Comments, Projects などから選択
3

Signing Secret を設定

作成後に表示される Webhook signing secret をHookSignalのSigning Secretに設定します。

Linearは Linear-Signature ヘッダーで HMAC-SHA256 署名を送信します。

コミュニケーション

Slack

Slackアプリの Event Subscriptions を使って、メッセージやリアクションなどのイベントをHookSignalに転送します。

1

Slack App を作成

api.slack.com/apps → 「Create New App」→ 「From scratch」でアプリを作成します。

2

Event Subscriptions を有効化

左メニュー Event Subscriptions → Enable Events を ON → Request URL にHookSignalのWebhook URLを入力。

3

購読イベントを選択

「Subscribe to bot events」から必要なイベントを追加します。

message.channelsmessage.groupsreaction_addedapp_mentionchannel_created
4

Signing Secret を設定

「Basic Information」→ App Credentials にある Signing Secret をHookSignalのアプリ設定のSigning Secretに設定します。

Slackはチャレンジ認証（URL Verification）を行います。HookSignalはこれに自動応答します。

Gmail (Google Workspace)

Google Cloud Pub/Sub と Gmail API の push notification を使って、受信メールイベントをHookSignalに転送します。

1

Google Cloud Pub/Sub トピックを作成

Google Cloud Console → Pub/Sub → 「トピックを作成」。トピック名は任意（例: gmail-hooksignal）。

2

Push サブスクリプションを作成

作成したトピックに Push サブスクリプションを追加し、エンドポイントURLにHookSignalのWebhook URLを指定します。

3

Gmail API で watch を設定

POST https://gmail.googleapis.com/gmail/v1/users/me/watch

{
  "topicName": "projects/your-project/topics/gmail-hooksignal",
  "labelIds": ["INBOX"],
  "labelFilterBehavior": "INCLUDE"
}

Gmail watch は7日間で有効期限切れになります。定期的に再登録が必要です。

Google Workspace Admin の場合、ドメイン全体の通知も設定可能です。

バックエンド

Supabase

Database Webhooks を使って、テーブルの INSERT / UPDATE / DELETE イベントをHookSignalに送信します。

1

Supabase Dashboard → Database → Webhooks

プロジェクト → Database → Webhooks → 「Create a new webhook」。

2

Webhook を設定

項目値
Name任意（例: hooksignal-orders）
Table監視対象テーブルを選択
EventsINSERT / UPDATE / DELETE から選択
TypeHTTP Request
URLHookSignalで発行されたWebhook URL
HTTP HeadersContent-Type: application/json

Supabase Database Webhooks は現在署名検証をサポートしていません。HookSignalのアプリ設定でSigning Secretを空にしてください。

モニタリング・インフラ

Sentry

エラー発生、Issue作成・解決などのイベントをHookSignalに送信し、モニタリングを効率化します。

1

Sentry → Settings → Integrations

Organization Settings → Integrations → 「Internal Integrations」→ 「Create New Integration」。

2

Webhook を設定

「Webhooks」セクションの Webhook URL にHookSignalのURLを入力し、送信したいイベントにチェックを入れます。

issueerrorcommentevent_alertmetric_alert
3

Client Secret を設定

「Credentials」セクションの Client Secret をHookSignalのSigning Secretに設定します。

Sentryは sentry-hook-signature ヘッダーで署名を送信します。

Datadog

モニター（アラート）の発火・解消時にWebhookでHookSignalに通知を送信します。

1

Integrations → Webhooks

Datadog → Integrations → 検索で「Webhooks」→ 「Configuration」タブ → 「New」。

2

Webhook を設定

項目値
Name任意（例: hooksignal）
URLHookSignalで発行されたWebhook URL
PayloadデフォルトのJSON payloadを使用（カスタマイズ可）
3

Monitor にWebhookを紐づけ

Monitors → 対象のMonitorを編集 → 「Notify your team」セクションで @webhook-hooksignal を追加します。

Datadogの Webhook ペイロードはテンプレート変数（$EVENT_TITLE, $ALERT_STATUS 等）でカスタマイズ可能です。

PagerDuty

インシデントの作成・解決・エスカレーション・担当者変更などのイベントをHookSignalに送信します。

1

Integrations → Generic Webhooks (v3)

Service Directory → 対象サービス → Integrations タブ → 「Add Integration」→ 「Generic Webhooks (v3)」を選択。

2

Webhook Subscription を設定

項目値
Delivery URLHookSignalで発行されたWebhook URL
Eventsincident.triggered, incident.acknowledged, incident.resolved, incident.escalated などから選択
Custom Headers必要に応じて追加（任意）

PagerDuty v3 Webhooksは X-PagerDuty-Signature ヘッダーで HMAC-SHA256 署名を送信します。

Grafana

アラートルールの発火・解消時にWebhookでHookSignalに通知を送信します。

1

Alerting → Contact points

Grafana → Alerting → Contact points → 「Add contact point」。

2

Webhook タイプを設定

項目値
Name任意（例: HookSignal）
TypeWebhook
URLHookSignalで発行されたWebhook URL
HTTP MethodPOST
3

Notification policy に割り当て

Notification policies で作成した Contact point をデフォルトまたは特定のラベルマッチャーに割り当てます。

Grafana Cloud / OSS 両方で利用可能です。Authorization ヘッダーにBearerトークンを設定することも可能です。

AWS SNS

Amazon SNS の HTTP/HTTPS サブスクリプションを使って、AWSサービスのイベントをHookSignalに転送します。

1

SNS トピックを作成（または既存を使用）

AWS Console → SNS → 「トピックの作成」→ タイプ「Standard」を選択。

2

HTTPS サブスクリプションを作成

項目値
ProtocolHTTPS
EndpointHookSignalで発行されたWebhook URL
3

サブスクリプション確認

SNSはサブスクリプション作成時に SubscribeURL を含む確認リクエストを送信します。HookSignalはこれを自動確認します。

CloudWatch Alarms、S3 Event Notifications、CodePipeline など多数のAWSサービスからSNS経由で通知を受信できます。

SNSはメッセージ署名を送信します。HookSignalは証明書ベースの検証に対応しています。

Cloudflare

Cloudflare Notifications でDDoSアラート、SSL証明書更新、ヘルスチェック失敗などをHookSignalに送信します。

1

Notifications → Destinations → Webhooks

Cloudflare Dashboard → Notifications → Destinations タブ → 「Create」→ タイプ「Webhook」。

2

Webhook を設定

項目値
Name任意（例: HookSignal）
URLHookSignalで発行されたWebhook URL
SecretHookSignalのSigning Secret（任意）
3

通知ポリシーに割り当て

「Notifications」タブ → 「Add」から通知タイプを選択し、Destinationに作成したWebhookを設定します。

DDoS AttackSSL Certificate ExpirationHealth Check FailureFirewall EventsWorkers Errors

Cloudflare Webhook Notifications は「Test」ボタンでテスト送信が可能です。連携後に動作確認を行ってください。

EC・決済

Stripe

決済成功・失敗、サブスクリプション変更、返金などのイベントをリアルタイムで受信します。

1

Stripe Dashboard → Webhooks

dashboard.stripe.com/webhooks → 「エンドポイントを追加」をクリック。

2

エンドポイントを設定

項目値
エンドポイント URLHookSignalで発行されたWebhook URL
リッスンするイベント必要なイベントを選択（推奨: charge.succeeded, charge.failed, customer.subscription.*, invoice.*）
3

Webhook Signing Secret を設定

作成したエンドポイントの「署名シークレット」（whsec_...）をHookSignalのアプリ設定のSigning Secretに設定します。

Stripeは Stripe-Signature ヘッダーで署名を送信します。HookSignalはこれを自動検証します。

Shopify

注文作成・更新、在庫変更、顧客登録、商品更新などのイベントをHookSignalに送信します。

1

Settings → Notifications → Webhooks

Shopify Admin → Settings → Notifications → ページ下部「Webhooks」セクション → 「Create webhook」。

2

Webhook を設定

項目値
EventOrder creation, Order payment, Product update, Customer creation などから選択
FormatJSON
URLHookSignalで発行されたWebhook URL
API version最新の安定版を選択（推奨）
3

HMAC 署名検証

Webhooksセクション下部に表示される Signing secret をHookSignalのSigning Secretに設定します。

Shopifyは X-Shopify-Hmac-Sha256 ヘッダーで Base64 エンコードされた HMAC-SHA256 署名を送信します。

PayPal

決済完了、返金、チャージバック、サブスクリプション変更などのイベントをHookSignalに送信します。

1

Developer Dashboard → Webhooks

developer.paypal.com → 対象のApp → 「Webhooks」セクション → 「Add Webhook」。

2

Webhook を設定

項目値
Webhook URLHookSignalで発行されたWebhook URL
Event typesPayment capture completed, Payment sale refunded, Billing subscription activated などから選択
3

Webhook ID を確認

作成後に表示される Webhook ID を控えます。PayPalは証明書ベースの署名検証を使用するため、Signing Secretの代わりにWebhook IDが必要になる場合があります。

PayPalは PAYPAL-TRANSMISSION-SIG ヘッダーで署名を送信します。Sandbox 環境でのテストも可能です。

その他のサービス

HookSignalは HTTP POST で JSON を送信できるすべてのサービスに対応しています。 上記にないサービスでも、Webhook設定画面でHookSignalのURLを指定するだけで連携できます。

Jira
Twilio
SendGrid
Intercom
HubSpot
Discord
Notion
Mailgun

設定方法が分からない場合はAPIドキュメントをご確認ください。