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

n8n 워크플로 이전 시 웹훅으로 Google Sheets에 쓰는 워크플로의 필드 매핑, 검증, 호출자 응답을 AI Flowi에서 다시 구성해야 합니다. n8n 워크플로 내보내기 파일은 직접 가져올 수 없습니다. Google 연결을 다시 승인하고 대상 시트를 테스트하세요. 이 AI Flowi 구성 예시는 2026년 10월 8일 프로덕션 환경에서 테스트했습니다. 유효한 요청에는 200을 반환했으며, 검증 실패나 키 오류로 거부된 요청은 행을 기록하지 않았습니다.

작성: Ai Flowi · 게시일 · 수정일

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

n8n 워크플로 JSON은 AI Flowi에서 가져올 수 있는 형식이 아닙니다. 이전하려면 수동으로 다시 구성해야 합니다. 위의 민감 정보를 제거한 AI Flowi JSON으로 시작하고, n8n 내보내기 파일은 참고 자료로만 사용하세요. 파일 확장자가 같다고 호환되는 것은 아닙니다. n8n 내보내기 파일을 직접 가져오거나 변환하는 작업은 테스트하지 않았습니다. n8n은 워크플로 JSON 형식을 문서로 제공하고 있습니다. 문서에 명시된 내용이며 Ai Flowi에서 테스트하지 않았습니다. 확인일은 2026년 10월 9일입니다.

시작하기 전에

  • 기존 n8n 워크플로의 입력 필드, 변환, 열 순서, 대상, 인증, 호출자 응답, 중복 전달 처리 방침을 기록하세요.

n8n 노드와 AI Flowi 컴포넌트 매핑

워크플로에서 실제로 사용하는 페이로드 경로, 필드 표현식, 호출자와의 요청·응답 규약을 기록하세요. 아래 표에 따라 해당 동작을 다시 구성하세요. n8n 관련 항목은 문서에 명시된 내용이며 Ai Flowi에서 테스트하지 않았습니다. 연결된 공식 자료는 2026년 10월 9일에 확인했습니다.

n8n 노드 → AI Flowi 컴포넌트 → 참고 사항
n8n 노드AI Flowi 컴포넌트참고 사항
WebhookUniversal Webhook이 구성 예시에서는 POST와 From Flow 응답을 사용합니다. 엔드포인트와 인증을 다시 설정하세요. 접근 규칙을 검토 없이 그대로 복사하지 마세요.
IF / FilterJSON Operations (JQ) + Verification Router필수 필드 검사를 다시 구성하세요. 테스트한 구성에서는 Rejected 경로로 검증 실패 사유를 반환합니다.
Google Sheets: Append RowAppend Rowsname, email, request를 각각 A, B, C 열에 매핑하세요. 이 동작은 행 추가이며, Append or Update Row가 아닙니다.
Respond to Webhook (사용자 지정 응답 코드)Webhook Response 200 / 422n8n 문서에는 응답 코드, 헤더, 본문을 설정할 수 있다고 명시되어 있습니다. 호출자와의 요청·응답 규약을 다시 구현하세요. 이 AI Flowi 분기들은 행 추가 결과 또는 검증 실패 사유를 반환합니다.
Google 인증 정보: OAuth2 / Service AccountAI Flowi Google Connection대상에 접근할 수 있는 계정의 연결을 다시 승인하세요. AI Flowi 가져오기 작업은 n8n 인증 정보를 이전하지 않습니다.

AI Flowi Workflow와 n8n 비교를 별도 참고 자료로 활용하세요. 워크플로의 입력 규약, Google 연결, 대상을 다시 구성하고 테스트하세요.

수동으로 다시 구성할 항목

Settings → Google Connections에서 계정 연결을 생성하거나 다시 승인한 다음, Append Rows에서 선택하세요. 기존 n8n OAuth2 또는 Service Account 인증 정보는 이 연결로 대체해야 합니다. 내보내기 파일을 공유하기 전에 내용을 점검하세요. n8n 문서에는 워크플로 내보내기 파일에 인증 정보의 이름과 ID가 포함된다고 명시되어 있습니다(문서에 명시된 내용이며 Ai Flowi에서 테스트하지 않았습니다. 2026년 10월 9일 확인). 제공된 AI Flowi JSON은 민감 정보를 제거한 파일입니다. 일반적인 일괄 내보내기 파일에는 계정 표시 이름, 연결 식별자, 스프레드시트 ID, 엔드포인트 URL이 남아 있을 수 있습니다.

