탐색으로 건너뛰기
통합설정 가이드현장 서비스

JobNimbus

웹훅 도구로 새 발신자를 JobNimbus에 리드로 추가하세요.

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

시작하기 전에

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

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

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

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

도구 만들기

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

필드값
이름create_jobnimbus_contact
설명”발신자가 작업을 요청하고 이전에 서비스를 이용한 적이 없다면 CRM에 새 리드로 추가합니다.”
메서드POST
URLhttps://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을 선택한 다음 지붕 점검이 필요한 새 발신자로 리셉셔니스트를 테스트하세요. 연락처가 리드 상태로 JobNimbus에 표시됩니다.

발신자를 추가하기 전에 전체 주소를 수집하도록 리셉셔니스트에게 지시하는 절차를 추가하세요.

제한 사항

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

이메일로 발신자를 조회하고 해당 연락처에 연결된 작업을 만들려면 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에 연락처 생성 권한이 없습니다. 가능한 프로필로 새 키를 만드세요.
연락처에 주소가 없음발신자를 추가하기 전에 전체 주소를 묻도록 설명에 리셉셔니스트 지침을 작성하세요.