> 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

아래 [웹훅 도구](/docs/ko/reception-ai/integrations/webhooks)를 사용하면 리셉셔니스트가 이미 FieldPulse에 등록된 발신자를 식별하고, 새 발신자를 리드로 추가하며, 고객에게 필요한 내용을 댓글로 남겨 팀에서 후속 조치를 할 수 있습니다.

## 시작하기 전에

FieldPulse는 요청 시 API 키를 발급합니다. [support@fieldpulse.com](mailto:support@fieldpulse.com)으로 FieldPulse 지원팀에 문의하거나 앱 내 채팅을 통해 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/ko/reception-ai/receptionist/testing)하세요. 고객은 리셉셔니스트의 댓글과 함께 FieldPulse에 리드로 표시됩니다.

> **Tip**
>
> 새 작업을 위한 [절차](/docs/ko/reception-ai/receptionist/rules-and-procedures)를 추가하세요. 발신자를 찾고,
> 찾지 못하면 추가한 후 통화 세부 정보를 기록합니다.

## 제한 사항

* 작업에는 FieldPulse 계정의 작업 유형, 상태, 청구 세부 정보가 필요하므로 리셉셔니스트가 작업을 생성하지 않습니다. 팀에서 리드를 작업으로 전환합니다.
* 리셉셔니스트는 기술자의 가능 시간을 확인하거나 시간을 예약할 수 없습니다.
* 웹훅 도구는 목록을 전송할 수 없으므로, 이 도구로는 고객에게 태그나 사용자 지정 필드를 추가할 수 없습니다.

## 문제 해결

| 문제                  | 확인할 사항                                                           |
| ------------------- | ---------------------------------------------------------------- |
| FieldPulse에서 401 반환 | 헤더 이름은 `x-api-key`여야 하며, 현재 유효한 키를 포함해야 합니다.                     |
| FieldPulse에서 400 반환 | 응답의 오류 목록을 확인하세요. `status`는 정확히 `lead`여야 하며 전화번호는 유효해야 합니다.      |
| 등록된 발신자를 찾을 수 없음    | FieldPulse는 저장된 값을 기준으로 일치시킵니다. 발신자의 전화번호와 함께 이름도 시도해 보세요.       |
| 댓글이 추가되지 않음         | `commentable_id`는 기존 고객의 ID여야 합니다. 찾기 또는 생성 도구가 먼저 실행되었는지 확인하세요. |
| FieldPulse에서 429 반환 | FieldPulse의 요청 한도에 도달했습니다. 기다린 후 다시 시도하세요.                       |