# Framer + Brew

기존 Framer 폼을 Brew에 추가하세요. 제출될 때마다 연락처가 추가되거나 업데이트되고, 각 폼의 트리거로 자동화를 시작할 수 있어요.

정식 URL: https://brew.new/ko/browse/integrations/framer

- 방향: 데이터 가져오기
- 연결 방식: 폼 웹훅
- 폼 및 가입

## 사용 가능한 기능

- **이벤트 트리거**: 이름을 붙인 폼마다 연락처를 수집하고 자체 트리거를 실행해요.
- **연락처 동기화**: 서명된 폼 제출로 연락처를 만들거나 업데이트해요.

## Framer 폼 제출을 연락처와 이메일로 바꾸세요

이미 쓰고 있는 Framer 기본 폼을 Brew에 추가하세요. 제출될 때마다 연락처가 추가되거나 업데이트되고, 폼의 트리거로 게시된 자동화가 웰컴 이메일이나 후속 이메일을 보낼 수 있어요.

폼마다 전용 웹훅 URL, 서명 시크릿, 트리거가 생겨요. 한 브랜드에 이름을 붙인 폼을 여러 개 둘 수 있어요. Brew API 키나 중계 서버는 필요 없어요.


## 만들 수 있는 것

- 뉴스레터 웰컴 이메일: 가입 폼의 트리거로 자동화를 게시해 새 구독자를 한 명 한 명 맞이하세요.
- 대기자 명단 등록 확인: 등록을 확인해 주고, 앞으로 어떤 일이 진행될지 미리 알려 주세요.
- 리드 및 데모 요청 후속 이메일: 회사나 팀 규모 같은 사용자 지정 필드를 선언한 다음, 이메일과 자동화 조건에 활용하세요.
- 폼별로 다른 플로우: 폼마다 트리거가 따로 있어서, 문의 폼과 뉴스레터 폼이 서로 다른 자동화를 시작할 수 있어요.

## 제출이 연락처가 되는 방식

게시된 자동화가 없어도 Brew는 연락처를 저장해요. 같은 이메일 주소로 다시 제출되면 브랜드의 기존 연락처가 업데이트되고, 선택 필드가 비어 있어도 저장된 값은 지워지지 않아요.

제출로는 구독, 발송 제외, 라우팅 필드를 바꿀 수 없어요. 기존 수신 거부도 그대로 유지돼요.

연락처 저장에 성공해야 자동화로 전달돼요. 저장에 실패하면 Brew는 아무것도 시작하기 전에 다시 시도해요.

Framer가 제출을 스팸 가능성이 있거나 스팸일 가능성이 높다고 표시하면, Brew는 연락처를 저장하거나 자동화를 시작하지 않고 그 제출을 버려요.


## Brew에서 Framer 폼 설정하기

- 브랜드를 선택하고 ‘연동’ > Framer를 연 다음 ‘폼 추가’를 선택하세요. 기존 폼의 이름을 정하고 폼이 제출하는 필드를 정의하세요.
- 폼 세부 정보 페이지에서 웹훅 URL과 서명 시크릿을 복사하세요.
- Framer에서 기본 폼을 선택하고 Send To를 연 다음 Webhook을 추가하세요. Webhook 설정에 Brew URL과 서명 시크릿을 붙여 넣으세요.
- Framer의 각 입력 항목 이름을 Brew 필드 이름과 맞추세요. Brew는 대소문자, 공백, 문장 부호를 무시하므로 First Name은 firstName으로 들어가요. ‘설정 방법’ 탭의 ‘프롬프트 복사’를 쓰면 추가하거나 이름을 바꿔야 할 입력 항목 이름을 Framer AI에 정확히 알려 줄 수 있어요.
- Framer 사이트를 게시하고, 게시된 페이지에서 폼을 제출하세요. 폼의 ‘제출 내역’ 탭을 확인한 다음 저장된 연락처를 확인하세요.
- 앞으로 들어올 가입에 플로우를 시작하려면 폼의 ‘자동화’ 탭을 열고 ‘자동화 만들기’를 선택하세요. Brew가 폼의 트리거를 선택해 줘요. 자동화를 실행하려면 게시하세요.

