全体の流れ
- 配信アカウントを作成
- シナリオを作成
- ファネル・ステップを作成
- フォーム付きLPページを作成
- サンクスページを作成
1. 配信アカウントを作成
フォーム登録先となる配信アカウントを作成します。curl -X POST "https://api.utage-system.com/v1/accounts" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "メルマガ配信",
"type": "mail"
}'
レスポンス
{
"data": {
"id": "ac_abc123",
"name": "メルマガ配信",
"type": "mail"
}
}
type にはメール配信なら mail、LINE配信なら line、両方なら mail_line を指定します。2. シナリオを作成
配信アカウント内にシナリオを作成します。シナリオはステップメール等の配信シーケンスを管理する単位です。curl -X POST "https://api.utage-system.com/v1/accounts/ac_abc123/scenarios" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"title": "無料メール講座"
}'
レスポンス
{
"data": {
"id": "sc_def456",
"title": "無料メール講座",
"open_title": null,
"created_at": "2026-01-01 10:00:00"
}
}
3. ファネル・ステップを作成
LP用とサンクスページ用の2つのステップを含むファネルを作成します。# ファネル作成
curl -X POST "https://api.utage-system.com/v1/funnels" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"name": "メルマガ登録ファネル"}'
レスポンス
{
"data": {
"id": "fn_abc123",
"name": "メルマガ登録ファネル",
"created_at": "2026-01-01 10:00:00",
"updated_at": "2026-01-01 10:00:00"
}
}
# LP用ステップ作成
curl -X POST "https://api.utage-system.com/v1/funnels/fn_abc123/steps" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"name": "登録ページ"}'
レスポンス
{
"data": {
"id": "st_step01",
"name": "登録ページ",
"order": 1
}
}
# サンクスページ用ステップ作成
curl -X POST "https://api.utage-system.com/v1/funnels/fn_abc123/steps" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"name": "サンクスページ"}'
レスポンス
{
"data": {
"id": "st_step02",
"name": "サンクスページ",
"order": 2
}
}
4. フォーム付きLPページを作成
フォーム要素を含むページを作成します。フォーム関連の要素タイプは、要素タイプ一覧API(GET /element-types/funnel?include=form)で取得できます。
フォーム要素タイプの確認
curl -X GET "https://api.utage-system.com/v1/element-types/funnel?include=form" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json"
カスタムフォームの構成
入力欄(form-input)と送信ボタン(form-button)を、他のコンテンツ要素と同じように col の直下に並べます。入力欄は必要な数だけ配置でき、登録先のシナリオは送信ボタンの scenario_id で指定します。
section > row > col
├── form-input (item=name: お名前入力欄)
├── form-input (item=mail: メールアドレス入力欄)
└── form-button (action=form: 送信ボタン。scenario_id で登録先シナリオを指定)
form-button には action: "form" と登録先の scenario_id を指定してください。form-input の scenario_id は item=scenario(シナリオの読者項目を入力欄にする場合)にだけ使います。定型の「登録フォーム」要素(
form)を使う場合は、scenario_id・content(ボタンテキスト)・button_color を form 要素自身のプロパティで指定します。form 要素に children は指定しないでください(公開ページには描画されません)。ページ作成
ヘッダーテキスト + カスタムフォームの構成でLPを作成します。curl -X POST "https://api.utage-system.com/v1/funnels/fn_abc123/steps/st_step01/pages" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"title": "メルマガ登録LP",
"page_title": "無料メール講座|3日間で学ぶマーケティング入門",
"pc_width": 800,
"elements": [
{
"type": "section",
"background_color": "#1a1a2e",
"padding_top": 60,
"padding_bottom": 60,
"children": [
{
"type": "row",
"children": [
{
"type": "col",
"children": [
{
"type": "text",
"content": "<h1 style=\"text-align: center; color: #ffffff;\">無料メール講座</h1><p style=\"text-align: center; color: #cccccc;\">3日間で学ぶマーケティング入門</p>"
}
]
}
]
}
]
},
{
"type": "section",
"padding_top": 40,
"padding_bottom": 40,
"children": [
{
"type": "row",
"children": [
{
"type": "col",
"children": [
{
"type": "text",
"content": "<h2 style=\"text-align: center;\">今すぐ無料で受講する</h2><p style=\"text-align: center;\">メールアドレスを入力して登録ボタンを押してください</p>"
}
]
}
]
}
]
},
{
"type": "section",
"padding_top": 20,
"padding_bottom": 60,
"children": [
{
"type": "row",
"children": [
{
"type": "col",
"children": [
{
"type": "form-input",
"item": "name",
"input_type": "text",
"label": "お名前",
"required": 1
},
{
"type": "form-input",
"item": "mail",
"input_type": "email",
"label": "メールアドレス",
"required": 1
},
{
"type": "form-button",
"action": "form",
"scenario_id": "sc_def456",
"content": "無料で受講する",
"button_color": "btn-red"
}
]
}
]
}
]
}
]
}'
レスポンス
{
"data": {
"id": "pg_form01",
"title": "メルマガ登録LP",
"content_type": "elements",
"pc_width": 800,
"step_url": "https://utage-system.com/p/xxxxx",
"page_url": "https://utage-system.com/page/pg_form01"
}
}
カスタムフォームの要素
| 要素タイプ | 説明 |
|---|---|
form-input | 入力欄。item(name / mail / phone / kana / zipcode 等)と input_type(text / email / tel 等)は必須。label・placeholder・required(0/1)等も指定可 |
form-button | 送信ボタン。action(必須。登録フォームは form)と content(ボタンテキスト。必須)、scenario_id(登録先シナリオ)、button_color(テーマ。btn-red / btn-green 等)を指定 |
入力欄・送信ボタンで利用可能なプロパティの詳細は、要素プロパティAPIで
types=form-input,form-button を指定して取得できます。5. サンクスページを作成
フォーム登録後に表示されるサンクスページを、次のステップとして作成します。curl -X POST "https://api.utage-system.com/v1/funnels/fn_abc123/steps/st_step02/pages" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"title": "サンクスページ",
"page_title": "ご登録ありがとうございます",
"pc_width": 800,
"elements": [
{
"type": "section",
"padding_top": 80,
"padding_bottom": 80,
"children": [
{
"type": "row",
"children": [
{
"type": "col",
"children": [
{
"type": "text",
"content": "<h1 style=\"text-align: center;\">ご登録ありがとうございます</h1><p style=\"text-align: center;\">ご入力いただいたメールアドレスに確認メールをお送りしました。<br>メールに記載の手順に従って受講を開始してください。</p>"
}
]
}
]
}
]
}
]
}'
レスポンス
{
"data": {
"id": "pg_thanks01",
"title": "サンクスページ",
"content_type": "elements",
"pc_width": 800,
"step_url": "https://utage-system.com/p/yyyyy",
"page_url": "https://utage-system.com/page/pg_thanks01"
}
}
完成したファネル構造
メルマガ登録ファネル (fn_abc123)
├── 登録ページ (st_step01)
│ └── メルマガ登録LP (pg_form01) ← カスタムフォーム付き
└── サンクスページ (st_step02)
└── サンクスページ (pg_thanks01)
step_url にアクセスすると、フォーム付きLPが表示されます。フォームからの登録完了後、送信ボタンの scenario_id に指定したシナリオ「無料メール講座」の配信が開始されます。
次のステップ
エラーハンドリング
エラーの種類と対処方法
APIリファレンス
全エンドポイントの詳細仕様