FastComments を Zapier に接続

アカウントの接続

1. Zapierで、ZapにFastCommentsステップを追加するか、Zapier App Directoryで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ページで権限を付与できます。この権限を持たない人は、同意フォームの代わりに「権限がありません」というページが表示されます。

正しいサイトの接続

同意ページでは、現在サインインしているアカウントが接続されます。複数のアカウントを管理している場合は、承認する前にアカウントスイッチャーで正しいアカウントに切り替えるか、同意ページの switch account リンクを使用してください。Zapierの接続ラベルにはサイト名が表示されるため、誤った選択は簡単に気づけます。

アクセスの確認と取り消し

すべての接続は、FastCommentsダッシュボードの Connected Apps の下に、保持している権限と最終使用日時とともに表示されます。そこで取り消すと、Zapierの接続は即座に切断され、その接続を使用しているZapは再接続されるまで停止します。Zapier側の My Apps から接続を削除することもできます。

トリガー

トリガーは FastComments で何かが起こったときに Zap を開始します。3 つすべてが即時です。FastComments はイベントが発生した瞬間に webhook を介して Zapier に送信します。アカウントをポーリングすることはなく、待機中に API クレジットが消費されることもありません。

各トリガーは完全なコメント情報を返します：id、ページ URL と URL ID、コメント投稿者の名前とメールアドレス、コメント本文（markdown と HTML の両方）、投票数、承認フラグとスパムフラグ、ロケール、ドメイン、そしてメンション。これらのフィールドは、Webhooks の「Data Structures」セクションで文書化されている webhook ペイロードと一致します。

オプション

Domain. すべてのトリガーにはオプションのドメインフィルタがあり、アカウントに設定されたドメインを一覧表示します。空白のままにすると、すべてのドメインからのイベントを受け取ります。

Include Unapproved and Spam Comments. 新しいコメントトリガーにのみ適用されます。モデレーション待ちまたはスパムとしてマークされたコメントはデフォルトでスキップされます。そのようなコメントが後で承認されると、更新されたコメントトリガーが発火します。そのため、表示されるすべてのコメントに反応する Zap は、承認フィールドにフィルタをかけた Updated Comment を使用します。

配信の仕組み

Zap をオンにすると、アカウントに webhook サブスクリプションが作成され、Webhooks ページに API ソースとして表示されます。Zap をオフにするとサブスクリプションが削除されます。Zapier の独自の制限により、1 分あたりに受け入れられるイベント数が決まります。FastComments は失敗した配信を遅延を伸ばしながら再試行し、6 日間失敗し続けるサブスクリプションは無効化します。無効化されたサブスクリプションは Webhooks ページから再有効化できるか、Zap をオフにして再度オンにするだけで新しいサブスクリプションが作成されます。

1 つのアカウントで最大 50 件の API サブスクリプションを保持できます。FastComments のトリガーを使用する各 Zap は 1 件のサブスクリプションを使用します。

アクションと検索

アクションは FastComments にデータを作成し、検索はデータを検索して後続のステップで使用できるようにします。各アクションは FastComments の REST API を呼び出し、呼び出しにかかる API クレジットを自分のコードと同様に消費します：特に記載がない限り、呼び出しごとに 1 クレジットです。

コメントの作成

ページにコメントを投稿します。

ページの作成または更新

コメントが存在する前にページレコードを作成し、一覧表示やアクセス制限ができるようにします。URL ID、タイトル、URL、そしてオプションで閲覧を許可する SSO グループ ID を受け取ります。その URL ID のページが既に存在する場合、指定されたフィールドで更新されるため、同じページに対して Zap を繰り返し実行できます。

SSO ユーザーの作成または更新

シングルサインオンユーザーを作成します。独自のユーザー ID、ユーザー名、メールアドレスに加えて、オプションで表示名、表示ラベル、アバター、ウェブサイト、グループ ID、通知およびプライバシーフラグを受け取ります。その ID のユーザーが既に存在する場合は更新されます。管理者ロールは Zapier から付与できません。

