FastComments を Zapier に接続

アカウントを接続

1. Zapier で、Zap に FastComments ステップを追加するか、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 を開始します。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 を受け取ります。

SSO ユーザー作成

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

フィード投稿作成

HTML コンテンツから FastComments フィードに投稿を作成します。オプションでタイトル、作者、タグ、1 つのリンクプレビューを指定できます。

ハッシュタグ作成

コメント投稿者が使用できるハッシュタグを作成します。オプションでリンク先の URL を指定できます。

コメントフラグ付け

コメントをモデレーターのレビュー対象としてフラグ付けします。フラグを付けるユーザーの ID を提供するか、空白のままにすると Zapier 統合としてフラグ付けされます。

検索

何も見つからない検索は Zap を失敗させません。Zapier の「find or create」モードで検索と作成を組み合わせ、対象が存在しない場合にページやユーザーを作成できます。

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 ページで設定されると表示されます。すべてのドメインのイベントを受け取るには、フィールドを空白のままにしてください。