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

FieldPulse

웹훅 도구로 FieldPulse 고객을 찾거나 추가하고 통화 세부 정보를 기록하세요.

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

시작하기 전에

FieldPulse는 요청 시 API 키를 발급합니다. support@fieldpulse.com으로 FieldPulse 지원팀에 문의하거나 앱 내 채팅을 통해 API 키를 요청하세요. 아래의 모든 도구는 x-api-key 요청 헤더로 이 키를 전송합니다.

API 키는 FieldPulse 데이터를 읽고 변경할 수 있습니다. 안전하게 보관하고 공유하지 마세요.

도구 만들기

각 도구에서 Integrations로 이동해 Add integration을 선택하고, Webhook Tool을 선택한 다음 Assign to agents를 Receptionist로 설정하세요.

발신자 찾기

필드값
이름find_fieldpulse_customer
설명”이름 또는 전화번호로 고객 목록에서 발신자를 찾습니다. 작업 관련 통화가 시작될 때 사용하세요.”
메서드GET
URLhttps://ywe3crmpll.execute-api.us-east-2.amazonaws.com/stage/customers
요청 헤더x-api-key: API 키
쿼리 매개변수search (문자열, 필수): “발신자의 전체 이름 또는 전화번호입니다.”

새 고객 추가

필드값
이름create_fieldpulse_customer
설명”find_fieldpulse_customer로 발신자를 찾지 못했을 때 새 고객으로 추가합니다.”
메서드POST
URLhttps://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
URLhttps://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 계정의 작업 유형, 상태, 청구 세부 정보가 필요하므로 리셉셔니스트가 작업을 생성하지 않습니다. 팀에서 리드를 작업으로 전환합니다.
  • 리셉셔니스트는 기술자의 가능 시간을 확인하거나 시간을 예약할 수 없습니다.
  • 웹훅 도구는 목록을 전송할 수 없으므로, 이 도구로는 고객에게 태그나 사용자 지정 필드를 추가할 수 없습니다.

문제 해결

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