FastComments를 Zapier에 연결

계정 연결

1. Zapier에서 FastComments 단계를 Zap에 추가하거나 Zapier 앱 디렉터리에서 FastComments 앱 페이지를 엽니다.
2. Sign in to FastComments를 선택합니다. Zapier는 먼저 지역을 묻습니다: 계정이 EU 지역(eu.fastcomments.com)에서 생성되지 않은 경우 United States를 선택하세요.
3. FastComments 창이 열립니다. 아직 로그인하지 않았다면 로그인합니다.
4. 동의 페이지를 검토합니다. 여기에는 Zapier 애플리케이션, 연결될 계정, 요청된 권한(읽기 및 쓰기)이 표시됩니다. Approve를 선택합니다.
5. Zapier는 연결을 저장하고 사이트 이름 및 사용자 이름으로 라벨을 지정합니다.

연결은 OAuth를 사용합니다. API 키가 Zapier에 복사되지 않으며, Zapier가 보유한 토큰은 승인한 계정에만 작동합니다.

연결할 수 있는 사람

연결을 승인하는 사람은 FastComments 계정의 API admin이어야 합니다. 계정 소유자는 이 권한을 가지고 있으며, 다른 팀 구성원은 Users 페이지에서 부여받을 수 있습니다. 이 권한이 없는 사용자는 "you do not have permission" 페이지를 보게 됩니다.

올바른 사이트 연결

동의 페이지는 현재 로그인한 계정에 연결합니다. 여러 계정을 관리하는 경우 승인하기 전에 계정 전환기에서 올바른 계정으로 전환하거나 동의 페이지의 switch account 링크를 사용하세요. Zapier의 연결 라벨에 사이트 이름이 표시되므로 잘못된 선택을 쉽게 확인할 수 있습니다.

접근 검토 및 해제

모든 연결은 FastComments 대시보드의 Connected Apps에 표시되며, 보유한 권한 및 마지막 사용 시점이 표시됩니다. 여기서 연결을 해제하면 Zapier가 즉시 연결을 끊으며, 해당 연결을 사용하는 모든 Zap은 재연결될 때까지 중단됩니다. Zapier 측에서는 My Apps에서 연결을 제거할 수도 있습니다.

트리거

FastComments에서 무언가 발생하면 트리거가 Zap을 시작합니다. 세 가지 모두 즉시 작동합니다: FastComments는 이벤트가 발생하는 순간 웹훅을 통해 Zapier에 전달합니다. 계정을 폴링하는 것이 없으며, 대기하는 동안 API 크레딧이 소모되지 않습니다.

각 트리거는 전체 댓글을 반환합니다: id, 페이지 URL 및 URL ID, 댓글 작성자 이름 및 이메일, 마크다운 및 HTML 형식의 댓글 텍스트, 투표 수, 승인 및 스팸 플래그, 로케일, 도메인, 그리고 멘션. 이러한 필드는 Webhooks, Data Structures 섹션에 문서화된 웹훅 페이로드와 일치합니다.

옵션

Domain. 모든 트리거에는 선택적 도메인 필터가 있으며, 계정에 설정된 도메인 목록을 표시합니다. 비워두면 모든 도메인의 이벤트를 수신합니다.

Include Unapproved and Spam Comments. New Comment 트리거에만 적용됩니다. 검토 대기 중이거나 스팸으로 표시된 댓글은 기본적으로 건너뛰어집니다. 해당 댓글이 나중에 승인되면 Updated Comment 트리거가 해당 댓글에 대해 작동하므로, 표시되는 모든 댓글에 반응하도록 Zap을 설정하려면 승인된 필드에 필터를 적용한 Updated Comment를 사용합니다.

전달 방식

Zap을 켜면 계정에 웹훅 구독이 생성되며, Webhooks 페이지에서 소스 API와 함께 표시됩니다. Zap을 끄면 구독이 제거됩니다. Zapier 자체 제한에 따라 분당 수락 가능한 이벤트 수가 정해져 있습니다; FastComments는 실패한 전달을 점점 늘어나는 지연 시간으로 재시도하고, 6일 동안 계속 실패하는 구독은 비활성화합니다. 비활성화된 구독은 Webhooks 페이지에서 다시 활성화할 수 있으며, 또는 Zap을 끄고 다시 켜서 새 구독을 만들 수도 있습니다.

계정당 최대 50개의 API 구독을 보유할 수 있습니다. FastComments 트리거를 사용하는 각 Zap은 하나의 구독을 사용합니다.

작업 및 검색

작업은 FastComments에 데이터를 생성하고, 검색은 데이터를 조회하여 이후 단계에서 사용할 수 있게 합니다. 각 작업은 FastComments REST API를 호출하며, 호출당 귀하의 코드에서 발생하는 API 크레딧과 동일한 크레딧을 사용합니다: 별도 언급이 없는 한 호출당 1크레딧이 소모됩니다.

댓글 생성

페이지에 댓글을 게시합니다.

페이지 생성 또는 업데이트

댓글이 존재하기 전에 페이지 레코드를 생성합니다. 이를 통해 페이지를 목록에 표시하고 제한할 수 있습니다. URL ID, 제목, URL을 입력받으며, 선택적으로 해당 페이지를 볼 수 있는 SSO 그룹 ID를 지정할 수 있습니다. 해당 URL ID를 가진 페이지가 이미 존재하면 제공된 필드로 업데이트되므로, Zap이 동일한 페이지에 대해 반복 실행될 수 있습니다.

SSO 사용자 생성 또는 업데이트