이전되지 않는 항목

  • n8n 워크플로 직접 가져오기 지원 없음: n8n 워크플로 JSON은 AI Flowi로 가져올 수 없습니다. 동작을 수동으로 다시 구성하세요. n8n 내보내기 파일은 참고 자료이며, 호환되는 AI Flowi 워크플로 파일이 아닙니다.
  • 이 구성 예시에서 동등한 동작을 테스트하지 않은 기능: n8n의 웹훅 응답 코드, 헤더, 본문 설정에 대해서는 호출자와의 요청·응답 규약을 확인해야 합니다(문서에 명시된 내용(공식 자료, 2026년 10월 9일 확인)이며 Ai Flowi에서 테스트하지 않았습니다). 이 가이드의 알려진 제한 사항에 명시된 대로 사용자 지정 코드, 다른 노드, 바이너리 또는 스트리밍 응답, 오류 처리 워크플로, 재시도, 실행 이력도 이 기본 구성 예시의 범위에 포함되지 않습니다. 필요한 동작을 별도로 다시 구성하고 테스트하세요. 보존해야 하는 과거 기록도 유지하세요.
  • 인증 정보: AI Flowi에서 Google 연결과 웹훅 인증을 다시 구성하세요. n8n OAuth2 / Service Account 인증 정보는 이전되지 않습니다. 내보내기 파일에 있는 인증 정보의 이름과 ID는 승인된 AI Flowi 연결이 아닙니다(문서에 명시된 내용(공식 자료, 2026년 10월 9일 확인)이며 Ai Flowi에서 테스트하지 않았습니다).
  • 웹훅 URL: 인수 검사를 완료한 후 발신자는 새로운 AI Flowi Production Endpoint를 사용해야 합니다. 롤백을 위해 기존 n8n URL을 보관하세요.

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

이 AI Flowi 구성은 2026년 10월 8일 프로덕션 환경 테스트와 새로 가져온 복사본의 테스트를 통과했습니다. 아래에 기록된 결과는 해당 구성 예시에 대한 결과이며, 사용자가 이전한 n8n 워크플로에 대한 결과는 아닙니다. 자신의 필드 매핑, 인증 정보, 대상을 다시 구성한 다음, 발신자를 전환하기 전에 호출자 응답과 실제 시트 기록을 모두 확인하세요.

테스트용으로 만든 입력 데이터로 재현할 프로덕션 테스트 결과
사례기록된 HTTP 결과기록된 대상 시트의 처리 결과
유효한 본문과 플랫폼 키200, 행 추가 결과 포함name/email/request 순서로 행 1개 추가
필드 누락, 잘못된 자료형 또는 유효하지 않은 이메일422, 필드별 사유 포함추가된 행 없음
잘못된 형식의 JSON422, 본문이 객체여야 한다는 오류 포함추가된 행 없음
플랫폼 키 누락 또는 유효하지 않은 플랫폼 키403, 플로 실행 전에 반환추가된 행 없음
잘못된 스프레드시트 ID, 원본 플로에서만 테스트404, Google 컴포넌트 오류 원문 포함테스트 시트 변경 없음
동일한 유효 이벤트를 두 번 전달각 전달에 200 반환행 2개 추가, 중복 제거 없음

새로 가져온 복사본에서도 성공, 검증 실패로 인한 거부, 키 오류로 인한 거부, 중복 전달 시 동작을 재현했습니다. 잘못된 ID 테스트는 원본 구성에서만 수행했습니다. 각 사례를 실행한 뒤 응답 본문을 비교하고 실제 시트를 다시 읽어 확인하세요. 캔버스나 가져오기 성공만으로는 기록 여부를 입증할 수 없습니다.

관련 자료: 워크플로 비교.

알려진 제한 사항과 지원되지 않는 이전 기능

2026년 10월 8일 행 추가 테스트에서는 반복 전달할 때마다 행이 추가되었습니다. 재시도하는 발신자를 위한 중복 방지 버전은 2026년 10월 9일 프로덕션 환경에서 테스트했으며, event_id와 Upsert Row를 사용합니다. 동시에 전달하면 두 요청 모두 행을 삽입할 수 있습니다. 원본의 잘못된 ID 테스트에서는 스프레드시트 ID를 포함한 Google 오류 세부 정보가 그대로 반환되었습니다. 이 구성 예시에는 워크플로 내부에서 발생한 예외를 포착해 처리하는 단계가 없습니다.

이 기본 구성 예시는 JSON 객체 1개를 받아 3개 열로 이루어진 행 1개를 추가하는 작업을 다룹니다. 사용자 지정 코드, 다른 노드, 바이너리 또는 스트리밍 응답, 오류 처리 워크플로, 재시도, 실행 이력은 다시 구성하지 않습니다. 보존해야 하는 과거 기록은 별도로 유지하세요. 운영 전환 전에 추가 동작을 다시 구성하고 테스트하세요. 노드 이름이 비슷하다고 응답이나 접근 규칙이 동등한 것은 아닙니다.

운영 전환 체크리스트

다시 구성한 n8n 워크플로에 다음 단계를 적용하세요. 이는 운영 체크리스트이며, 플랫폼 간 운영 전환을 테스트했다는 근거는 아닙니다.

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

롤백 계획

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

이전 시스템으로 전환해도 시트에 기록된 내용은 되돌아가지 않습니다. 이 절차는 수동 운영 롤백입니다. 동시 삽입 가능성을 포함한 테스트된 중복 방지 기능의 제한 사항은 여전히 적용됩니다.

자료와 검증 근거의 범위