트리거: 웹훅·수동 실행

쇼핑몰이나 예약 시스템처럼 퍼널체인저스 밖에서 일어난 일을 자동화의 시작점으로 쓰고 싶을 때가 있습니다. 반대로 사람이 직접 고른 연락처에게만 흐름을 시작하고 싶을 때도 있습니다. 자동화 빌더의 외부 묶음에 있는 웹훅과 수동 트리거가 이 두 경우를 맡습니다. 이 글에서는 두 트리거의 속성 패널 항목과 흐름이 시작되는 조건을 안내합니다. 트리거 아래에 이을 액션의 설정은 별도 글에서 다룹니다.

1. 트리거 고르기

왼쪽 메뉴의 자동화 > 워크플로우에서 자동화를 열어 빌더로 들어갑니다. 첫 블록 트리거 선택을 누르면 오른쪽에 목록이 열리고, 맨 아래 외부 묶음에 웹훅(외부 시스템에서 HTTP 호출)과 수동(직접 실행 또는 테스트)이 있습니다. 이미 다른 트리거를 정했다면 속성 패널의 트리거 변경으로 바꿀 수 있습니다.

2. 웹훅 트리거

웹훅을 고르면 속성 패널이 열립니다. 항목은 레이블, 설명, 웹훅 URL, 실행 옵션입니다.

웹훅 URL은 자동화마다 시스템이 만들어 주는 주소이고 직접 고칠 수 없습니다. 오른쪽 복사를 누르면 버튼이 잠시 복사됨!으로 바뀝니다. 안내 문구대로 이 주소로 POST 요청을 보내면 워크플로우가 실행되며, 요청 본문에 email(필수)과 name, phone을 담아 보냅니다.

주소 끝에는 인증 토큰이 붙어 있습니다. 패널에도 외부에 노출되지 않도록 주의하라는 안내가 있으니, 주소를 비밀번호처럼 다뤄 주세요.

3. 수동 트리거

수동은 외부 호출 없이 사람이 직접 시작하는 트리거입니다. 패널 항목은 레이블, 설명, 설명 (선택), 실행 옵션입니다. 설명 (선택)에는 이 자동화를 직접 시작할 때의 조건을 적어 두며, 적은 내용은 블록의 부제로 표시됩니다.

4. 실행 옵션

두 트리거 모두 구독 상태가 아니어도 실행과 여러 번 다시 시작 허용이 있고, 기본값도 같습니다. 구독 상태가 아니어도 실행은 꺼져 있고, 여러 번 다시 시작 허용은 켜져 있습니다.

• 구독 상태가 아니어도 실행이 꺼져 있으면 구독 상태인 연락처에게만 시작합니다.
• 여러 번 다시 시작 허용을 끄면 이 자동화를 한 번이라도 실행한 연락처에게는 다시 시작하지 않습니다.

5. 언제 시작되나요

웹훅

• 자동화가 활성 상태일 때만 시작합니다. 비활성이면 요청을 받아도 시작하지 않습니다.
• 주소의 토큰이 맞지 않으면 요청이 거부됩니다. 자동화를 삭제하면 그 주소도 쓸 수 없습니다.
• 본문의 이메일로 연락처를 찾고, 없으면 새 연락처를 만든 뒤 시작합니다. 이때 만들어진 연락처는 구독 상태이며 만든 경로는 API로 기록됩니다.
• 이전 흐름이 아직 진행 중인 연락처는 새로 시작하지 않습니다.
• 요청에 event_id를 함께 보내면, 같은 값으로 다시 온 요청은 중복으로 시작하지 않습니다.

수동

• 고객관리 > 연락처 목록에서 연락처를 선택한 뒤 대량 작업 선택에서 자동화 퍼널에 추가를 고릅니다.
• 자동화 선택 목록에서 자동화를 고르고 적용을 누르면, 선택한 연락처마다 그 자동화가 즉시 시작됩니다.

이 경로는 사람이 직접 고른 시작이라 트리거 종류에 따른 조건은 따지지 않습니다. 다만 활성 상태인지, 이미 진행 중인지, 재시작과 구독 상태 옵션에 맞는지는 그대로 따집니다.

6. 이렇게 활용해 보세요

• 외부 쇼핑몰이나 예약 도구에서 주문·접수가 생길 때 웹훅 주소로 연락처 정보를 보내, 환영 안내 흐름이 이어지게 해 보세요.
• 행사에 참석한 연락처만 골라 수동으로 후속 안내 자동화에 넣어 보세요.
• 처음에는 고객에게 메시지가 나가지 않는 액션으로 흐름을 확인한 뒤 발송 액션을 추가하세요.

7. 알아 두실 점

• 저장만 하고 스위치를 켜지 않으면 시작되지 않습니다.
• 웹훅 주소를 아는 사람은 누구나 흐름을 시작할 수 있으므로, 공개된 곳에 적지 마세요.
• 자동화 목록에는 활성이 아닌 자동화도 상태 표시와 함께 보이지만, 활성 상태가 아니면 시작되지 않습니다.
• 웹훅으로 새로 만들어진 연락처는 연락처 생성 트리거 중 소스 필터가 모든 소스이거나 API인 자동화도 시작할 수 있습니다. 연락처 생성 트리거는 별도 글에서 다룹니다.
• 웹훅 요청을 보내는 쪽 설정 방법은 사용하는 외부 도구에 따라 다릅니다.