Make 웹훅 이전: Google Sheets 연동 시나리오를 AI Flowi Workflow로 옮기기

Make 웹훅 이전을 하려면 AI Flowi에서 필드 매핑, 검증, 호출자 응답을 다시 구현해야 합니다. Make 블루프린트는 직접 가져올 수 없습니다. Google 연결을 다시 인증하고 대상 시트를 테스트하세요. AI Flowi 구성 예시는 2026년 10월 8일에 운영 환경 테스트를 거쳤습니다. 유효한 요청은 200을 반환했고, 검증이나 키 확인에서 거부된 요청은 행을 기록하지 않았습니다.

작성: Ai Flowi · 게시일 2026년 10월 9일 · 수정일 2026년 10월 9일

전체 구축 단계: 웹훅을 Google Sheets에 연결하는 튜토리얼. 민감 정보를 제거하고 검증한 워크플로 JSON ZIP 다운로드.

Make 블루프린트 JSON은 AI Flowi에서 가져올 수 있는 형식이 아닙니다. 이 이전 작업은 수동으로 다시 구현하는 방식입니다. 블루프린트를 참고 자료로 사용하세요. 제공된 AI Flowi JSON을 가져오면 테스트한 구성 예시로 시작할 수 있습니다. JSON 구문이 같다고 호환되는 것은 아닙니다. Make 블루프린트 형식: 문서로 확인했으며 Ai Flowi가 테스트하지 않음; 확인일 2026년 10월 9일. 다음을 참고하세요: Make 대안으로서의 AI Flowi.

시작하기 전에

• Make의 입력 필드, 변환, 필터, 열 순서, 대상, 인증, 호출자 응답, 오류 처리기, 중복 전달 정책을 기록하세요.

Make → AI Flowi 노드 매핑

구성 예시를 변경하지 않고 사용하려면 {"name":"Demo Name","email":"demo@example.com","request":"Synthetic enquiry"}를 POST 본문으로 보내세요. Make 시나리오의 필드 이름이 다르면 발신자의 매핑을 변경하거나 수정한 검증기를 테스트하세요. body 래퍼를 추가하지 마세요. Universal Webhook이 해당 래퍼를 제공합니다.

관련 자료: n8n 워크플로 이전: 웹훅으로 Google Sheets에 쓰는 워크플로를 AI Flowi Workflow로 옮기기.

수동으로 다시 구성해야 할 항목

AI Flowi Google Connection을 통해 대상 계정으로 연결을 다시 인증하세요. Make 블루프린트에는 연결이 포함되지 않으므로 Make로 가져온 뒤에도 연결을 다시 구성해야 합니다(문서로 확인했으며 Ai Flowi가 테스트하지 않음; 확인일 2026년 10월 9일). 내보내기 파일을 공유하기 전에 비밀 정보가 있는지 확인하세요. 공개 AI Flowi JSON에서는 민감 정보를 제거했지만, 일반적인 일괄 내보내기에는 계정 라벨, 연결 식별자, 스프레드시트 ID, 엔드포인트 URL이 남아 있을 수 있습니다.

이전되지 않는 항목

• 직접 가져오기 미지원: Make 블루프린트 JSON은 AI Flowi로 가져올 수 없습니다. 동작을 수동으로 다시 구현하세요. 제공된 AI Flowi JSON은 Make 시나리오를 변환하지 않습니다.
• 이 구성 예시에서 동등한 동작이 테스트되지 않은 기능: Make 라우터/필터의 임의 경로와 Skip, Retry, Resume, Commit, Rollback 오류 처리기는 테스트한 검증 통과/거부 분기의 범위를 벗어납니다. 원본 플랫폼의 이 기능들은 문서로 확인했으며(공식 출처, 확인일 2026년 10월 9일) Ai Flowi가 테스트하지 않았습니다: Make 라우터와 필터 및 Make 오류 처리기. 필요한 동작은 별도로 다시 구현하고 테스트하세요. 입력 거부는 Sheets 오류를 잡거나 트랜잭션 롤백을 제공하지 않습니다.
• 인증 정보: AI Flowi에서 Google 연결과 웹훅 인증을 다시 구성하세요. Make 블루프린트에는 연결이 포함되지 않습니다(문서로 확인했으며(공식 출처, 확인일 2026년 10월 9일) Ai Flowi가 테스트하지 않았습니다). 대상 Google 계정으로 연결을 다시 인증하세요.
• 웹훅 URL과 이력: 인수 검증 후 발신자는 새로운 AI Flowi Production Endpoint를 사용해야 합니다. 롤백을 위해 기존 Make URL과 필요한 과거 로그를 보관하세요.