フィード投稿の作成

HTML コンテンツから FastComments フィードに投稿を作成します。著者のユーザー ID が必須です（FastComments または SSO ユーザー ID）。タイトル、タグ、リンクプレビューはオプションです。

ハッシュタグの作成または更新

コメント投稿者が使用できるハッシュタグを作成し、オプションでリンク先の URL を設定できます。タグが既に存在する場合は更新されます。

コメントのフラグ付け

コメントにモデレーターのレビュー用フラグを付けます。フラグを付けるユーザーの ID が必須です；Create Comment で返される著者 ID が使用できます。

検索

検索で何も見つからない場合でも Zap は失敗しません。Find SSO User と Find Page は Zapier の「存在しない場合は作成」オプションを提供し、何も見つからなかったときに対応する作成アクションを実行します。

Zap の例

数分で設定できるワークフローの例です。

新しいコメントの通知を受け取る。 「New Comment」トリガーの後、Slack の「Send Channel Message」または Discord の「Send Channel Message」を使用します。コメント投稿者の名前、コメント本文、ページ URL をメッセージにマッピングします。ドメインフィルターを追加して、サイトごとに異なるチャンネルへ通知できます。

すべてのコメントを記録する。 「New Comment」トリガーの後、Google Sheets の「Create Spreadsheet Row」を使用します。削除されたコメント用に別の Zap を追加し、コメント ID を含む行を追記することで、シートを監査ログとしても活用できます。

コメントが承認されたときに作者にメールを送る。 「Updated Comment」トリガーに Zapier のフィルターで Approved が true のものだけを通し、次に Gmail の「Send Email」を使用します。Updated Comment はすべての変更で発火するため、フィルターが承認時のみ Zap が動作するようにします。

コメント投稿者を CRM やメーリングリストに追加する。 「New Comment」トリガーの後、HubSpot の「Create or Update Contact」または Mailchimp の「Add or Update Subscriber」を使用し、コメント投稿者のメールアドレスで連絡先を作成または更新します。マーケティングリストに追加する前に、プライバシーポリシーと現地法を遵守してください。

フォームからコメントを作成する。 Typeform または Google Forms の「New Response」トリガーの後、FastComments の「Create Comment」を使用し、サイトでテストimonial に使用しているページ URL ID を指定します。Approved をチェックしないようにして、公開前に各コメントをレビューできます。

お知らせをフィードに投稿する。 Zapier の RSS 「New Item in Feed」トリガーの後、Create Feed Post を使用し、アイテムのタイトル、コンテンツ、リンクを投稿します。

メンバーを SSO ユーザーとしてプロビジョニングする。 Memberstack、Memberful、または独自の webhook を使用し、次に「Find SSO User」を実行し、続いて「Create SSO User」を「find or create」モードで実行します。

通報されたコメントをエスカレーションする。 「Updated Comment」トリガーに、フラグ数が 0 より大きいものをフィルタリングし、次に Trello の「Create Card」または Linear の「Create Issue」を使用して、コメント ID とモデレーションページへのリンクを添付します。

ページが公開されたらすぐに公開する。 WordPress または Ghost の「New Post」トリガーの後、Create Page を使用し、投稿の URL を指定します。これにより、最初のコメントが来る前にページが一覧に表示され、アクセス制限が適用されます。

削除されたコメントをアーカイブする。 「Deleted Comment」トリガーの後、Airtable の「Create Record」を使用し、完全なコメント内容を保存してコンプライアンス保持に備えます。

トラブルシューティング

接続時に「You do not have permission（権限がありません）」と表示される。 サインインしているユーザーが、そのアカウントのAPI管理者ではありません。 アカウント所有者にUsersページで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ページで設定されると表示されます。フィールドを空白のままにすると、すべてのドメインのイベントを受け取ります。