# 워크플로우 액션 – 객체 레코드 찾기 / 회사 찾기

**목차**

* [개요](#개요)
* [액션 이름](#액션-이름)
* [액션 설명](#액션-설명)
* [액션 세부사항](#액션-세부사항)
* [예시](#예시)

## 개요

객체 레코드 찾기(Find Object Record) 액션은 인바운드 웹훅(Inbound Webhook) 트리거의 값을 사용하여 CRM에서 특정 커스텀 객체 레코드를 검색합니다. 웹훅 페이로드의 필드를 객체 필드에 매핑하는 방식으로 작동합니다. 워크플로우가 이미 동일한 객체로 시작되는 트리거를 가지고 있다면 이 단계는 건너뜁니다.

이 액션은 회사 기반 워크플로우에서는 회사 찾기(Find Company)로도 사용할 수 있으며, 웹훅 값(예: companyName, domain)을 사용하여 회사 레코드를 찾을 수 있습니다.

## 액션 이름

* **객체 레코드 찾기(Find Object Record)** (커스텀 객체 워크플로우용)
* **회사 찾기(Find Company)** (회사 기반 워크플로우용)

## 액션 설명

이 액션의 용도:

* **웹훅 매개변수를 객체/회사 필드에 매핑**하여 필터에서 레코드(커스텀 객체 또는 회사)를 조회합니다.
* \*\*타이브레이커(tie-breaker)\*\*를 사용하여 여러 일치 결과를 해결합니다(가장 빨리 생성됨 / 가장 최근에 생성됨).
* **레코드 찾음** vs **레코드를 찾지 못함**으로 분기하여 명확하고 결정적인 흐름을 만듭니다.

**전제 조건**: 워크플로우에 인바운드 웹훅 트리거가 있어야 합니다. 이 액션은 해당 트리거의 페이로드(본문, 헤더)에서 값을 읽어옵니다.

## 액션 세부사항

![객체 레코드 찾기 액션 설정 화면](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155054908432/original/septxq0_2MS-iQ7j_xfo58ENs5aLj5gNng.png?1759229495)

![객체 레코드 찾기 액션 필터 설정](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155054908468/original/hECJ8s0IdoP0_9Zgyu9ZgWa57IsFUGlD3Q.jpeg?1759229520)

### I. 인바운드 웹훅 필수

* 워크플로우에 인바운드 웹훅 트리거가 포함된 경우에만 활성화됩니다.
* 해당 트리거의 페이로드에서 값을 가져옵니다(예: {{inboundWebhookRequest.body.petname}}, {{inboundWebhookRequest.body.domain}}).

### II. **필터 기준 (타이브레이커)**

여러 레코드가 일치할 때 하나를 선택하는 방법을 선택합니다: • 가장 빨리 생성된 레코드(Earliest Created Record) • **가장 최근에 생성된 레코드(Latest Created Record)**

### III. **필터 (AND 논리)**

* 하나 이상의 행을 추가합니다. 모든 필터는 AND 논리를 사용합니다.
* **왼쪽**: 일치시킬 객체/회사 필드(예: 레코드 ID, 외부 ID, VIN, 펫 이름, 회사명, 도메인).
* **오른쪽 (값)**: 인바운드 웹훅 트리거에서 필드를 선택(본문, 헤더) 하거나 고정 값을 입력합니다.
* **팁**: • 결정적인 결과를 위해 고유 식별자(레코드 ID, 외부 ID, 도메인)를 우선 사용하세요. • 모호한 일치를 피하기 위해 추가 필터(상태, 위치, 유형)를 추가하세요.

### IV. **결과**

* **레코드 찾음**: 일치하는 객체가 하위 액션(업데이트, 연결, 삭제 등)의 **현재 레코드**가 됩니다.
* **레코드를 찾지 못함**: 이 분기를 사용하여 새 레코드를 생성하거나, 사용자에게 알리거나, 플로우를 중단할 수 있습니다.

### V. **건너뛰기 동작**

* 워크플로우가 이미 트리거와 동일한 객체로 시작하는 경우(예: "자동차 생성됨" 또는 "회사 생성됨"), 이 단계는 자동으로 건너뜁니다.

### VI. **모범 사례**

* 웹훅에서 깨끗하고 유형이 지정된 값(문자열/숫자/불린)을 보내도록 합니다.
* 이름으로 일치시키는 경우 소스 시스템에서 대소문자/공백을 정규화합니다.
* 라이브로 전환하기 전에 스테이징 워크플로우에서 샘플 페이로드로 테스트하세요.

## 예시

#### 예시 1: 이름으로 펫 찾기 (웹훅 → 조회)

**목표**: 웹훅에서 petname = "snowy"를 전송. 해당 이름의 Pet 객체를 찾기.

**설정**

* 필터 기준: 가장 빨리 생성된 레코드
* 필터: Pet Name = {{inboundWebhookRequest.body.petname}}

**플로우**

* 인바운드 웹훅이 { "petname": "snowy" }로 트리거됩니다.
* 액션이 Pet Name이 "snowy"인 Pet을 찾습니다.
* **레코드 찾음**: Pet 상태를 업데이트하고 주인에게 알림을 보냅니다.
* **레코드를 찾지 못함**: 이름이 "snowy"인 Pet 레코드를 생성하고 검토용 태그를 추가합니다.

#### 예시 2: 외부 참조로 구독 찾기

**목표**: 결제 웹훅에서 subscription\_ref를 전송. 해당 Subscription 객체를 찾기.

**설정**

* 필터 기준: 가장 최근에 생성된 레코드
* 필터: External Reference = {{inboundWebhookRequest.body.subscription\_ref}} Status = active (선택적 안전 필터)

**플로우**

* subscription\_ref와 함께 웹훅이 도착합니다.
* 액션이 해당 참조를 가진 가장 최근의 활성 구독을 선택합니다.
* **레코드 찾음**: 플랜 필드를 업데이트하고 갱신 이메일을 대기열에 추가합니다.
* **레코드를 찾지 못함**: 플레이스홀더 구독을 생성하고 재무팀에 알림을 보냅니다.

#### 예시 3: 도메인으로 회사 찾기

**목표**: 리드 생성 폼의 웹훅에서 companyDomain을 전달. 해당 도메인의 회사 레코드를 찾기.

**설정**

* 필터 기준: 가장 최근에 생성된 레코드
* 필터: Domain = {{inboundWebhookRequest.body.companyDomain}}

**플로우**

* 인바운드 웹훅이 { "companyDomain": "acme.com" }으로 트리거됩니다.
* 액션이 Domain이 "acme.com"인 회사를 찾습니다.
* **레코드 찾음**: 회사를 "온보딩" 워크플로우에 등록합니다.
* **레코드를 찾지 못함**: 도메인이 "acme.com"인 새 회사 레코드를 생성합니다.

***

*원문 최종 수정: Mon, 13 Oct, 2025 at 3:31 AM* *Hyperclass 사용 가이드 — hyperclass.ai*


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://hyperclass.gitbook.io/hyperclass-docs/workflows/workflow-action-find-object-record-find-company.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.