본문으로 건너뛰기
시트에 URL을 넣으면 짧은주소가 생기게 하는 n8n 워크플로

시트에 URL을 넣으면 짧은주소가 생기게 하는 n8n 워크플로

시트에서 준비된 행을 읽고, 발급한 짧은주소를 같은 행에 돌려놓는 예제입니다.

금요일 오후, 캠페인 시트에 주소 열두 개가 들어왔습니다. 하나씩 줄여 시트에 적고 나니 두 개를 수정해 달라는 요청이 옵니다. 어느 링크를 다시 만들었는지 찾는 데도 시간이 듭니다. 이 작업은 시트 한 행을 chck.my 링크 하나에 연결하면 줄일 수 있습니다. Google Sheets에서 준비된 행을 읽고 n8n으로 API를 호출한 뒤, 받은 짧은주소를 그 행에 되쓰면 됩니다.

예제 시트에 게시용 주소가 채워지는 모습

아래는 작은 책방이 뉴스레터와 포스터에 행사 주소를 배포하는 가상 예제입니다. 두 채널의 목적지와 공개 주소를 서로 따로 관리합니다. 비어 있는 짧은주소 칸을 자동화가 채우고, 마케터는 주소를 한 번 열어 본 다음 배포합니다.

row_idrevisioninput_urlstatusshort_url
book-fair-email1example.com/book-fair?utm_source=newsletterREADY비어 있음
book-fair-poster1example.com/book-fair?utm_source=posterDONEchck.my/Ab3xYz9

표의 목적지에서 프로토콜은 생략했습니다. 실제 input_url 셀에는 브라우저 주소창에서 복사한 HTTPS 전체 주소를 넣으세요. 짧은주소도 예시입니다. 첫 행을 처리하면 상태가 DONE으로 바뀌고, 오른쪽 칸에는 응답으로 받은 주소가 들어갑니다. 열을 늘릴 수 있다면 link_id와 error_code도 두세요. 링크를 찾을 때는 ID를, 시트에서 실패를 걸러낼 때는 오류 코드를 쓰면 됩니다.

행의 이름과 변경 번호를 따로 둡니다

row_id는 시트를 다시 정렬한 뒤에도 같은 링크를 찾기 위한 값입니다. 책방 예제에서는 book-fair-email을 chck.my에 보내는 externalId로 씁니다. 같은 워크스페이스에서 해당 값으로 링크를 찾거나 아직 없으면 만듭니다. 여러 시트가 한 워크스페이스를 공유한다면 책방 이름이나 캠페인 구분자를 앞에 붙여 값이 겹치지 않게 하세요.

선택 헤더인 Idempotency-Key는 요청 한 번을 가리킵니다. 첫 발급 요청은 links.book-fair-email.v1로 보내고, 응답을 받지 못해 다시 시도할 때도 같은 값과 동일한 본문을 보냅니다. 목적지 수정이 승인됐다면 같은 externalId를 유지하고 revision을 2로 올려 links.book-fair-email.v2를 사용합니다. 이렇게 하면 같은 공개 주소의 목적지를 갱신할 수 있습니다. 수정된 행을 다시 시도할 때도 같은 번호를 유지하세요. 재시도에 사용할 변경 번호도 시트에 함께 기록하세요.

워크플로를 한 행으로 시작합니다

Pro 또는 Team 워크스페이스, 읽기·쓰기 범위의 chck.my API 키, 편집 가능한 테스트 시트, n8n 실행 환경이 필요합니다. n8n에서 시트를 읽고 수정할 Google 자격 증명도 준비하세요. n8n 호스팅이나 연결한 외부 서비스에는 별도 비용이 있을 수 있으니 먼저 이용 중인 계약을 확인합니다.

  1. Manual Trigger → Google Sheets의 Get Row(s). 첫 실행에서는 row_id로 테스트 행 하나만 읽습니다. 이후 여러 행을 처리할 때는 READY인 행을 대상으로 삼고, 필터가 여러 행을 찾으면 모두 반환하도록 설정합니다.
  2. HTTP Request. 메서드는 PUT, 주소는 아래 개발자 문서에 나온 기본 URL에 /links/upsert를 붙인 값입니다. 인증에 Generic Credential Type의 Header Auth를 선택해서 이름은 Authorization, 값은 Bearer 뒤에 공백과 발급 키를 둡니다. 이 값은 n8n 자격 증명에 저장합니다. 요청 본문 유형은 JSON으로 지정하고, url에 input_url을, externalId에 row_id를 연결합니다. Idempotency-Key 헤더는 행 ID와 변경 번호로 구성합니다.
  3. 응답 확인 → Google Sheets의 Update Row. Include Response Headers and Status와 Never Error를 켜면 HTTP 응답의 상태별로 분기하기 쉽습니다. 성공 경로에는 2xx이고 응답 본문에 shortLink가 있는 경우만 연결합니다. 처음 읽은 행의 row_id로 기존 행을 찾아 short_url에 shortLink, link_id에 id, status에 DONE을 씁니다. 실패 경로에는 상태와 오류 코드만 기록하고 공개 주소 칸은 그대로 둡니다.

노드를 연결한 뒤 한 행을 실행하고, 같은 입력으로 한 번 더 실행해 id와 shortLink가 같은지 비교하세요. 시트를 정렬한 뒤에도 결과가 같은 row_id에 기록되는지 봅니다. 요청 이후 시트 저장에 실패했다면 API에서 이미 링크를 만들었을 수 있습니다. 요청 내용을 유지한 채 같은 키로 다시 실행하고 반환된 값을 시트에 적습니다.

멈춘 행만 다시 돌립니다

429가 오면 응답의 Retry-After를 확인하고 기다린 뒤 해당 행만 제한된 횟수로 다시 보냅니다. 네트워크 오류나 타임아웃은 HTTP 응답 분기와 별도로 n8n의 오류 경로에서 수집하세요. 이미 읽은 원본 행의 ID와 변경 번호를 남겨 두면 어느 작업을 다시 호출해야 하는지 찾을 수 있습니다.

400이면 URL과 입력을 확인합니다. 401은 키 상태를, 403은 플랜과 키 범위, 워크스페이스 권한을 확인할 차례입니다. 409가 오면 같은 키로 입력을 바꿨는지나 ID 충돌이 있는지 살펴봅니다. 410은 이전 작업의 결과 링크가 삭제됐거나 결과를 반환하는 30일이 지났다는 뜻일 수 있습니다. 링크 목록에서 기존 결과를 확인하세요. 422이면 목적지가 URL 안전 정책에 걸렸는지도 확인합니다.

실행 이력에는 요청과 응답이 남을 수 있습니다. 공유 시트에는 공개해도 되는 목적지만 두고, 키는 n8n 자격 증명에서 관리하세요. 키가 노출되면 chck.my에서 폐기한 뒤 새 키를 발급하고 n8n 자격 증명을 교체합니다. 시트 편집 권한도 담당자 변경 시 함께 확인하세요.

시작하려면 아래 개발자 문서에서 API 키 준비물과 링크 upsert 응답 예시를 열어 두고, 테스트 행 하나로 처음부터 끝까지 실행해 보세요. 사람이 주소를 열어 볼 수 있고 같은 행을 다시 실행해도 링크가 하나라면, 다음 캠페인에서는 시트에 여러 줄을 넣고 실패한 줄만 골라 처리할 수 있습니다.

참고 자료

단축 URL 자동화n8nGoogle Sheets단축 URL API

함께 읽으면 좋은 글