> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# FieldPulse

以下の[Webhookツール](/docs/ja/reception-ai/integrations/webhooks)を使うと、受付担当はFieldPulseにすでに登録されている発信者を特定し、新しい発信者をリードとして追加して、要件を顧客へのコメントとして残せます。その後、担当チームがフォローアップできます。

## 始める前に

FieldPulseはリクエストに応じてAPIキーを発行します。[support@fieldpulse.com](mailto:support@fieldpulse.com)またはアプリ内チャットでFieldPulseサポートに連絡し、APIキーを依頼してください。以下のすべてのツールは、APIキーを`x-api-key`リクエストヘッダーで送信します。

> **Warning**
>
> APIキーを使うと、FieldPulseのデータを読み取り、変更できます。安全に保管し、共有しないでください。

## ツールを作成する

ツールごとに、**Integrations** に移動して **Add integration** を選択し、**Webhook Tool** を選びます。次に、**Assign to agents** を **Receptionist** に設定します。

### 発信者を検索する

| フィールド         | 値                                                                        |
| ------------- | ------------------------------------------------------------------------ |
| **名前**        | `find_fieldpulse_customer`                                               |
| **説明**        | 「名前または電話番号を使って、顧客リストから発信者を検索します。業務に関する通話の開始時に使用してください。」                  |
| **メソッド**      | GET                                                                      |
| **URL**       | `https://ywe3crmpll.execute-api.us-east-2.amazonaws.com/stage/customers` |
| **リクエストヘッダー** | `x-api-key`：APIキー                                                        |
| **クエリパラメーター** | `search`（文字列、必須）：「発信者の氏名または電話番号。」                                        |

### 新しい顧客を追加する

| フィールド         | 値                                                                                                                                                                                                                                                                                                                                         |
| ------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **名前**        | `create_fieldpulse_customer`                                                                                                                                                                                                                                                                                                              |
| **説明**        | 「`find_fieldpulse_customer`で発信者が見つからなかった場合、新しい顧客として追加します。」                                                                                                                                                                                                                                                                                |
| **メソッド**      | POST                                                                                                                                                                                                                                                                                                                                      |
| **URL**       | `https://ywe3crmpll.execute-api.us-east-2.amazonaws.com/stage/customers`                                                                                                                                                                                                                                                                  |
| **リクエストヘッダー** | `x-api-key`：APIキー                                                                                                                                                                                                                                                                                                                         |
| **本文パラメーター**  | `first_name`（文字列、必須）：「発信者の名。」  `last_name`（文字列、必須）：「発信者の姓。」  `phone`（文字列、必須）：「市外局番を含む発信者の電話番号。」  `email`（文字列）：「発信者から提供された場合は、そのメールアドレス。」  `status`（文字列、必須）：「常に正確な値`lead`。」  `service_address_1`（文字列）：「作業が必要な場所の住所。」  `service_address_city`（文字列）：「その住所の市区町村。」  `service_address_state`（文字列）：「州。」  `service_address_zip_code`（文字列）：「郵便番号。」 |

### 通話の詳細を記録する

| フィールド         | 値                                                                                                                                                                                     |
| ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **名前**        | `add_fieldpulse_comment`                                                                                                                                                              |
| **説明**        | 「発信者の要件を顧客レコードへのコメントとして残します。顧客IDを取得した後に使用してください。」                                                                                                                                     |
| **メソッド**      | POST                                                                                                                                                                                  |
| **URL**       | `https://ywe3crmpll.execute-api.us-east-2.amazonaws.com/stage/comments`                                                                                                               |
| **リクエストヘッダー** | `x-api-key`：APIキー                                                                                                                                                                     |
| **本文パラメーター**  | `commentable_type`（文字列、必須）：「常に正確な値`customer`。」  `commentable_id`（数値、必須）：「`find_fieldpulse_customer`または`create_fieldpulse_customer`から取得した顧客ID。」  `text`（文字列、必須）：「発信者の要件、対応可能な時間、連絡方法。」 |

各ツールで **Enable** を選択し、修理を必要とする新規の発信者として[受付担当をテスト](/docs/ja/reception-ai/receptionist/testing)します。顧客が受付担当のコメント付きのリードとしてFieldPulseに表示されます。

> **Tip**
>
> 新規業務用の[手順](/docs/ja/reception-ai/receptionist/rules-and-procedures)を追加してください。発信者を検索し、
> 見つからない場合は追加して、通話の詳細を記録します。

## 制限事項

* ジョブにはFieldPulseアカウントのジョブタイプ、ステータス、請求情報が必要なため、受付担当はジョブを作成しません。担当チームがリードをジョブに変換します。
* 受付担当は、技術者の空き状況を確認したり、日時を予約したりできません。
* Webhookツールではリストを送信できないため、これらのツールを使って顧客にタグやカスタムフィールドを追加することはできません。

## トラブルシューティング

| 問題                   | 確認事項                                                               |
| -------------------- | ------------------------------------------------------------------ |
| FieldPulseから401が返される | ヘッダー名を`x-api-key`にし、有効なキーを設定する必要があります。                             |
| FieldPulseから400が返される | レスポンスのエラー一覧を確認してください。`status`は正確に`lead`とし、電話番号は有効なものにする必要があります。    |
| 登録済みの発信者が見つからない      | FieldPulseは保存されている情報と照合します。電話番号に加えて、発信者の名前も試してください。                |
| コメントが追加されない          | `commentable_id`は既存顧客のIDである必要があります。検索ツールまたは作成ツールが先に実行されたか確認してください。 |
| FieldPulseから429が返される | FieldPulseのリクエスト上限に達しています。しばらく待ってから、もう一度お試しください。                   |