싱글 사인온(SSO) 사용자를 생성합니다. 자체 사용자 ID, 사용자명 및 이메일을 입력받으며, 선택적으로 표시 이름, 표시 라벨, 아바타, 웹사이트, 그룹 ID, 알림 및 개인정보 플래그를 지정할 수 있습니다. 해당 ID를 가진 사용자가 이미 존재하면 대신 업데이트됩니다. 관리 역할은 Zapier를 통해 부여할 수 없습니다.

피드 포스트 생성

HTML 콘텐츠를 사용하여 FastComments 피드에 포스트를 생성합니다. 작성자 사용자 ID가 필요합니다(FastComments 또는 SSO 사용자 ID). 제목, 태그 및 하나의 링크 미리보기는 선택 사항입니다.

해시 태그 생성 또는 업데이트

댓글 작성자가 사용할 수 있는 해시 태그를 생성합니다. 선택적으로 해당 태그가 연결되는 URL을 지정할 수 있습니다. 태그가 이미 존재하면 대신 업데이트됩니다.

댓글 플래그 지정

댓글을 검토를 위해 플래그 지정합니다. 플래그를 지정하는 사용자의 ID가 필요합니다; Create Comment에서 반환된 작성자 ID를 사용할 수 있습니다.

검색

검색 결과가 없더라도 Zap이 실패하지 않습니다. Find SSO User와 Find Page는 Zapier의 "존재하지 않을 경우 생성" 옵션을 제공하며, 검색 결과가 없을 때 해당 생성 작업을 실행합니다.

Example Zaps

몇 분만에 설정할 수 있는 몇 가지 워크플로우.

새 댓글에 대한 알림 받기. New Comment, then Slack "Send Channel Message" or Discord "Send
Channel Message". 댓글 작성자 이름, 댓글 텍스트, 페이지 URL을 메시지에 매핑합니다. 도메인 필터를 추가하여 사이트별로 다른 채널에 알림을 보냅니다.

모든 댓글을 기록하기. New Comment, then Google Sheets "Create Spreadsheet Row". 삭제된 댓글을 두 번째 Zap으로 추가하여 댓글 ID가 포함된 행을 추가하면, 시트가 감사 로그 역할도 합니다.

댓글이 승인될 때 작성자에게 이메일 보내기. Updated Comment with a Zapier filter on Approved is true, then Gmail "Send Email". Updated Comment는 모든 변경에 대해 발생하므로, 필터가 이 Zap이 승인에만 반응하도록 합니다.

댓글 작성자를 CRM 또는 메일링 리스트에 추가하기. New Comment, then HubSpot "Create or Update Contact" or Mailchimp "Add or Update Subscriber" using the commenter email. 마케팅 리스트에 추가하기 전에 개인정보 보호정책 및 현지 법규를 준수하세요.

폼에서 댓글 만들기. Typeform or Google Forms "New Response", then FastComments Create Comment with the page URL ID your site uses for testimonials. Approved를 체크하지 않으면 댓글이 표시되기 전에 검토할 수 있습니다.

공지사항을 피드에 게시하기. RSS by Zapier "New Item in Feed", then Create Feed Post with the item's title, content, and link.

회원들을 SSO 사용자로 프로비저닝하기. Memberstack, Memberful, or your own webhook, then Find SSO User followed by Create SSO User in "find or create" mode.

신고된 댓글을 에스컬레이션하기. Updated Comment, filtered on a flag count above zero, then Trello "Create Card" or Linear "Create Issue" with the comment id and a link to the moderation page.

페이지가 실시간으로 공개될 때 게시하기. WordPress or Ghost "New Post", then Create Page with the post URL, so the page is listed and restricted before the first comment.

삭제된 댓글을 보관하기. Deleted Comment, then Airtable "Create Record" with the full comment for compliance retention.

문제 해결

연결 시 "You do not have permission" 라는 메시지가 표시됩니다. 로그인한 사용자가 계정의 API 관리자 권한이 없습니다.
계정 소유자에게 사용자 페이지에서 API 권한을 부여하도록 요청하거나 소유자 계정으로 연결하십시오.

연결이 잘못된 사이트로 표시됩니다. 동의 페이지는 당시 로그인한
계정을 연결합니다. Zapier에서 연결을 끊고, FastComments 대시보드에서 계정을 전환한 뒤 다시 연결하십시오.

이벤트가 도착하지 않습니다. 대시보드의 Webhooks 페이지를 확인하십시오. 엔드포인트가
6일 동안 계속 실패한 구독은 자동으로 비활성화되며 이유가 표시됩니다. 해당 페이지에서 다시 활성화하거나 Zap을 끄고
다시 켜십시오. 구독이 완전히 사라진 경우, 누군가 삭제한 것입니다; Zap을 끄고 다시 켜면 구독이 재생성됩니다.

Zapier에서 계정을 다시 연결해야 한다고 표시됩니다. 연결이 Connected Apps
페이지에서 취소되었거나, 승인한 사용자가 API 권한을 잃었거나, 계정이 삭제되었습니다. Zapier에서 다시 연결하십시오.

작업이 "does not have write access" 오류로 실패합니다. 연결이 읽기 전용
권한으로 승인되었습니다. 다시 연결하고 두 권한 모두 승인하십시오.

속도 제한 및 크레딧. 작업 및 검색은 플랜의 API 크레딧을 사용하며 REST API와 동일한
속도 제한을 적용받습니다. 트리거는 크레딧을 사용하지 않습니다. 제한에 걸린 Zap은
FastComments가 보고하는 지연 후 Zapier에 의해 재시도됩니다.

Domain 드롭다운이 비어 있습니다. 도메인은 FastComments 대시보드의 Domains 페이지에서
설정된 후에 나타납니다. 모든 도메인에 대한 이벤트를 받으려면 필드를 비워 두십시오.