9bc5486d0d
Created by Github action --------- Co-authored-by: github-actions <github-actions@twenty.com>
221 lines
8.9 KiB
Plaintext
221 lines
8.9 KiB
Plaintext
---
|
|
title: 외부 도구 통합
|
|
info: 이 워크플로우는 API 호출과 웹훅을 통해 데이터의 입출력을 중심으로 합니다.
|
|
image: /images/user-guide/integrations/plug.png
|
|
sectionInfo: 프로세스를 자동화하고 외부 도구와 통합하세요
|
|
---
|
|
|
|
<Frame>
|
|
<img src="/images/user-guide/integrations/plug.png" alt="Header" />
|
|
</Frame>
|
|
|
|
아래는 Twenty를 다른 시스템과 연결하는 예시 워크플로우입니다.
|
|
|
|
## 데이터 수집 사용 사례
|
|
|
|
### 웹폼 제출
|
|
|
|
**문제점**: 웹사이트 양식, 랜딩 페이지 또는 연락처 양식에서 리드를 직접 Twenty에 수집해야 합니다.
|
|
|
|
**해결책**: 웹훅 트리거를 사용하여 양식 제출로부터 자동으로 기록을 생성합니다.
|
|
|
|
**설정**:
|
|
|
|
- Webhook 트리거로 워크플로우를 생성합니다
|
|
- 웹훅을 구성하여 폼 데이터(이름, 이메일, 회사 등)를 수신합니다
|
|
- 웹훅 메서드를 POST로 설정합니다
|
|
- 트리거에서 기대되는 본문 구조를 정의합니다
|
|
|
|
**트리거**: Webhook (폼에서의 POST 요청)
|
|
|
|
**조치**:
|
|
|
|
- 기록 검색하여 인물/회사가 이미 존재하는지 확인합니다
|
|
- 가지: 존재 → 기록 업데이트, 존재하지 않음 → 기록 생성
|
|
- 판매 담당자에게 할당된 후속 작업 기록을 생성합니다
|
|
- 판매 팀에게 이메일 알림을 보냅니다
|
|
|
|
### 제품 데이터 동기화
|
|
|
|
**문제점**: 판매 팀이 데이터웨어하우스에 저장된 제품 사용, 청구 또는 기능 채택 데이터에 대한 가시성이 필요합니다.
|
|
|
|
**해결책**: 정기적으로 제품 데이터를 Twenty에 동기화하여 판매자에게 계정에 대한 정보를 제공합니다.
|
|
|
|
**트리거**: 일정에 따라 (일일 또는 주간)
|
|
|
|
**조치**:
|
|
|
|
- 데이터웨어하우스 API로 HTTP 요청을 전송합니다
|
|
- 코드 동작을 통해 데이터를 처리하고 형식을 지정합니다
|
|
- 다음 단계에 대해 Iterator 기능을 사용합니다
|
|
- 일치하는 회사 기록을 찾기 위해 기록을 검색합니다
|
|
- 기록을 업데이트하여 제품 사용 지표를 추가합니다
|
|
- 사용량이 임계치 아래로 떨어질 경우에 대한 작업 기록을 생성합니다
|
|
|
|
### 콜 기록기에서 미팅 노트
|
|
|
|
**문제점**: 판매 전화에서 중요한 통찰력이 손실되거나 CRM에 제대로 기록되지 않습니다.
|
|
|
|
**해결책**: 콜 기록 시스템에서 회의 메모와 작업 항목을 자동으로 생성합니다.
|
|
|
|
**트리거**: 콜 기록 플랫폼에서의 Webhook
|
|
|
|
**조치**:
|
|
|
|
- 코드 동작을 통해 회의 요약 및 작업 항목을 추출합니다
|
|
- 관련된 기회 또는 연락처를 찾기 위해 기록을 검색합니다
|
|
- 회의 요약이 담긴 노트 기록을 생성합니다
|
|
- 작업 항목에 기반한 후속 작업 기록을 생성합니다
|
|
- 참석자에게 요약과 다음 단계가 포함된 이메일을 보냅니다
|
|
|
|
### 데이터 강화
|
|
|
|
**문제점**: 연락처 및 회사 기록에 중요한 인구 통계 및 기업 통계 정보가 부족합니다.
|
|
|
|
**해결책**: 외부 데이터 공급자를 사용하여 기록을 자동으로 강화합니다.
|
|
|
|
**트리거**: 기록이 생성될 때 (사람 또는 회사 객체)
|
|
|
|
**조치**:
|
|
|
|
- 강화 API로 HTTP 요청을 전송합니다
|
|
- 응답을 처리하기 위한 코드 동작
|
|
- 다음 단계에 대해 Iterator 기능을 사용합니다
|
|
- 추가적인 회사/연락처 정보로 기록을 업데이트합니다
|
|
- 고가치 잠재 고객이 확인되면 판매 작업 기록을 생성합니다
|
|
- 강화가 주요 구매 신호를 드러내면 이메일 경고를 보냅니다
|
|
|
|
## 데이터 배포 사용 사례
|
|
|
|
### 뉴스레터 구독자 관리
|
|
|
|
**문제**: 전문 이메일 도구를 사용하여 CRM 데이터 특정 세그먼트로 마케팅 이메일을 발송하고자 합니다.
|
|
|
|
**솔루션**: 필요할 때 구독자 목록을 이메일 마케팅 플랫폼으로 내보내세요.
|
|
|
|
**설정**: 뉴스레터 수신자를 포함한 Twenty에서 뷰 생성하기
|
|
|
|
**트리거**: 수동으로 실행(선택된 레코드가 없는 경우)
|
|
|
|
**작업**:
|
|
|
|
- 뉴스레터 보기 기준을 사용하여 기록 검색
|
|
- 이메일 플랫폼을 위한 이메일 주소 형식 코드 작업
|
|
- 구독자를 이메일 마케팅 도구에 추가하기 위한 HTTP 요청
|
|
- 캠페인 추적을 위한 기록 생성
|
|
- 마케팅 팀에게 이메일 확인 발송
|
|
|
|
### 이메일 시퀀스 트리거
|
|
|
|
**문제**: 전용 이메일 자동화 도구를 사용하여 CRM 이벤트 기반 정교한 이메일 시퀀스를 트리거 하고자 합니다.
|
|
|
|
**솔루션**: 특정 이벤트가 발생할 때 새로운 리드나 고객을 이메일 자동화 플랫폼으로 전송하세요.
|
|
|
|
**트리거**: 기록이 생성됨(특정 기준을 가진 사람 객체)
|
|
|
|
**작업**:
|
|
|
|
- 적절한 이메일 시퀀스를 결정하는 코드 작업
|
|
- 이메일 자동화 플랫폼에 연락처를 추가하기 위한 HTTP 요청
|
|
- 시퀀스 등록을 추적하기 위한 기록 업데이트
|
|
- 참여를 모니터링하기 위한 후속 작업 기록 생성
|
|
|
|
### 리드 스코어 통합
|
|
|
|
**문제**: CRM 데이터와 외부 신호를 결합한 정교한 리드 스코어링이 필요합니다.
|
|
|
|
**솔루션**: 리드 데이터를 외부 스코어링 도구로 전송하거나 워크플로우 내 스코어링 로직을 구현하세요.
|
|
|
|
**옵션 1 - 외부 도구**:
|
|
|
|
**트리거**: 기록이 업데이트됨(사람 객체)
|
|
|
|
**작업**:
|
|
|
|
- 스코어링 플랫폼으로 리드 데이터를 전송하기 위한 HTTP 요청
|
|
- 스코어 응답을 처리하기 위한 코드 작업
|
|
- 리드 스코어를 포함한 기록 업데이트
|
|
- 스코어가 임계점을 초과할 경우 판매 작업 기록 생성
|
|
|
|
**옵션 2 - 내부 로직**:
|
|
|
|
**트리거**: 기록이 업데이트됨(사람 객체)
|
|
|
|
**작업**:
|
|
|
|
- 점수 알고리즘을 포함한 코드 작업(회사 규모, 산업, 행동)
|
|
- 계산된 스코어를 포함한 기록 업데이트
|
|
- 높은 점수의 리드를 위한 영업 담당자에게 이메일 알림 전송
|
|
|
|
### 송장 생성
|
|
|
|
**문제**: 거래가 마감되면 고객 및 거래 정보를 청구 시스템에 업데이트해야 합니다.
|
|
|
|
**솔루션**: 기회가 승낙되면 거래 데이터를 자동으로 송장 시스템으로 전송하세요.
|
|
|
|
**트리거**: 기록이 업데이트됨(기회 객체, 단계 = "마감 승낙")
|
|
|
|
**작업**:
|
|
|
|
- 완전한 고객 정보를 얻기 위해 기록 검색
|
|
- 청구 시스템을 위한 데이터 형식 코드 작업
|
|
- 청구 플랫폼에서 고객을 생성하기 위한 HTTP 요청
|
|
- 송장을 생성하기 위한 HTTP 요청
|
|
- 송장 참조를 저장하기 위한 기록 업데이트
|
|
- 송장 세부 정보를 포함한 이메일을 재무 팀에게 전송
|
|
|
|
## 고급 통합 패턴
|
|
|
|
### 양방향 동기화
|
|
|
|
**문제**: Twenty와 다른 시스템 간의 데이터 동기화가 양방향으로 필요합니다.
|
|
|
|
**솔루션**: 실시간 동기화를 위해 예약된 워크플로우를 웹훅 트리거와 결합하세요.
|
|
|
|
**Twenty에서 외부 시스템으로**:
|
|
|
|
**트리거**: 기록이 업데이트됨(관련된 모든 객체)
|
|
|
|
**작업**:
|
|
|
|
- 외부 시스템을 업데이트하기 위한 HTTP 요청
|
|
- 동기화 상태 및 타임스탬프를 추적하기 위한 기록 업데이트
|
|
|
|
**외부 시스템에서 Twenty로**:
|
|
|
|
**트리거**: 웹훅(외부 시스템으로부터)
|
|
|
|
**작업**:
|
|
|
|
- 일치하는 기록을 찾기 위한 기록 검색
|
|
- 외부 시스템에서 새로운 데이터로 기록 업데이트
|
|
- 필요한 경우 충돌 해결 작업 기록 생성
|
|
|
|
### 다단계 데이터 처리
|
|
|
|
**문제**: 외부 소스의 데이터는 Twenty에서 사용하기 전에 복잡한 처리가 필요합니다.
|
|
|
|
**솔루션**: 데이터 변환 및 유효성 검사를 위한 코드 작업을 사용하세요.
|
|
|
|
**트리거**: 웹훅 또는 일정에 따라
|
|
|
|
**작업**:
|
|
|
|
- 들어오는 데이터 형식 유효성 검사를 위한 코드 작업
|
|
- 데이터 구조를 변환하기 위한 코드 작업
|
|
- 비즈니스 규칙 및 계산을 적용하기 위한 코드 작업
|
|
- 중복을 검사하기 위한 기록 검색
|
|
- 처리된 데이터를 포함한 기록 생성 또는 업데이트
|
|
- 데이터 품질 문제가 감지된 경우 이메일 알림 전송
|
|
|
|
## 구현 팁
|
|
|
|
- API 키를 안전하게 설정 → API & Webhooks에 저장
|
|
- 모든 외부 API 호출에 HTTPS 사용
|
|
- API 속도 제한을 인식하고, 가능할 경우 예약된 워크플로우 사용
|
|
- 실시간 처리가 필요하지 않을 경우 일정에 따라 "배치" 업데이트 고려
|
|
- 동시에 100개의 워크플로 한도 - 여러 개의 레코드를 처리할 때 수동 트리거에 "대량" 사용 가능성 사용 (자세한 정보는 [워크플로우 기능](/l/ko/user-guide/workflows/workflow-features) 참조)
|
|
- 워크플로우를 활성화하기 전에 샘플 데이터로 테스트
|
|
|
|
통합 문제 해결을 위해, 우리의 [워크플로우 문제 해결 가이드](/l/ko/user-guide/workflows/workflow-troubleshooting)를 참조하세요. 복잡한 통합 구현에 대한 도움은 우리의 [전문 서비스](/l/ko/user-guide/workflows/professional-services)를 고려하세요.
|