Zapier には、Discourse の公式統合テンプレートが多数用意されています。これらのテンプレートを使用すれば、最小限の設定で Discourse と外部アプリケーションを接続できます。以下から確認できます:
ページをスクロールして、現在利用可能な統合の一覧を表示してください。
これらのテンプレートは 2 種類に分類されます。1 つ目は、Discourse がトリガーアプリとなるタイプです。これにより、Discourse の投稿を Slack、Mattermost、Discord、Facebook グループ、Facebook ページ、Google スプレッドシート、その他のサービスに公開できます。2 つ目は、Discourse がアクションアプリとなるタイプです。これらを使用すると、WordPress や Ghost からの投稿を Discourse に公開できます。また、Twitch のライブストリームを Discourse に公開するためのテンプレートもあります。
Zapier での Discourse 認証情報の追加
Zapier の Discourse 統合を使用するには、Zap の初期設定時に、フォーラムのベース URL、Discourse のユーザー名、および API キーを追加する必要があります。
ほとんどの場合、Zap はサイトの管理者が自身の Discourse ユーザー名と API キーを使用して設定します。API キーは、Discourse の管理画面(管理 / API / キー)から作成できます。なお、完全な API キーの値は、キー作成時に一度だけ表示されるため、その時点で必ずコピーしてください。
Discourse の認証情報を Zapier に追加したら、「Continue(続行)」ボタンをクリックします。画面上に「Success(成功)」というメッセージが表示されるはずです。
Zap が取得する投稿の指定
Discourse がトリガーアプリの場合、デフォルトではサイトのすべての新しい投稿が Zap のトリガーとなります。「Edit Options(オプションの編集)」という任意のステップで、特定のトピックで投稿された場合のみ、または特定のユーザーが投稿した場合にのみ Zap がトリガーされるように制限できます。
ステップの「Topic(トピック)」ドロップダウンメニューから、Zap をトリガーする特定のトピックを選択してください。これを設定すると、選択したトピックで作成された投稿のみが Zapier によって取得されます。また、「Author(著者)」ドロップダウンメニューから、Zap の対象となるユーザー名を選択してください。これを設定すると、このユーザーが作成した投稿のみが Zapier によって取得されます。
投稿に対するより細かな制御のためのフィルターステップの追加
「Edit Options(オプションの編集)」ステップでは、Zap のトリガーとなる投稿を制御するのに十分な制御が得られない場合、Zap に任意の「Filter(フィルター)」ステップを追加できます。フィルターでできることの例として、特定のカテゴリの最初の投稿の場合にのみ Zap を実行し続けるように設定できます。フィルターを追加するには、トリガーの下にある + アイコンをクリックし、メニューから「Filter」を選択します。
フィルターを使用すると、Zap を継続する条件を設定できます。以下の例では、カテゴリ ID が 2 のトピックにおける最初の投稿の場合にのみ、処理が継続されます。
公開する Discourse コンテンツの選択
Discourse の投稿を他のアプリケーションに公開する場合、Zapier では投稿のどの部分を公開するかを選択できます。公開する内容は、対象のアプリケーションによって異なります。ここでは、Discourse の投稿を Facebook グループに公開する例を用いて説明します。
フォームの「Message(メッセージ)」フィールドで、公開されるコンテンツを設定します。投稿の全文を公開するには、「Message」ドロップダウンから「Raw」フィールドを選択してください。トピックのタイトルのみを公開するには、ドロップダウンから「Topic Title」を選択してください。
投稿またはトピックへのリンクの作成
Discourse の投稿を外部アプリケーションに公開する際、Discourse から返されるデータを用いて、投稿またはそのトピックへのリンクを作成する必要がある場合があります。そのためには、リンクを追加するフィールドに、サイトのベース URL を入力し、その後に /t/ を続けて入力してください。例えば、サイトの URL が https://discourse.example.com の場合、フォームに https://discourse.example.com/t/ と入力します。
次に、フィールドのドロップダウンメニューを開き、「Topic Slug」を選択してください。
Zapier がトピックのスラッグのプレースホルダーをフィールドに追加します。
次に、トピックのスラッグプレースホルダーの後にスラッシュ(/)を入力し、ドロップダウンメニューから「Topic ID」を選択してください。
最終的な結果は、以下のスクリーンショットのようになります。
トピック内の特定の投稿へのリンクを作成するには、フィールドにさらにスラッシュ(/)を追加し、メニューから「Post Number」を選択してください。
Zap の設定で使用したプレースホルダーの値は、新しい投稿が公開された際に、Discourse から渡された値に置き換えられることに注意してください。
テンプレートなしで統合を作成する
Zapier の統合ページに記載されているテンプレートは、Discourse と外部アプリケーションの接続を容易にするために設計されています。テンプレートが存在しないアプリケーションに Discourse を接続したい場合、または Discourse の Webhook を監視する、あるいは Discourse API に対して POST リクエストを送信する Zap を作成したい場合は、以下のガイドのいずれかを参照して実行、または修正してください:

















.