> 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.

# JobNimbus

아래 [웹훅 도구](/docs/ko/reception-ai/integrations/webhooks)를 사용하면 리셉셔니스트가 새 발신자를 리드 워크플로의 연락처로 JobNimbus에 추가할 수 있습니다. 전화번호, 주소, 필요한 작업 내용을 함께 기록하므로 팀에서 후속 조치를 할 수 있습니다.

## 시작하기 전에

1. JobNimbus에서 오른쪽 상단의 프로필 아이콘을 선택한 다음 **Settings** → **API**로 이동하여 새 API 키를 만듭니다.
2. 연락처를 생성할 수 있고 필요한 수준을 넘는 권한은 없는 **Access Profile**을 선택합니다. 키는 생성 당시 해당 프로필에 있던 권한을 유지합니다.
3. **Key ID**가 아닌 전체 API 키를 복사합니다. JobNimbus에서는 한 번만 표시됩니다.

이 도구는 `Authorization` 요청 헤더에서 `Bearer YOUR_API_KEY` 형식으로 키를 전송합니다.

> **Warning**
>
> API 키로 JobNimbus 데이터에 접근할 수 있습니다. 안전하게 보관하고 공유하지 마세요. 새 키는
> 1년 후 만료되므로, 그전에 교체 키를 만드세요.

또한 JobNimbus 설정에 표시된 그대로, 새 리드가 들어갈 연락처 워크플로와 상태의 정확한 이름이 필요합니다. 예: `Customer`, `Lead`.

## 도구 만들기

**Integrations**로 이동하여 **Add integration**을 선택하고 **Webhook Tool**을 선택한 다음, 아래 필드를 입력합니다.

| 필드           | 값                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| ------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **이름**       | `create_jobnimbus_contact`                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| **설명**       | "발신자가 작업을 요청하고 이전에 서비스를 이용한 적이 없다면 CRM에 새 리드로 추가합니다."                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| **메서드**      | POST                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| **URL**      | `https://app.jobnimbus.com/api1/contacts`                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| **요청 헤더**    | `Authorization`: `Bearer YOUR_API_KEY`                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| **본문 매개변수**  | `first_name` (문자열, 필수): "발신자의 이름."  `last_name` (문자열, 필수): "발신자의 성."  `record_type_name` (문자열, 필수): "항상 정확히 `Customer` 값으로 설정합니다."  `status_name` (문자열, 필수): "항상 정확히 `Lead` 값으로 설정합니다."  `mobile_phone` (문자열, 필수): "발신자의 전화번호. 숫자만 입력합니다."  `email` (문자열): "발신자가 제공한 경우 이메일 주소."  `address_line1` (문자열): "작업이 필요한 곳의 도로명 주소."  `city` (문자열): "해당 주소의 도시."  `state_text` (문자열): "2자리 코드로 된 주."  `zip` (문자열): "우편번호."  `description` (문자열, 필수): "발신자에게 필요한 작업, 가능한 시간 및 그 밖에 알려준 모든 내용." |
| **에이전트에 할당** | **Receptionist**                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |

`Customer` 및 `Lead`를 자체 워크플로와 상태 이름으로 바꾸세요.

**Enable**을 선택한 다음 지붕 점검이 필요한 새 발신자로 [리셉셔니스트를 테스트](/docs/ko/reception-ai/receptionist/testing)하세요. 연락처가 리드 상태로 JobNimbus에 표시됩니다.

> **Tip**
>
> 발신자를 추가하기 전에 전체 주소를 수집하도록 리셉셔니스트에게 지시하는 [절차](/docs/ko/reception-ai/receptionist/rules-and-procedures)를
> 추가하세요.

## 제한 사항

* JobNimbus 연락처를 검색하려면 JSON 검색 필터가 필요하므로, 이 도구로는 발신자를 조회할 수 없습니다. 재방문 발신자가 두 번 추가될 수 있습니다.
* 작업, 태스크, 메모는 중첩 필드를 통해 연락처에 연결되며 웹훅 도구는 이를 전송할 수 없습니다. 대신 연락처 설명에 통화 세부 정보가 저장됩니다.

이메일로 발신자를 조회하고 해당 연락처에 연결된 작업을 만들려면 [Zapier](/docs/ko/reception-ai/integrations/zapier)를 통해 JobNimbus의 **Find Contact by Email**, **Create Contact**, **Create Job** 작업을 사용하세요.

## 문제 해결

| 문제                        | 확인 사항                                                                   |
| ------------------------- | ----------------------------------------------------------------------- |
| JobNimbus에서 401 또는 403 반환 | 헤더 값은 **Key ID**가 아닌 전체 API 키 앞에 `Bearer`를 붙여야 합니다. 키가 만료되지 않았는지 확인하세요. |
| 워크플로 또는 상태 관련 오류          | `record_type_name` 및 `status_name`은 연락처 워크플로와 그 상태 중 하나와 정확히 일치해야 합니다.  |
| 권한 메시지와 함께 403 반환         | 키의 **Access Profile**에 연락처 생성 권한이 없습니다. 가능한 프로필로 새 키를 만드세요.             |
| 연락처에 주소가 없음               | 발신자를 추가하기 전에 전체 주소를 묻도록 설명에 리셉셔니스트 지침을 작성하세요.                           |