> This page is for 플랫폼, version 레거시.
> For other versions, use one of these documentation indexes:
> - V4 (default): https://next.developer.frame.io/platform/v4/llms.txt
> - V4 실험적: https://next.developer.frame.io/platform/v4-experimental/llms.txt
> - 레거시: https://next.developer.frame.io/platform/v2/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://next.developer.frame.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://next.developer.frame.io/_mcp/server.

# Zapier의 웹훅

## 개요

이 가이드에서는 Frame.io의 특정 팀에 대한 웹훅 이벤트를 생성하고, 이를 사용하여 [Zapier](https://zapier.com)로 페이로드를 전송하는 방법을 알아봅니다. 이 시나리오에서 Zapier는 중재자 역할을 합니다. 즉, Frame.io에서 보내는 훅을 "catch(가져오기)"한 다음, 해당 훅의 데이터를 사용하여 다른 시스템과 상호 작용할 수 있습니다.

대부분의 경우 Frame.io의 Zapier 연동은 수동으로 웹훅을 관리할 필요 없이 Frame.io에서 데이터를 가져올 수 있는 네이티브 "트리거"를 지원합니다(예: 에셋 생성 시). 이 가이드에서는 Frame.io에서 새 프로젝트가 생성될 때 반응하는 방식 등 현재 네이티브 트리거가 지원하지 않는 워크플로에 중점을 둡니다.





먼저, Frame.io의 팀에서 새 프로젝트가 생성될 때 알림을 보내도록 웹훅을 설정합니다. 그런 다음 Frame.io의 Zapier 앱을 사용하여 알림을 가져오고, 해당 프로젝트에 대한 일부 정보를 Google Sheets에 전달합니다.




<Info title="따라하기">
  


이 가이드를 진행하려면 Frame.io와 Zapier 화면을 왔다 갔다 해야 합니다. 최상의 결과를 얻으려면 두 개의 앱을 나란히 열어두고 따라 하시는 것을 권장합니다.



</Info>


### 필요한 항목




시작하기 전에 다음 세 가지가 필요합니다.




1. Frame.io 계정 액세스 권한 (토큰을 생성하기 위해)
2. Frame.io 특정 팀에 대한 팀 관리자 또는 관리자 액세스 권한 (웹훅을 생성하기 위해)
3. Zapier 계정.

처음 두 가지를 확인하려면 [developer.frame.io](/)로 이동하여 로그인하세요. &quot;Tokens&quot; 및 &quot;Webhooks&quot; 메뉴 항목(아래 참조)이 보이지 않는다면 Frame.io 계정 담당자에게 문의하세요. <img alt="Frame.io 개발자 사이트의 도구들" src="/_fern-img/532acdfe86b5d1062e4c0910d46f517391c6d3ce397a444c9a7c70d4844777c6.webp" />

## 1단계: API 토큰 생성

이 가이드를 완료하려면 우리가 전송할 웹훅의 권한과 일치하는 [권한](doc:authentication)을 가진 API 토큰이 필요합니다. 아래 권한을 포함하여 Zapier에 연결된 토큰이 이미 있다면 해당 토큰을 그대로 사용해도 됩니다. 그렇지 않다면:

새 토큰에 설명이 포함된 이름을 지정하고 다음 권한을 선택하세요.



* **Projects:** Read




## 2단계: Zapier에서 웹훅 생성

**Zapier 환경:** 트리거 앱으로 &quot;**Webhooks by Zapier**&quot;를 선택하고, 원하는 트리거 동작으로 &quot;**Catch Hook**&quot;을 선택하세요. <img alt="Zapier에서 Trigger 선택" src="/_fern-img/4548e8f93431a9ffad637e3085f495a91ba3afb3493c4e7922a3791ff72c2660.webp" />저장 후 다음 선택적 단계를 건너뛰면 `https://hooks.zapier.com/…`<img alt="Zapier에 URL 입력" src="/_fern-img/11e5976804ba8b3a9f980bdfbe603bd5a0b8732b9d9852067fe2f53c0d3c27f3.webp" />으로 시작하는 URL이 표시된 화면이 나타납니다.**이 화면에서:**
1. 이 URL 복사
2. Zapier를 열어두세요
3. 별도의 탭이나 창에서 Frame.io Developer 환경으로 돌아갑니다.





## 3단계: Frame.io에서 웹훅 이벤트 설정

**Frame.io Developer 환경으로 돌아가기:**[Webhooks](https://developer.frame.io/webhooks)로 이동하여 다음 조건으로 새 웹훅을 생성하세요.
1. 설명이 포함된 이름.
2. 이전 단계에서 복사한 URL.
3. 이 훅이 작동하기를 원하는 팀.
4. 훅과 연결하려는 Frame.io 이벤트(이 가이드의 경우: Projects -&gt; Created).

<img alt="새 웹훅" src="/_fern-img/c72e9b4cb11c6cc2644cfe830e15439ef3c460a52831b286af2db7e31f30b891.webp" />**Create** 버튼을 클릭하여 새 웹훅을 저장하고, 다시 Zapier로 돌아갑니다.

## 4단계: 테스트 훅 전송

**요약하자면, 이제 우리는 다음을 갖추게 되었습니다.**
1. 특정 팀에 프로젝트를 생성할 때 실행될 Frame.io의 웹훅 구성.
2. Frame.io에서 새 프로젝트 정보를 기다리는 Zapier의 웹훅 트리거.





이제 실제로 프로젝트를 생성하여 Zapier로 데이터를 전송해 보겠습니다.





### a) Zapier 환경: 웹훅 가져오기 준비

2단계에서 남겨둔 화면에서 &quot;**Ok, I did this.**&quot;를 클릭하세요. 이렇게 하면 Zapier가 지정된 URL에서 이벤트를 캡처하도록 준비됩니다. <img alt="웹훅" src="/_fern-img/991de8bcd401ac6cfa4174f640e7a56bb146a05114524be23cc7759769af492e.webp" />

### b) Frame.io 환경: 새 프로젝트 생성




구성된 팀에서 새 프로젝트를 생성하고 원하는 설정을 적용하세요.





이렇게 하면 웹훅이 전송되고, Zapier가 이를 가져오게 됩니다. 응답으로 Zapier에서 새 훅을 확인하는 메시지가 표시되어야 하며, 이를 펼쳐보면 Frame.io에서 보낸 전체 웹훅 페이로드를 볼 수 있습니다.

**축하합니다**! **Continue**를 누른 후, 스스로에게 가볍게 하이파이브를 해주세요. 이제 어려운 부분은 끝났으므로 Webhook을 사용하여 작업을 *수행*할 수 있습니다!

## 5단계: 프로젝트 가져오기




### a) Frame.io Action 추가

&quot;**+ Add a Step**&quot;을 클릭하고 Frame.io를 검색하세요. Frame.io 앱을 선택한 후 **Find Project** 작업을 선택하세요. 이제 &quot;**Save + Continue**&quot;를 클릭하세요.

### b) Frame.io 계정 연결

다음 화면에서 &quot;**Connect an Account**&quot;를 클릭하고, 이어지는 팝업창에 (1단계에서 생성한) Frame.io API 토큰을 입력하세요. 그사이 토큰을 잊어버렸거나 분실했더라도 걱정하지 마세요. [계정 설정](https://app.frame.io/account?k=tokens)에서 새 토큰을 생성하기만 하면 됩니다. 단, 반드시 &quot;**Project**: Read&quot; 권한을 선택해야 합니다. &quot;**Continue**&quot;를 클릭하세요.

### c) 프로젝트 가져오기

다음 화면에서 목록 하단에 있는 **Project** 필드의 맨 우측 화살표를 클릭하고 **Use a Custom Value**를 선택하세요. 그런 다음 새로 나타난 &quot;Custom Value for Comment ID&quot; 필드에서 우측의 아이콘을 클릭하고 이어서 나타나는 드롭다운 메뉴에서 `Resource ID`를 선택하세요. <img alt="프로젝트 가져오기" src="/_fern-img/ec47b4df78af3d87eb9f501280dd49092d5d33047d2d89bb79acc03fcf999f38.webp" />
<Info title="이것은 일반적인 패턴입니다.">
  모든 이벤트에서 항상 최신 데이터로 작업하려면 Frame.io와 Zapier 간에 웹훅을 설정할 때 항상 이 **Custom Value** + **Resource ID** 패턴을 따라야 합니다. 이 패턴은 네이티브로 지원되는 Trigger에도 동일하게 적용됩니다!
</Info>
 이제 &quot;**Continue**&quot;를 클릭하세요. 다음 화면에서 Zapier가 Project ID를 정상적으로 가져왔는지 확인한 후 &quot;**Fetch + Continue**&quot;를 클릭하세요. 가져오기 작업이 완료되면 아래와 같은 화면이 나타납니다. <img alt="가져오기 완료" src="/_fern-img/25b9c67c00d762c5d3719705298368c16fcc8ba0c05869e54a83d283c865fdab.webp" />

훌륭합니다! 이제 Zapier에서 새 프로젝트에 대한 모든 정보를 얻었으므로, 다음과 같은 여러 시스템에 데이터를 전달할 수 있습니다.



* Google Sheets
* Airtable
* Asana
* Trello
* Jira

…그리고 약 3,000개 이상의 다양한 시스템들.

Zap의 나머지 부분 구축을 완료했다면, &quot;On(켜기)&quot;으로 전환하기만 하면 됩니다!