이 자격 증명을 사용하여 다음 노드를 인증할 수 있습니다.

• Facebook Trigger

지원되는 인증 방식#

• 앱 액세스 토큰

관련 리소스#

이 서비스에 대한 자세한 내용은 Meta의 Graph API 문서를 참조하세요.

앱 액세스 토큰 사용하기#

이 자격 증명을 구성하려면 Meta for Developers 계정과 다음이 필요합니다.

• 앱 액세스 토큰(Access Token)
• (선택 사항) 앱 시크릿(App Secret): 페이로드의 무결성과 출처를 검증하는 데 사용됩니다.

자격 증명을 설정하는 과정은 다섯 단계로 구성됩니다.

1. Webhooks 제품이 포함된 Meta 앱 생성
2. 해당 앱에 대한 앱 액세스 토큰 생성
3. Facebook 트리거 구성
4. 선택 사항: 앱 시크릿 추가
5. 앱 검수(App Review): 앱 사용자가 앱 자체에 역할이 없는 경우에만 필요합니다. 자신의 내부 목적으로 앱을 만드는 경우에는 필요하지 않습니다.

각 단계에 대한 자세한 안내는 아래를 참조하세요.

Meta 앱 생성#

Meta 앱을 생성하려면:

1. Meta Developer App Dashboard로 이동하여 Create App을 선택합니다.
2. 앱 세부 정보를 입력합니다.
   • App name을 추가합니다.
   • App contact email을 추가합니다.
3. 앱을 사용하려는 방식에 맞는 Use case를 선택합니다. Webhooks 제품은 Meta의 Business 제품군에 속하므로 Other를 선택한 다음 Next를 선택합니다.
4. App type에서 Business와 Next를 선택합니다.
5. 비즈니스 포트폴리오가 있고 앱을 여기에 연결할 준비가 되었다면 해당 비즈니스 포트폴리오를 선택합니다. 비즈니스 포트폴리오가 없거나 아직 연결할 준비가 되지 않았다면 No business portfolio selected로 둡니다.
6. Create app을 선택합니다.
7. Add products to your app 페이지가 열립니다. Webhooks를 선택합니다.

앱 생성, Privacy Policy URL과 같은 필수 항목, 제품 추가에 대한 자세한 내용은 Meta의 Create an app 문서를 참조하세요.

Meta 앱을 라이브(Live)로 전환하기#

1. 왼쪽 메뉴에서 App settings > Basic을 선택합니다.
2. Privacy Policy URL을 입력합니다. (앱을 Live로 전환하기 전에 필수입니다.)
3. Save changes를 선택합니다.
4. 앱에 역할이 없는 사용자도 인증할 수 있게 하려면 App Mode를 Development에서 Live로 전환합니다.

앱 모드와 Live 모드로 전환하는 방법에 대한 자세한 내용은 App Modes와 Publish | App Types를 참조하세요.

앱 액세스 토큰 생성하기#

다음으로, n8n 자격 증명과 Webhooks 제품에서 사용할 앱 액세스 토큰을 생성합니다.

1. 별도의 탭이나 창에서 Graph API explorer를 엽니다.

2. Access Token 섹션에서 방금 생성한 Meta App을 선택합니다.

3. User or Page에서 Get App Token을 선택합니다.

4. Generate Access Token을 선택합니다.

5. 로그인하고 액세스를 승인하라는 메시지가 표시됩니다. 화면의 안내를 따르세요.
   

   앱을 사용할 수 없음

   앱을 사용할 수 없다는 경고가 표시될 수 있습니다. 앱을 라이브로 전환한 후 액세스 토큰을 생성할 수 있게 되기까지 몇 분 정도 지연될 수 있습니다.

6. 토큰을 복사하여 n8n 자격 증명의 Access Token에 입력합니다. Webhooks 구성에도 필요하므로 이 토큰을 다른 곳에도 저장해 두세요.

7. n8n 자격 증명을 저장합니다.

토큰 생성에 대한 자세한 내용은 Meta의 Your First Request 안내를 참조하세요.

Facebook Trigger 구성하기#

토큰을 확보했으니 이제 Facebook Trigger 노드를 구성할 수 있습니다.

1. Meta 앱의 상단 내비게이션 바에서 App ID를 복사합니다.
2. n8n에서 Facebook Trigger 노드를 엽니다.
3. App ID를 APP ID 필드에 붙여넣습니다.
4. Execute step을 선택하여 트리거를 리스닝 모드로 전환합니다.
5. Meta 앱의 Webhooks 제품 구성이 열려 있는 탭이나 창으로 돌아갑니다.
6. Facebook Trigger 알림을 받고자 하는 객체를 Subscribe합니다. 각 구독에 대해:
   1. n8n에서 Webhook URL을 복사하여 Meta App의 Callback URL로 입력합니다.
   2. 위에서 복사한 Access Token을 Verify token으로 입력합니다.
   3. Verify and save를 선택합니다. (n8n 트리거가 리스닝 중이 아니면 이 단계는 실패합니다.)
   4. User와 같은 일부 웹훅 구독은 개별 이벤트를 구독하라는 메시지를 표시합니다. 관심 있는 이벤트를 구독하세요.
   5. Meta에서 몇 가지 Test 이벤트를 보내 정상 작동 여부를 확인할 수 있습니다. 테스트 이벤트를 보냈다면 n8n에서 수신 여부를 확인하세요.

자세한 내용은 Facebook Trigger 노드 문서를 참조하세요.

선택 사항: 앱 시크릿 추가하기#

보안을 강화하기 위해 Meta는 App Secret 추가를 권장합니다. 이렇게 하면 모든 API 호출이 appsecret_proof 매개변수로 서명됩니다. 앱 시크릿 프루프는 앱 시크릿을 키로 사용하여 액세스 토큰을 sha256으로 해시한 값입니다.

앱 시크릿을 생성하려면:

1. Meta에서 앱을 보는 중에 왼쪽 메뉴에서 App settings > Basic을 선택합니다.
2. App secret 필드 옆의 Show를 선택합니다.
3. Facebook 계정 자격 증명을 다시 입력하라는 메시지가 표시됩니다. 입력하면 Meta가 App Secret을 표시합니다.
4. 이를 드래그하여 선택하고 복사한 다음, n8n 자격 증명의 App Secret에 붙여넣습니다.
5. n8n 자격 증명을 Save합니다.

자세한 내용은 App Secret 문서를 참조하세요.

앱 검수#

App Review에는 Business Verification이 필요합니다.

다음 중 하나에 해당하는 사용자가 앱을 사용하는 경우 앱은 App Review를 거쳐야 합니다.

• 앱 자체에 역할이 없는 경우
• 앱을 소유한 Business에 역할이 없는 경우

앱 사용자가 모두 앱 자체에 역할이 있는 사용자뿐이라면 App Review가 필요하지 않습니다.

App Review 절차의 일부로, 웹훅 구독에 대한 고급 액세스(advanced access)를 요청해야 할 수도 있습니다.

자세한 내용은 Meta의 App Review와 Advanced Access 문서를 참조하세요.

일반적인 문제#

미검증 앱 제한#

Facebook은 Meta Verified Business Account에 연결되지 않은 앱에 대해 개발자 또는 관리자 역할을 최대 15개까지만 허용합니다.

이 한도를 초과했다면 Limitations | Create an app을 참조하세요.