## 필드와 개인화

모든 폼에는 email 필드가 필요해요. firstName과 lastName은 선택 사항이에요. 사용자 지정 필드에는 텍스트, 정수, 체크박스 값을 쓸 수 있어요. 날짜에는 텍스트를 사용하세요. 중첩된 객체, 목록, 파일 업로드는 지원하지 않아요.

Framer 폼에는 다른 입력 항목이 더 있어도 돼요. Brew는 선언된 필드만 읽고, 나머지는 ‘제출 내역’에 무시된 항목으로 표시해요.

email을 제외한 각 필드는 같은 이름의 연락처 열에 저장되며, 이 열은 첫 제출 때 만들어져요. ‘연락처 열’에서 필드를 기존 열에 저장하도록 지정할 수도 있어서, name이라는 입력 항목을 ‘이름’ 열에 저장할 수 있어요.

선언된 필드는 그 폼을 쓰는 자동화의 개인화 태그가 돼요. 필드를 편집하면 트리거와 페이로드 정의도 함께 업데이트돼요. 게시된 자동화가 폼을 쓰는 동안에는 호환되지 않는 편집을 Brew가 막아요.

폼에서 따로 동의를 받지 않는 한, 폼 제출은 마케팅 이메일 수신 동의가 아니에요. 프로모션 이메일을 보낼 계획이라면 명확한 동의 필드를 추가하세요.


## 기본 폼 대신 Framer 코드 컴포넌트를 써도 되나요?

아니요. Framer 기본 폼에서 Webhook 대상을 사용하세요. 코드 컴포넌트는 방문자의 브라우저에서 요청을 보내므로 Framer의 서명을 만들 수 없고, 시크릿이 페이지에 노출돼요. Brew는 이런 요청에 401로 응답해요.


## 제출은 들어왔는데 이메일이 발송되지 않는 이유는 뭔가요?

‘제출 내역’ 탭에는 수신, 연락처 저장, 자동화 전달 결과가 각각 따로 표시돼요. 폼의 트리거를 쓰는 자동화가 게시됐는지 확인한 다음, 필터와 실행 기록, 발신 도메인을 확인하세요. 잘못된 필드로 거부되거나 스팸으로 표시된 제출은 아무것도 시작하지 않아요.


## 제한 사항 및 문제 해결

- 401 서명 실패는 Framer에 입력된 시크릿이나 URL이 최신이 아니라는 뜻이에요. Brew에서 현재 값을 복사해 넣고 다시 게시하세요.
- 잘못된 필드로 ‘거부됨’ 처리됐다면 email 같은 선언된 필드가 빠졌거나 유형이 잘못됐다는 뜻이에요. 이때 Framer는 200 응답을 받으므로 재시도하지 않아요.
- 요청 크기는 64 KiB 이하, 최상위 필드는 100개 이하여야 해요.
- 새 제출은 폼당 분당 120건, 브랜드당 분당 600건으로 제한돼요. 이 한도는 개별 방문자에 대한 스팸 방지 장치가 아니에요.
- ‘시크릿 다시 생성’을 선택하면 URL은 그대로 유지되고 이전 시크릿은 즉시 무효가 돼요. ‘폼 비활성화’를 선택하면 새 제출은 거부되지만, 이미 시작된 실행은 계속 진행돼요.
- Framer는 실패한 전송을 재시도하지만 리디렉션은 따라가지 않으니, Brew에 표시된 URL을 그대로 사용하세요.

## 출처 및 설정 가이드

- [Framer 폼 웹훅 설정](https://www.framer.com/help/articles/framer-form-webhook-setup/)
- [자동화 만들기](https://docs.brew.new/create-emails/build-an-automation)
- [개인화 태그](https://docs.brew.new/create-emails/merge-tags)
- [Brew로 보낼 수 있는 이메일](https://docs.brew.new/get-started/what-you-can-send)

## 관련 링크

- [전체 연동](https://brew.new/ko/browse/integrations.md)
- [회원가입](https://brew.new/ko/sign-up.md)
- 웹사이트: https://brew.new