設定

送信 Webhook

CRM で何かが起きたその瞬間に、別のシステムへ知らせます。URL を登録し、対象のイベントにチェックを入れると、そのイベントが発生するたびに SellioCRM が署名付きの JSON を POST します。自動化ツール、自社のバックエンド、社内の ERP との連携に使えます。

定期的な問い合わせによる連携は遅く、費用もかさみます。誰かが1分おきに、何か変わったかと尋ね続けることになるからです。Webhook はその逆で、CRM のほうから知らせます。レコードが作成されたとき、承認が決まったとき、誰かがケイデンスに返信したとき、システムはあなたが指定したアドレスへ、そのイベントのデータを送ります。

登録のしかた

設定を開き、チャネルとコミュニケーションのグループに移動します。
Webhook をクリックします。
送信先 URL に、呼び出しを受け取るアドレスを https で始まる形で入力します。
イベントで、対象のものにチェックを入れます。record.created と record.updated が最初から選ばれています。
「Webhookを作成」をクリックします。
「Webhookシークレット」のカードに表示されたシークレットをコピーします。表示は一度きりです。

利用できるイベント

レコード: record.created と record.updated です。自分のオブジェクトのレコードが作成されたときと更新されたときに発火します。
ケイデンスとフロー: flow.enrolled、flow.message_sent、flow.replied、flow.step_completed、flow.completed です。
承認: approval.requested、approval.approved、approval.rejected です。

SellioCRM からの呼び出しであることを検証する

すべての呼び出しには、コンテンツタイプに加えて2つのヘッダーが付きます。イベント名を持つ x-sellio-event と、x-sellio-signature です。後者は sha256 に続けて、リクエストの本文そのものに対してシークレットで計算した認証コードが入ります。自分のサーバー側で、受け取った本文からこのコードを再計算して比較してください。一致しない場合は破棄します。送信元はあなたの CRM ではありません。

POST https://your-system.com/webhook
x-sellio-event: record.created
x-sellio-signature: sha256=<シークレットで計算したコード>
content-type: application/json

{
  "event": "record.created",
  "tenantId": "...",
  "objectApiName": "opportunity",
  "recordId": "...",
  "data": { "name": "アンドラーデ金属", "amount": 48000 },
  "timestamp": "2026-03-12T15:42:10.000Z"
}

例: ある卸売業者は、案件が受注になった瞬間に ERP で注文を起票したいと考えています。連携基盤の URL を登録し、record.updated にチェックを入れ、シークレットを保管します。そして連携基盤の側で署名を検証し、data の中のステージ項目を見て、ステージが受注のときだけ注文を作成します。

制約と挙動

送信はその場で行われ、待機時間の上限は4秒です。レコードを保存した人の操作を止めることはありません。
自動での再送はありません。サーバーが停止していた場合、そのイベントは配信の表に失敗として表示され、再送されません。受け側はそれを許容できるように設計してください。
受け付けられるのは、公開インターネットを指す http と https のアドレスだけです。社内アドレス、ローカルネットワーク、クラウドのメタデータサービスのアドレスは、安全のため拒否されます。
各 Webhook の横にある有効と一時停止中の切り替えで、設定を消さずに送信を止められます。
シークレットは再表示できません。紛失した場合は、その Webhook を削除して新しく作成してください。

誰が操作できるか

Webhook の作成、一時停止、削除には、設定を管理する権限が必要です。この操作は自分のレコードのデータを CRM の外へ送るものだからです。配信の一覧は、自分の組織のものに限られます。

よくある質問

イベントは届きますが、本文が不完全に見えます。イベントごとに含まれる項目の組み合わせが異なります。レコード系はオブジェクト、レコードの識別子、データを含み、フロー系はフロー、登録、レコードを含み、承認系はリクエスト、対象、ステータスを含みます。
削除のイベントは受け取れますか。利用できるイベントは、画面に表示されているものがすべてです。
署名がどうしても一致しません。受け取った生の本文に対してコードを計算してください。JSON を再シリアライズすると、空白が少し変わるだけで結果が変わってしまいます。

この記事をシステム内で開く →