AI Flowi 테스트 결과(2026년 10월 8일)

AI Flowi 설계는 2026년 10월 8일에 운영 환경 테스트와 새 플로로 가져온 뒤 수행한 테스트를 통과했습니다. 아래 기록된 결과는 해당 구성 예시에 관한 것이며, 이전한 Make 시나리오의 결과가 아닙니다. 자신의 필드 매핑, 인증 정보, 대상을 다시 구성한 뒤, 발신자를 전환하기 전에 호출자 응답과 시트에 기록된 내용을 모두 검증하세요.

새 플로로 가져온 복사본에서도 성공 응답, 입력 검증 실패 및 키 인증 실패에 따른 요청 거부, 중복 처리 동작이 재현되었습니다. 잘못된 ID 테스트는 원래 설계에서만 수행했습니다. 각 사례에서 응답 본문을 비교하고 실제 시트를 다시 읽어 확인하세요. 캔버스나 가져오기 성공만으로는 데이터가 기록되었음을 입증할 수 없습니다.

알려진 한계

2026년 10월 8일의 행 추가 테스트에서는 반복 전달될 때마다 행이 추가되었습니다. 재시도하는 발신자에는 중복 방지 버전을 사용하세요. 이 버전은 2026년 10월 9일에 운영 환경에서 테스트했으며 event_id와 Upsert Row를 사용합니다. 동시에 전달된 두 요청이 모두 행을 삽입할 수 있습니다. 원래 설계의 잘못된 ID 테스트에서는 스프레드시트 ID를 포함한 가공하지 않은 Google 오류 세부 정보가 반환되었습니다. 이 구성 예시에는 Sheets 오류를 플로 내에서 잡아 처리하는 기능이 없습니다.

시나리오가 의존하는 Make의 Skip, Retry, Resume, Commit 및 Rollback 오류 처리기의 동작을 기록하세요(문서로 확인했으며 Ai Flowi가 테스트하지 않음; 확인일 2026년 10월 9일). 전환 전에 필요한 오류 처리를 다시 구현하고 테스트하세요. 테스트한 거부 분기는 기록 전에 입력을 검증합니다. Sheets 오류를 잡거나 재시도, 복구, 트랜잭션 롤백을 제공하지 않습니다.

필요한 과거 로그를 별도로 보관하세요. 모듈 이름이 비슷하더라도 호출자 응답, 재시도 정책, 접근 규칙은 동작을 확인해야 합니다.

전환 체크리스트

다시 구현한 Make 시나리오에 다음 단계를 적용하세요. 이는 운영 체크리스트이며, 플랫폼 간 전환을 테스트했다는 증거가 아닙니다.

