# Facebookリードフォーム

Facebook広告でリードを獲得していますか？この統合機能を使用すると、リードが自動的に <span data-t="appName">Your AI Connector</span> に送信されるため、WhatsApp、SMS、またはその他の接続済みチャネルを通じて、手間をかけずにフォローアップを行うことができます。

この機能は、Facebookリード獲得広告を自動化プラットフォーム（Pabbly、Zapier、Makeなど）を介して <span data-t="appName">Your AI Connector</span> に接続することで機能します。これらのプラットフォームはFacebookと <span data-t="appName">Your AI Connector</span> の間のブリッジとして機能し、API（異なるソフトウェア間でデータを自動的に交換するための仕組み）を使用して、一方から他方へリード情報を渡します。

---

## 前提条件

開始する前に、以下の準備ができていることを確認してください。

- **Facebook広告マネージャ**へのアクセス権（リード広告を作成する権限が必要です）。
- 有効なAPIキーを持つ**アカウント**（**設定 → 統合 → APIキー**で生成してください。正確な手順については[APIアクセス](api-access.md)を参照してください）。
- **自動化プラットフォーム**のアカウント（Pabbly Connect、Zapier、またはMake (Integromat)）。このガイドでは例としてPabblyを使用していますが、どのプラットフォームでも手順は同様です。
- 新しいリードが追加される<span data-t="appName">Your AI Connector</span>内の**連絡先リスト**（[リストと連絡先の整理](../get-started/list-and-contact-management.md)を参照してください）。

---

## 概要

この統合は3つの段階で機能します。

1. 見込み客がFacebookリードフォームに入力します。
2. 自動化プラットフォームが新しいリードを検出し、情報を自動的に <span data-t="appName">Your AI Connector</span> に送信します（2つのAPI呼び出しを使用）。
3. <span data-t="appName">Your AI Connector</span> が連絡先を作成し、指定したリストに追加します。

その後は、割り当てたブロードキャスト、キャンペーン、またはAIエージェントが、AIによるウェルカムメッセージの送信、ステップメールの配信、あるいは手動でのフォローアップなど、残りの対応を行います。

---

## ステップ 1: Facebookリードフォームを作成する

1. **Facebook広告マネージャ**を開きます。
2. **リード**を目的とした新しいキャンペーンを作成します。
3. 広告レベルで、リード獲得方法として**インスタントフォーム**を選択します。
4. 必要なフィールドを使用してフォームを作成します。最低限、以下を含めてください。
   - **名**
   - **電話番号**（国番号付き）
   - オプション: 姓、メールアドレス
5. 広告を公開するか、テスト用にフォームを下書き保存します。

---

## ステップ 2: リードフォームをテストする

自動化を接続する前に、テストリードを送信してください。

1. 広告マネージャで、リードフォームに移動します。
2. **プレビュー**をクリックし、テストデータを使用してフォームに入力します。
3. テストリードが**Facebookリードセンター**（Facebookページの「公開ツール」内、または広告マネージャの「リード」内）に表示されることを確認します。

このテストエントリは、自動化プラットフォームでフィールドマッピングを設定する際に使用されます。

---

## ステップ 3: 自動化を設定する

### Facebookリード広告をトリガーとして接続する

1. 自動化プラットフォーム（Pabbly、Zapier、またはMake）にログインします。
2. 新しいワークフロー / シナリオ / Zapを作成します。
3. **トリガー**を「Facebook Lead Ads - New Lead（Facebookリード広告 - 新規リード）」に設定します。
4. Facebookアカウントを接続し、ページとリードフォームを選択します。
5. テストリードを取得して接続が機能していることを確認し、フィールドをマッピングします。

### APIコール1の設定：連絡先の作成

HTTP / Webhook / APIリクエストのアクションステップを追加します：

- **メソッド:** `POST`
- **URL:** `https://api.youraiconnector.com/v1/contacts?apiKey=YOUR_API_KEY`
- **ヘッダー:**
  ```
  Content-Type: application/json
  ```
- **ボディ (JSON):**
  ```json
  {
    "firstName": "{{first_name}}",
    "lastName": "{{last_name}}",
    "phone": "{{phone_number}}",
    "email": "{{email}}"
  }
  ```

`{{placeholders}}`を、トリガー手順からの実際のフィールドマッピングに置き換えます。

