FieldPulse | ElevenLabs Documentation

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

始める前に

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

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 を選択し、修理を必要とする新規の発信者として受付担当をテストします。顧客が受付担当のコメント付きのリードとしてFieldPulseに表示されます。

新規業務用の手順を追加してください。発信者を検索し、見つからない場合は追加して、通話の詳細を記録します。

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

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