対象
💡「外部システムに連携」は、Starterプランを含むすべてのプランでご利用いただけます。
利用可能なトリガー、オートメーション件数は、ご契約内容によって異なります。
👉詳しく見る
概要
「外部システムに連携」は、オートメーションのオペレーションブロックの1つです。
案件やコンタクトなどが登録・更新されたときに、そのデータを、指定したURL（連携先）へ自動で送信します。この仕組みは一般にWebhook（ウェブフック）と呼ばれます。
自社の基幹システムや、iPaaS（Yoom・DataHubなどの連携サービス）で、Mazrica Salesの変更をほぼリアルタイムに受け取れます。外部システムからAPIを定期的に呼び出して変更を確認する必要はありません。
送信するデータの絞り込みや、条件による分岐は、ほかのオートメーションと同じようにトリガーとルールブロックで設定します。送信結果は、オートメーションの実行履歴で確認できます。
送信したデータを連携先でどのように処理するかは、連携先のシステム側で設定してください。
Mazrica Sales側で、連携先からデータを受け取ったり、連携先のシステムを操作したりすることはできません。
連携できるデータ
ブロックで選んだ「対象オブジェクト」のデータを送信します。
対象オブジェクトごとに、送信できるトリガーは次のとおりです。
対象オブジェクト | 送信できるトリガー |
取引先 | 取引先が更新されたとき |
案件 | 案件が登録されたとき |
コンタクト | コンタクトが登録されたとき |
案件アクション | アクションが登録されたとき |
コンタクトアクション | アクションが登録されたとき |
次のデータは送信されません。
CSVでの一括登録・一括更新など、オートメーションのトリガーが発火しない操作で登録・更新されたデータ
上の表にないトリガー（メールの開封・クリック、ウェブサイトへのアクセスなど）では、データは送信できません。
「外部システムに連携」は、スケジュールのトリガー（「実行の予約」）では利用できません。
設定手順と関連項目
メニュー＞「オートメーション」から、オートメーションの編集画面を開きます
画面左側の「オペレーション」にある「外部システムに連携」を配置します
（「Microsoft Teamsに通知」の下にあります）配置したブロックの編集ボタンをクリックします
「名称」「対象オブジェクト」「連携先URL」を入力し、必要に応じて「リクエストヘッダー」を追加します
「設定」をクリックします
トリガーなどのブロックと接続し、オートメーションを保存します
「名称」「対象オブジェクト」「連携先URL」をすべて入力するまで、「設定」はクリックできません。
連携の有効・無効は、オートメーション自体の有効・無効に従います。ブロックごとに送信を止めることはできません。
設定項目
ブロックの編集画面で設定する項目は次のとおりです。
項目 | 必須／任意 | 内容 |
名称 | 必須 | ブロックを見分けるための名前 |
対象オブジェクト | 必須 | 送信するデータの種類 |
連携先URL | 必須 | データの送り先のURL |
リクエストヘッダー | 任意 | 連携先が求める認証情報などを一緒に送るための項目 |
リクエストヘッダー
連携先が認証情報などを求める場合は、ヘッダー名と値の組を追加します。
「＋ ヘッダーを追加」で行を追加でき、最大5組まで指定できます。
指定できるヘッダー名は次のとおりです。
指定できるヘッダー名 | 例 |
|
|
|
|
ヘッダー名の大文字と小文字は区別されません。
同じヘッダー名は指定できません。
値だけを入力してヘッダー名を空にした行は、エラーになります。
値は暗号化して保存され、保存後は表示できません。値を変更するときは、「変更」から新しい値で上書きしてください。
署名シークレットとテスト送信
オートメーションを保存したあとにブロックの編集画面を開き直すと、「署名シークレット」と「テスト送信」が使えるようになります。
署名シークレット：連携先で、受け取ったデータが本当にMazrica Salesから送られたものかを確かめるための値です。表示・コピー・再発行ができます。
テスト送信：ダミーのデータを1件送信して、連携先とつながるかを確認できます。結果はボタンの下に「送信しました（200 / 182ms）」「送信に失敗しました（500）」のように表示されます。
失敗した場合は、連携先から返されたエラーの内容もあわせて表示されます。対象オブジェクトを選ぶまでは、テスト送信はできません。
接続できる組み合わせ
「外部システムに連携」は、ブロックで選んだ対象オブジェクトと、前のブロック（トリガーなど）のオブジェクトの種類が合う場合のみ接続できます。
たとえば、「案件が更新されたとき」のトリガーには、対象オブジェクトが「案件」のブロックを接続できます。前に登録のオペレーションがある場合は、そのブロックで登録したオブジェクトも対象にできます。
「コンタクトが登録されたとき」→「案件を登録」→「外部システムに連携」（対象オブジェクト：案件）
接続できた場合でも、実行時に送信するデータが特定できないときは送信されず、実行履歴にエラーとして記録されます。
送信されるデータ
連携先URLへ、JSON形式のデータをHTTPSのPOSTで送信します。
データの形式は、Mazrica Sales API v2と同じです。
各項目の詳細は、APIリファレンスをご確認ください。
送信されるデータの要素は次のとおりです。
要素 | 内容 |
| イベントごとの識別子 （再送しても同じ値） |
| 送信したデータの種類 |
| データ形式のバージョン |
| 発生日時 |
データ本体（ | API v2で取得できるデータと同じ内容 |
対象オブジェクトと objectType の対応は次のとおりです。
対象オブジェクト | objectType |
取引先 |
|
案件 |
|
コンタクト |
|
案件アクション |
|
コンタクトアクション |
|
送信内容の例
案件が更新されたときに送信される内容の例です（値はダミーです）。
▼リクエストヘッダー
POST /webhook HTTP/1.1
Host: example.com
Content-Type: application/json; charset=utf-8
Accept-Encoding: identity
User-Agent: MazricaSales-Webhook/1.0
X-Mazrica-Event-Id: evt_3f2682bb-0f8b-4d9e-a9a7-3388f754ea61
X-Mazrica-Object-Type: deal
X-Mazrica-Domain-Id: 12345
X-Mazrica-Webhook-Id: 5
X-Mazrica-Delivery-Attempt: 1
X-Mazrica-Test-Delivery: false
X-Mazrica-Signature: t=1793845083,v1=4a175b2d96f267e4c2c63b413318dacad41f3e6bb57c237c8818c166718e2fd
▼ボディ
※ボディの例は一部の項目を省略しています。
{
"eventId": "evt_3f2682bb-0f8b-4d9e-a9a7-3388f754ea61",
"objectType": "deal",
"apiVersion": "2026-10-01",
"occurredAt": "2026-11-05T11:18:03+09:00",
"deal": {
"id": 250,
"name": "株式会社サンプル_新規導入案件",
"amount": 5000000,
"expectedAmount": 0,
"expectedContractDate": "2026-10-02",
"dealType": { "id": 2, "name": "標準" },
"customer": { "id": 150, "name": "株式会社サンプル" },
"phase": { "id": 11, "name": "ヒアリング", "status": 1 },
"user": { "id": 1, "name": "山田 太郎" },
"createdAt": "2026-08-14T15:08:48+09:00",
"updatedAt": "2026-10-15T12:22:29+09:00",
"dealCustoms": []
}
}
登録と更新の見分け方
送信されるデータには、登録か更新かの区別は含まれません。
連携先で区別したい場合は、次のいずれかの方法をご利用ください。
トリガーごとにオートメーションを分け、連携先URLを変える
ex.「案件が登録されたとき」は
/hooks/deal-created、「案件が更新されたとき」は
/hooks/deal-updated
トリガーごとにオートメーションを分け、リクエストヘッダーに区別用の値を設定する
ex.
X-Event-Kind：created／updated
連携先で、データの
idをもとに、すでにあれば更新・なければ登録する
「フォームが送信されたとき」のトリガーは、1回の送信でコンタクトや取引先が登録される場合と更新される場合があるため、オートメーションを分けても区別できません。連携先で id をもとに判断してください。
受信側で対応していただくこと
再送したデータは、最初に送信したデータと同じ
eventIdで届きます。同じデータを二重に処理しないよう、連携先でeventIdをもとに重複を除いてください。送信される順序は保証されません。データの前後関係は、
occurredAtをもとに判断してください。
実行履歴と再送
送信の結果は、オートメーションの詳細画面の「実行履歴」タブで確認できます。
ブロック種別が「外部システムに連携」の行に、送信したデータの種類とIDが表示されます。
実行ステータス | 実行結果の表示例 |
実行済み |
|
エラー |
|
IDをクリックすると、そのデータの詳細画面が別タブで開きます。
連携先でデータを受け取れなかった場合は、エラーになります。
たとえば、連携先からエラーが返された場合、応答がタイムアウトした場合、連携先に接続できなかった場合などです。実行履歴に失敗の理由は表示されません。
送信に失敗しても、自動では再送されません。エラーの行に表示される「再送」をクリックすると、同じ内容でもう一度送信します。
送信されるデータは、最初に送信しようとした時点の内容です。再送の結果は実行履歴に追加されます。
送信に失敗すると、エラー通知設定で登録したメールアドレスに通知メールが届きます。
連携先から認証の失敗（ステータス401）が返された場合は、画面のお知らせにも
「イベント連携先の認証に失敗しました。認証情報を再設定してください。」とブロックの名称が表示されます。
注意事項
更新のトリガーでは、オートメーションに設定したロールで参照できないデータは送信されません。
送信元のIPアドレスの固定・公開には対応していません。
よくあるご質問
実行履歴に「連携に失敗しました」と表示されます
連携先でデータを受け取れなかった可能性があります。
（連携先からエラーが返された、応答がタイムアウトした、連携先に接続できなかったなど）
連携先URLやリクエストヘッダーの設定、連携先のシステムの状態をご確認ください。
ブロックの編集画面の「テスト送信」で、つながるかを確認できます。
原因を解消したあと、実行履歴のエラーの行にある「再送」をクリックすると、同じ内容でもう一度送信できます。
「イベント連携先の認証に失敗しました」と表示されました
連携先で認証に失敗しています。
ブロックの編集画面を開き、リクエストヘッダーの認証情報（Authorization など）を、連携先で発行した正しい値で上書きしてください。
「外部システムに連携」がオペレーションに表示されません
スケジュールのトリガー（「実行の予約」）を設定したオートメーションでは、「外部システムに連携」は表示されず、利用できません。