連携 ＞ 外部サービス ＞ 外部システムへの連動登録
を利用することで、ユーザーデータを登録、編集するタイミングに合わせて、外部のシステムへ情報を送信することができます。
目次
概要
MyASPの「外部システムへの連動登録」は、MyASPでユーザー登録や登録情報の変更が行われた際に、HTTP通信を利用してユーザーの登録情報を外部システムへ送信(POST)する機能です。
あらかじめ送信先のURLや送信するデータを設定しておくことで、外部システムへユーザー情報を連携して登録できます。
外部システムの仕様に合わせて、通常のフォーム形式、HTTPヘッダーを付加したフォーム形式、JSON形式から送信方式を選択できます。
１つのシナリオに複数の連携先を設定し、送信先のURLや送信するデータなどを連携先ごとに指定できます。
画面説明
外部システム連動登録の一覧
登録した連携先の設定状態を確認したり、設定内容の編集や送信順の変更などを行えます。
| 番号 | 項目名 | 詳細 |
|---|---|---|
| １ | 新規追加 | 新しい連携先の作成画面を開きます。 追加の流れは「連携先の追加・編集」項を参照してください。 |
| ２ | 番号 | 連携先の並び順を表示します。 データは、この順序で送信対象の連携先へ１件ずつ送信されます。 |
| ３ | 送信先概要 | 送信先のホスト名が表示されます。 反映タイミング「登録時」・「編集時」ごとに、それぞれの送信先を確認できます。 リンクをクリックすると、対象の設定画面を開きます。 |
| ４ | フォーム登録完了時 | 登録完了時の設定状態を表示します。 有効： 送信先のURLとデータが両方設定されています。 ※設定状態を示すもので、送信成功を示す表示ではありません。設定後は、外部システムにデータが届くことを確認してください 未設定： 送信先のURLとデータがそろっていません。 |
| ５ | ユーザー情報編集時 | ユーザー情報編集時の設定状態を表示します。 有効： 送信先のURLとデータが両方設定され、再送のチェックが入っています。 ※設定状態を示すもので、送信成功を示す表示ではありません。設定後は、外部システムにデータが届くことを確認してください 無効： 送信先のURLとデータは設定されていますが、再送のチェックが入っていません。 未設定： 送信先のURLとデータがそろっていません。 |
| ６ | 操作 | 「 」から、以下の操作を行えます。 編集： 設定内容を変更します。 複製： 設定内容をコピーし、一覧の末尾に追加します。 上に移動／下に移動： 連携先の並び順（送信順）を変更します。 変更はその場で保存されます。 削除： 確認画面で対象を確認してから削除します。 |
連携先の追加・編集
１．新しく連携先を追加したい場合は、「 新規追加」をクリックします。
登録済みの連携先を変更する場合は、編集したい「送信先概要」をクリックします。
２．連携先の詳細画面で、送信したいタイミングに応じて「フォーム登録完了時」または「ユーザー情報編集時」の、URL、送信方式、データなどを設定します。
リクエストヘッダーが必要な場合は、送信方式に合わせて入力してください。
必要な情報を入力したら設定内容を保存します。
設定を保存する際には、以下の点が正しく設定されているか確認してください。
- 設定する送信タイミング（「フォーム登録完了時」「ユーザー情報編集時」）ごとに、その欄の「URL」と「データ」がそれぞれ入力されているか
- 「URL」には、http:// または https:// で始まる送信先のURLを入力しているか
保存すると一覧へ戻ります。
新規追加した連携先は一覧の末尾に追加されます。
別の外部システムにも送信したい場合は、同じ手順で連携先を追加してください。
フォーム登録完了時
MyASPの登録フォームからユーザー登録されたタイミングで送信したい場合は、「フォーム登録完了時」に設定してください。
フォーム登録完了時に設定すると、以下のタイミングでデータが送信されます。
- 無料メルマガ、無料オファーシナリオの場合：登録完了時
- 有料商品、ショッピングカート、サブスクリプションシナリオの場合：受領処理が完了し「受領済み」になった時
参考：ユーザー一覧の検索条件の中に３種類の「状態」がありますが、それぞれどんな状態をさしていますか？
- MyASP管理画面上でユーザー登録（CSV一括登録や個別登録など）した場合も、データ送信されます。
- 他のシナリオから同時登録された場合や、メールの配信後に実行するコマンド（別シナリオへの登録）経由で登録されたユーザー情報は、データ送信されません。
設定方法
外部システムへ連動登録する場合
連携先の詳細画面で、「フォーム登録完了時」の各項目を設定します。
１．「URL」に、データを送信したい外部システムのURLを入力します。
２．外部システムの仕様に合わせて「送信方式」と「文字コード」を指定します。
リクエストヘッダーを指定する方式では、必要なヘッダー情報も入力してください。
| 番号 | 項目名 | 詳細 |
|---|---|---|
| １ | 通常のフォーム送信 | フォームデータを一般的な形式で送信します。 |
| ２ | フォーム送信＋リクエストヘッダー指定 | フォームデータに加えて、指定したHTTPヘッダー情報を付けて送信します。 |
| ３ | JSON送信＋リクエストヘッダー指定 | JSON形式のデータに、指定したHTTPヘッダー情報を付けて送信します。文字コードはUTF-8に固定されます。 |
３．「データ」に、外部システムで指定された形式にしたがって、送信するデータを入力します。
※画像は、MyASPのシナリオAからシナリオBへ登録させる場合の設定例です
４．送信結果を販売者宛の通知メールで確認したい場合は、「送信結果をメールで受信する（動作確認用）」にチェックを入れます。
５．設定内容を保存します。
一覧に戻ったら、対象の連携先の登録完了時の状態が「有効」になっていることを確認してください。
MyASPのシナリオへ送信する場合
MyASPの登録フォームでは、POST送信されたデータを取り込む仕組みが用意されています。
そのため、MyASPの別シナリオの登録フォームURLを設定することで、指定した（登録フォームのURLの）シナリオにデータを取り込むことができます。
その場合、「データ」には下図のようなフォーマットで設定します。
- データの送信先：inputタグのname属性
- MyASPから送信したい内容：対応する置き換え文字や文字列
【登録フォームのHTMLソース例】
【「データ」欄設定例】
■【設定例】
data[User][mail]=%mail%
data[User][name1]=%name1%
data[User][name2]=%name2%
data[User][tel]=%tel%MyASPの登録フォームのinputタグのname属性は、シナリオ管理メニュー ＞ 登録フォームデザイン にて、「登録フォームHTML」タブより確認できます。
※「設定値」に置き換え文字を利用することで、各ユーザーが実際に登録した値をPOSTすることが可能です。
参考：機能解説：置き換え文字
連携先システム側の注意点
「URL」には、送信したデータを直接取り込むことができるURLを指定してください。
例えば、登録先のシステムで、確認画面などを挟んでいた場合、登録することができない場合があります。
前述のMyASPの別シナリオの登録フォームにPOSTする場合には、確認画面をスキップする必要があります。
MyASPの登録フォームにて確認画面をスキップする場合は、送信先のシナリオの
シナリオ管理メニュー ＞ 登録フォーム基本設定
にて、「確認画面の表示/非表示」の『確認画面をスキップする』を選択してください。
ユーザー情報編集時
ユーザー情報の変更時に送信したい場合は、「ユーザー情報編集時」に設定してください。
ユーザー情報の変更時にデータ送信するように設定した場合、「受領済み」のユーザーのみ、以下のタイミングでデータが送信されます。
■販売者側の操作
- 「ユーザー情報編集画面」でユーザー情報を編集し、保存した時
- 「パートナー情報編集画面」でユーザー情報を編集し、保存した時
- MyASP MCP Connect（AI連携）でユーザー情報を更新した時
■ユーザーによる操作
- 「メールアドレス変更フォーム」でメールアドレスを変更した時
- 「ユーザー情報変更フォーム」でユーザー情報を変更した時
- 「会員サイト」または「パートナーサイトの個人情報編集画面」でユーザー情報を変更した時
設定方法
ユーザー情報の変更時にもデータを送信する場合は、連携先ごとに再送を有効にする必要があります。
１．新しい連携先として設定する場合は、「 新規追加」をクリックします。
登録済みの連携先を変更する場合は、編集したい「送信先概要」をクリックします。
２．ユーザー情報編集時欄の「編集（更新）のあった時に再POSTする」にチェックを入れ、送信先の「URL」、送信方式、データなどを設定します。
リクエストヘッダーが必要な場合は、送信方式に合わせて入力してください。
必要な情報を入力したら設定内容を保存します。
設定を保存する際には、以下の点が正しく設定されているか確認してください。
- 設定する送信タイミング（「フォーム登録完了時」「ユーザー情報編集時」）ごとに、その欄の「URL」と「データ」がそれぞれ入力されているか
- 「URL」には、http:// または https:// で始まる送信先のURLを入力しているか
３．一覧に戻ったら、対象の連携先のユーザー情報編集時の状態が「有効」になっていることを確認してください。
送信先のURLとデータを保存していても、再送のチェックが入っていない連携先には、ユーザー情報編集時のデータは送信されません。
注意事項
送信結果のメール受信について
ユーザー情報編集時の送信結果も、連携先の「送信結果をメールで受信する（動作確認用）」を有効にすると、メールで確認できます。
送信に失敗した場合は、チェックの有無にかかわらず通知されます。
外部システムへの反映結果は、外部システム側でも確認してください。
MyASPのシナリオに送信する場合
別シナリオの登録フォームにデータを送信するため、既存ユーザーのユーザー情報へは上書きされません。
編集後のデータが新規ユーザーとして追加登録されます。
ユーザー情報編集時にデータを送信する場合、送信先シナリオで重複登録が禁止されていると追加登録することができません。
データ編集時に追加登録を行いたい場合は、あらかじめ送信先シナリオの重複登録を許可してください。
参考：同じメールアドレスで重複登録できるようにするにはどうしたらよいでしょうか？
設定例
以下は、連携先１件分の設定例です。
複数の外部システムへ送信したい場合は、外部システム連動登録の一覧画面から連携先を追加し、それぞれの送信先に合わせて設定してください。
以下設定例に関して、APIキーやアクセストークンの取得方法など外部システム側の操作に関する質問はサポート対象外となります。
自身で調べて設定するか、連携したい外部システム側へお問い合わせください。
kintone（キントーン）
kintoneへデータ送信しレコードを新規登録するには、kintone の「REST API（データ連携のためのAPI）」や「APIトークン」の情報が必要です。
認証方式やAPIトークンの詳細は、Cybozu公式の認証に関するドキュメントをご確認ください。
例えば下記のように設定すると、ユーザーのメールアドレス（%mail%）と氏名（%name1% %name2%）をキントーンへ送信することができます。
URL：
https://{サブドメイン}.cybozu.com/k/v1/record.json
※「REST API」を入力
送信方式：
JSON送信+リクエストヘッダー指定
文字コード：
UTF-8（JSON送信のため固定）
リクエストヘッダー：
X-Cybozu-API-Token:xxx
Authorization: Bearer yyy
データ：
{
"app": 123,
"record": {
"メールアドレス": {
"value": "%mail%"
},
"氏名": {
"value": "%name1% %name2%"
}
}
}
Chatwork（チャットワーク）
Chatworkのチャットへデータ送信するには、Chatwork側の「APIトークン」と「ルームID」の情報が必要です。
Chatworkの「APIトークン」の確認方法はこちらをご覧ください。
「ルームID」の確認方法はこちらをご覧ください。
例えば下記のように設定すると、ユーザーのメールアドレス（%mail%）と氏名（%name1% %name2%）をChatworkへ送信することができます。
URL：
https://api.chatwork.com/v2/rooms/（ルームIDを入力）/messages
送信方式：
フォーム送信＋リクエストヘッダー指定
文字コード：
UTF-8
リクエストヘッダー：
accept: application/json
x-chatworktoken:（APIトークンを設定）
データ：
body=%mail%,%name1% %name2%
Discord（ディスコード）
Discordへデータ送信するには、Discord側で「Webhook URL」を作成する必要があります。
Webhook URLの作成手順
- Discordで対象のサーバーを開き、左上のサーバー名をクリックします。
- 「サーバー設定」を開きます。
- 左メニューから「連携サービス」または「Integrations」を開きます。
- 「ウェブフック」または「Webhooks」を開き、「ウェブフックを作成」または「Create Webhook」をクリックします。
- Webhook名を設定します。例：system-notify、batch-alert
- 投稿先チャンネルを選択します。例：#通知、#alerts
- 「Webhook URLをコピー」をクリックし、「Webhook URL」をコピーします。コピーしたWebhook URLは、「URL」欄に入力してください。
「Webhook URL」の作成手順はこちらも参考にしてください。
例えば下記のように設定すると、ユーザーのメールアドレス（%mail%）をDiscordへ送信することができます。
URL：
Webhook URL を入力
送信方式：
JSON送信＋リクエストヘッダー指定
文字コード：
UTF-8（JSON送信のため固定）
リクエストヘッダー：
空欄
データ：
{"content":"gaibu post renkei:%mail%"}
利用時の注意
- １件の送信が失敗しても、後続の連携先への送信処理は続行されますが、失敗した送信の自動再送は行われません。
- 外部システムへのデータ送信は、連携先へ１件ずつ順番に行われます。
連携先の数や応答にかかる時間によっては、登録完了までの待ち時間が長くなる場合があります。 - 複製した設定は、同じ送信先へ重複送信しないよう、URLやデータなどを確認してください。
よくある質問
フォーム登録完了時、ユーザー情報編集時以外でデータ送信できますか？
はい、できます。
ステップメールの「配信後に実行するコマンド」の「外部システムへの連動登録」に設定することで、ステップメールが配信されたタイミングでデータ送信することができます。
また、 紹介 ＞ パートナー ＞ パートナー設定 の「外部システム連動」でも設定ができます。
こちらは、パートナー情報を変更したときに外部システムへ変更した内容を送信することができます。
関連：機能解説：配信後に実行するコマンド
関連：画面説明：パートナー設定
1通のステップメールで複数の外部連動先を指定できますか？
できません。
本記事で説明している複数の連携先の設定は、登録フォームに関連する「フォーム登録完了時」と「ユーザー情報編集時」が対象です。
ステップメールの「配信後に実行するコマンド」を利用して複数の連携先を指定したい場合は、連携したいシステムの数だけステップメールを用意してください。
パートナー設定で複数の外部連動先を指定できますか？
できません。
本記事で説明している複数の連携先の設定は、登録フォームに関連する「フォーム登録完了時」と「ユーザー情報編集時」が対象です。