1. 구축 및 설정: 기본 튜토리얼의 설정 절차를 따르세요. 발신자가 재시도하는 경우에는 중복 방지 설정 절차를 따르세요. Google 연결을 다시 구성하고, Spreadsheet ID, 탭, 열 순서, 필드 매핑, POST 메서드, Platform API Key 인증, From Flow 응답 모드를 확인하세요. JQ 필드는 표시된 상태로 두세요.
2. AI Flowi에서 인수 테스트 실행: 유효하고 인증된 입력은 200을 반환하고 행 1개를 기록해야 합니다. 필드 누락, 잘못된 유형, 유효하지 않은 이메일, 형식이 잘못된 JSON은 행을 기록하지 않고 422를 반환해야 합니다. 키가 없거나 유효하지 않으면 행을 기록하지 않고 403을 반환해야 합니다. 각 사례 후 시트를 다시 읽어 확인하세요.
3. 중복 전달 테스트: 행 추가 버전은 동일한 유효 입력을 두 번 전달하면 행 2개를 기록합니다. 중복 방지 버전에서는 동일한 event_id를 순차적으로 보내세요. 먼저 200과 {"status":"inserted"}를, 다음으로 200과 {"status":"duplicate"}를 반환하며 추가 행이 생기지 않아야 합니다. 동시에 전달된 두 요청이 모두 행을 삽입할 수 있습니다.
4. 테스트 시트에서 두 시스템을 병행 실행: 동일한 합성 입력을 Make와 AI Flowi에 보내되, 기록 결과를 비교할 수 있도록 테스트 스프레드시트의 서로 다른 탭을 사용하세요. 매핑된 값, 열 순서, HTTP 응답, 중복 처리 동작을 기록해 둔 호출자와의 인터페이스 규약과 비교하세요. 운영 발신자를 변경하기 전에 차이를 해결하세요.
5. 발신자 URL 전환: 기존 URL과 전환 시각을 기록한 뒤 Make 웹훅 URL을 AI Flowi Production Endpoint로 교체하고, 발신자의 AI Flowi 인증을 설정하세요.
6. 초기 요청 모니터링: 호출자에게 반환된 상태 코드와 응답 본문, 실제 대상 행을 확인하여 기록 누락이나 중복이 있는지 살펴보세요. Sheets 오류가 발생하면 플랫폼이 반환한 오류 원문이 반환될 수 있습니다. 테스트한 구성 예시에는 Sheets 오류를 플로 내에서 잡아 처리하는 기능이 없습니다. 다시 구현한 동작이 검증 기준을 충족하지 못하면 롤백 계획을 실행하세요.
7. 롤백 가능 기간 유지: 전환 후 기존 Make 시나리오를 비활성화하세요. 정한 롤백 가능 기간이 끝날 때까지 삭제하지 말고 비활성화 상태로 유지하며, URL과 설정을 사용할 수 있도록 보관하세요.

롤백 계획

1. 전달 복원: 발신자가 기록해 둔 Make 웹훅 URL을 다시 사용하도록 하고, 원래 인증을 복원한 뒤 기존 시나리오를 다시 활성화하세요. 요청과 대상 행을 확인한 다음 AI Flowi 대체 워크플로를 비활성화하세요.
2. 전환 기간의 기록 대조: 중복 방지 버전을 사용하는 경우, 누락된 이벤트를 재전송하기 전에 전환 기간에 기록된 행과 발신자 기록을 event_id 기준으로 비교하세요. 재시도에는 같은 식별자를 유지하세요. Upsert Row는 일치하는 기존 행을 업데이트합니다. 이미 있는 중복 행을 병합하지 않으며, 키의 적용 범위는 워크시트 하나입니다. 기존 시나리오에서 event_id를 저장하지 않는다면 수동 대조를 위해 발신자 기록에 보관하세요. 행 추가 버전에는 event_id 기반 중복 방지 기능이 없으므로, 재전송 전에 전환 기간의 행을 수동으로 검토하세요.

이전 시스템으로 돌아가도 시트에 기록된 내용은 취소되지 않습니다. 이는 수동으로 수행하는 운영 롤백이며, 테스트로 확인된 중복 방지의 한계는 여전히 적용됩니다. 동시에 전달된 두 요청으로 행이 각각 삽입될 가능성도 포함됩니다.

출처와 증거의 범위

• 업데이트된 웹훅 Google Sheets 연결 튜토리얼 및 민감 정보를 제거한 워크플로 JSON ZIP. 구성 예시, 실제 사용한 JQ 식, 응답 및 한계는 2026년 10월 8일에 작성된 운영 환경 테스트 및 새 플로로 가져온 뒤 수행한 테스트 보고서를 바탕으로 합니다. 포트는 민감 정보를 제거한 가져오기 파일과 일치합니다.
• Google Connection 및 AI Flowi 워크플로 가져오기/내보내기.
• 위에 링크된 Make 출처: 웹훅, 라우터/필터, Sheets 모듈, OAuth 연결, 블루프린트, 오류 처리기. 공식 출처는 2026년 10월 9일에 확인했습니다. 문서로 확인했으며 Ai Flowi가 테스트하지 않았습니다. Make 시나리오 실행이나 플랫폼 간 내보내기 호환성은 테스트하지 않았습니다.