# 커스텀 객체 및 회사 기반 워크플로우 액션과 트리거

Hyperclass의 커스텀 객체 및 회사 기반 워크플로우 액션과 트리거를 사용하면 연락처, 회사, 커스텀 객체 간의 자동화가 가능해집니다. 이 도구들로 연관된 레코드를 다른 워크플로우에 등록하거나 제거하고, 웹훅 데이터나 필드 필터를 통해 정확한 레코드를 찾을 수 있어요.

***

## 커스텀 객체 및 회사 기반 워크플로우 액션과 트리거란?

Hyperclass 워크플로우는 레코드 간의 관계(연관성)를 이해하는 액션을 지원합니다. 워크플로우를 트리거한 레코드만 자동화하는 것이 아니라, 연관된 연락처, 회사 또는 커스텀 객체를 대상으로 하고 ID, 외부 ID, 또는 필드 조건을 사용해 정확한 레코드를 찾을 수 있어요. 이를 통해 데이터 인식 기반의 관계 중심 자동화가 가능합니다.

각 워크플로우 액션에 대한 자세한 정보는 다음 문서들을 참고하세요!

* [워크플로우 액션 - 연관된 레코드를 워크플로우에 추가](/hyperclass-docs/workflows/workflow-action-add-associated-records-to-workflow.md)
* [워크플로우 액션 - 워크플로우에서 연관된 레코드 제거](/hyperclass-docs/workflows/workflow-action-remove-associated-records-from-workflow.md)
* [워크플로우 액션 - 객체 레코드 찾기 / 회사 찾기](/hyperclass-docs/workflows/workflow-action-find-object-record-find-company.md)

***

## 커스텀 객체 및 회사 기반 워크플로우 액션과 트리거의 주요 장점

* **더 깊은 자동화**: 수동 단계 없이 연락처, 회사, 커스텀 객체 전반에 걸쳐 작동하는 플로우를 구축할 수 있어요.
* **관계 타겟팅**: 연관성 라벨(Association Label)로 필터링하여 의도한 정확한 관련 레코드에 도달할 수 있습니다.
* **정밀한 레코드 조회**: 찾기(Find)를 사용해 레코드 ID, 외부 ID, 또는 동적 인바운드 웹훅 값을 포함한 필드 필터로 매칭할 수 있어요.
* **분기 로직**: 레코드 발견됨 vs 레코드 발견되지 않음으로 동작을 분기하고, 여러 매치가 있을 때 최초/최신/모두 중에서 선택할 수 있습니다.
* **운영 제어**: 연관된 레코드를 다른 워크플로우에 추가하거나 제거하여 완벽한 타이밍에 커뮤니케이션이나 프로세스를 시작/중지할 수 있어요.

***

## 연관된 레코드를 워크플로우에 추가

현재 레코드가 관련 레코드(연락처, 회사 또는 커스텀 객체)를 **다른** 워크플로우에 등록하도록 트리거해야 할 때 이 액션을 사용하세요. **연관성 라벨**로 필터링하면 타겟팅이 더욱 정확해집니다.

이 액션으로 다음을 할 수 있어요:

* 연관된 **객체 타입**(연락처, 회사 또는 커스텀 객체) 선택
* **연관성 라벨**(예: 구매자, 계정 소유자, 배정된 딜러)로 수신자 필터링
* 해당 연관된 레코드들이 추가될 **대상 워크플로우** 선택

예시: 자동차(커스텀 객체)가 "판매 준비"로 업데이트될 때, 연관된 모든 딜러를 "딜러 알림 워크플로우"에 자동으로 추가합니다.

자세한 내용은 [**연관된 레코드를 워크플로우에 추가**](/hyperclass-docs/workflows/workflow-action-add-associated-records-to-workflow.md) 문서를 참고하세요.

![연관된 레코드를 워크플로우에 추가](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155055982231/original/AX6w1FMXLsFnp6FBnWQPXGfMGuHpHbj_Hw.png?1760455574)

***

## 워크플로우에서 연관된 레코드 제거

조건이 변경될 때(예: 판매됨/마감됨) 연관된 레코드를 다른 워크플로우에서 자동으로 **등록 해제**하려면 이 액션을 사용하세요. 이를 통해 연락처와 다른 레코드들이 더 이상 필요하지 않은 시퀀스에서 제외되도록 할 수 있어요.

이 액션으로 다음을 할 수 있어요:

* **연관성을 통해** 연락처, 회사 또는 커스텀 객체를 타겟팅
* 특정 **연관성 라벨**로 필터링하여 의도된 관계만 제거
* 제거할 **워크플로우** 지정

예시: 부동산 레코드가 "판매됨"으로 표시될 때, 연관된 구매자들을 "활성 매물 워크플로우"에서 제거하여 추가 알림을 중단합니다.

자세한 내용은 [워크플로우에서 연관된 레코드 제거](/hyperclass-docs/workflows/workflow-action-remove-associated-records-from-workflow.md) 문서를 참고하세요.

![워크플로우에서 연관된 레코드 제거](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155055982982/original/odUhBST3aSWV803cf8vyIOAIR8N02ITH0A.png?1760455950)

***

## 객체 레코드 찾기 / 회사 찾기

**찾기**를 사용하여 **레코드 ID, 외부 ID 또는 필드 필터**를 통해 기존 레코드를 찾으세요. **인바운드 웹훅**에서 동적 값을 전달할 수 있어요. 여러 매치를 처리하는 방법을 선택하고 **레코드 발견됨** vs **레코드 발견되지 않음**으로 분기할 수 있습니다.

이 액션으로 다음을 할 수 있어요:

* 레코드 ID, **외부 ID** 또는 **필드 기반 필터**로 매칭
* 인바운드 웹훅 트리거의 동적 값 지원 (예: {{inboundWebhookRequest.body.subscription\_ref}})
* 여러 매치 처리 방법 선택 — 최초, 최신 또는 모두
* 레코드 발견됨 vs 레코드 발견되지 않음 시나리오에 대한 자동 분기 로직

예시: 웹훅이 { "companyDomain": "acme.com" }을 전송할 때, 매칭되는 회사 레코드를 찾아 워크플로우에 등록합니다.

자세한 내용은 [객체 레코드 찾기 / 회사 찾기](/hyperclass-docs/workflows/workflow-action-find-object-record-find-company.md) 문서를 참고하세요.

![객체 레코드 찾기 / 회사 찾기](https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/155055984482/original/cVSxwpd01NoZN1ZrY4zwoUzB5MrAjFo88Q.jpeg?1760456626)

***

## 자주 묻는 질문

**Q: "워크플로우에 추가"와 "연관된 레코드를 워크플로우에 추가"의 차이점은 무엇인가요?** "워크플로우에 추가"는 현재 레코드 타입을 등록합니다. "연관된 레코드를 워크플로우에 추가"는 연관성을 통해 현재 레코드에 연결된 다른 레코드들을 선택된 라벨로 필터링하여 등록합니다.

**Q: 한 번에 여러 연관성 라벨을 타겟팅할 수 있나요?** 액션당 하나의 라벨을 사용하세요. 여러 라벨이 필요하다면 포함하려는 각 라벨에 대해 다른 연관된 레코드 추가/제거 액션을 추가하세요.

**Q: 최초/최신/모두가 찾기 결과에 어떤 영향을 주나요?** 최초 또는 최신은 단일 최적 매치로 진행합니다. 모두는 매칭되는 각 레코드에 다운스트림 경로를 적용합니다.

***

*원문 최종 수정: Wed, 29 Oct, 2025 at 9:23 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/custom-object-and-company-based-workflow-actions-triggers.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.