::: warning
**重要:** 電話番号には国番号を含める必要があります（例: 米国の場合は `+1`、オランダの場合は `+31`）。リードフォームで国番号なしの電話番号を収集している場合は、自動化プロセスに国番号を先頭に付加するフォーマット手順を追加してください。
:::


APIレスポンスは、新しい連絡先のIDを `data.contactId` で返します。この値を保存してください。次のステップで必要になります。

> **2回目の呼び出しは省略可能です。** `POST /v1/contacts` は、作成リクエストの本文で `listId`（1つのリスト）または `listIds`（複数のリスト）を受け入れることもでき、同じリクエストで新しい連絡先をそれらのリストに追加できます。以下の2ステップの手順は、自動化プラットフォームがどのリストを使用するかを決定する前に連絡先が存在している必要がある場合にのみ使用してください。

### APIコール2の設定：リストへの連絡先の追加

2番目のアクションステップを追加します：

- **メソッド:** `POST`
- **URL:** `https://api.youraiconnector.com/v1/contacts/lists?apiKey=YOUR_API_KEY`
- **ヘッダー:**
  ```
  Content-Type: application/json
  ```
- **ボディ (JSON):**
  ```json
  {
    "contactId": "{{contact_id_from_previous_step}}",
    "listId": "YOUR_LIST_ID"
  }
  ```

`YOUR_LIST_ID` を実際の連絡先リストのID（以下の [リストIDの確認方法](#finding-your-list-id) を参照）に置き換え、`contactId` を最初のAPI呼び出しで返された `data.contactId` にマッピングします。

---

## リストIDの確認方法

1. Your AI Connector で **連絡先** をクリックし、**リスト** タブを選択します。
2. 対象のリストの横にある行メニュー（"⋯"）を開き、**リストIDをコピー** をクリックします。

リストページの完全な操作ガイドについては、[リストと連絡先の整理](../get-started/list-and-contact-management.md)を参照してください。

---

## ステップ 4: 全ワークフローのテスト

1. Facebookフォームから別のテストリードを送信します（または、自動化プラットフォームで既存のテストリードを再実行します）。
2. Your AI Connector を確認して、以下が正しく行われたか確認します：
   - 正しい名前、電話番号、メールアドレスで **連絡先** が作成されていること。
   - 連絡先が **正しいリストに追加されている** こと。
3. そのリストに対して自動的にメッセージを送信するように設定されたブロードキャスト、キャンペーン、またはAIエージェントがある場合は、期待通りにトリガーされることを確認します。

---

## データリファレンス

統合中に送受信されるデータの例を以下に示します。

### 連絡先の作成 - リクエスト

```json
POST <span data-t="apiBaseUrl">https://api.youraiconnector.com</span>/v1/contacts?apiKey=YOUR_API_KEY

{
  "firstName": "Jane",
  "lastName": "Smith",
  "phone": "+15551234567",
  "email": "jane@example.com"
}
```

### 連絡先の作成 - レスポンス

```json
{
  "success": true,
  "data": {
    "message": "Successfully created new contact",
    "contactId": "abc123xyz",
    "listsAdded": []
  }
}
```

### リストへの連絡先追加 - リクエスト

```json
POST <span data-t="apiBaseUrl">https://api.youraiconnector.com</span>/v1/contacts/lists?apiKey=YOUR_API_KEY

{
  "contactId": "abc123xyz",
  "listId": "LIST_ID"
}
```

---

## ヒント

- **重複の処理:** 同じ電話番号を持つ連絡先が既に存在する場合、作成呼び出しは `{"success": false, "error_code": 409}` を返し、既存の連絡先は返しません。リストへの追加呼び出しの前に、`error_code`（HTTPステータスが200の場合）で分岐し、`GET /v1/contacts?phoneNumber=...` を使用して連絡先を検索してください。
- **複数のフォーム:** リードフォームごとに個別の自動化ワークフローを作成し、それぞれ異なるリストと、異なるブロードキャスト、キャンペーン、またはAIエージェントをターゲットにします。
- **エラー通知:** API呼び出しが失敗した場合に通知されるように自動化プラットフォームを設定し、リードの損失を防ぎます。

---

## 次のステップ

- [キャンペーンからブロードキャスト＆エージェントへの移行](../moving-from-campaigns.md) — 新規リードに自動でメッセージを送信する設定を行います。
- [APIアクセス](api-access.md) — 高度な統合のための完全なAPIドキュメントです。
- [Webhook](webhooks.md) — コンタクトの作成やタグ付け時に通知を受け取ります。