SuperSaaSの便利な機能の一つがクレジットシステムです。エンドユーザーが一度クレジットを購入すれば、毎回決済プロセス全体を経ることなく、簡単に予約の支払いができます。 クレジット残高に影響を与えるものは複数あります。 クレジットの購入や新しい予約はもちろんのこと、キャンセルされた予約による返金や、スーパーユーザーによる手動のクレジット調整も含まれます。
ユーザーのクレジット残高に影響を与えたアクションを詳しく調べることが役立つ場合があります。しかし、購入履歴と予約履歴から何が起きたかを把握するのは、必ずしも簡単ではありません。 このような状況では、PipedreamのインテグレーションとSuperSaaS、Google Sheetsを組み合わせることで、クレジットに影響するすべてのイベントのジャーナルを表示するのに非常に便利です。
この記事は、Pipedream（強力なAPIインテグレーションサービス）を使って、Google Sheetにユーザーのクレジット情報を記録するための設定を行うステップバイステップのチュートリアルです。
このチュートリアルを終えると、スプレッドシートは次のようになります：
Pipedreamアカウントとスプレッドシートの作成
Pipedreamの仕組みは、ワークフローを作成することです。ワークフローとは、SuperSaaSやGoogle Sheetsなど、複数のサービスを接続できる情報フローのことです。 この特定のユースケースでは、1つのワークフローで十分です。
最初に行う必要があるのは、SuperSaaSとPipedream.comのアカウントを作成することです。続行する前に認証済みであることを確認してください。
認証が完了したら、PipedreamアカウントのWorkflowsページに移動し、New Workflowボタンをクリックして新しいワークフローを作成し、Add Triggerボタンをクリックしてトリガー条件を追加します。
SuperSaaSの接続
次に、SuperSaaSのクレジット関連イベントをリッスンするワークフロートリガーを設定します。
検索バーにSuperSaaSと入力し、結果のリストからそれを選択します。次に、Credit Balance Changesトリガーを選択してクリックします。これでトリガーが設定されたワークフローができましたが、まだトリガーをSuperSaaSアカウントに接続する必要があります。右側パネルの青いConnect a SuperSaaS accountをクリックし、アカウント名とAPIキーを入力します。
ダイアログの指示に従って、PipedreamアカウントとSuperSaaSアカウントの間の接続を作成します。
SuperSaaSのAPIキーは、アカウント情報ページの下部で取得し、api_keyフィールドに入力してSaveボタンをクリックします。
次に、ユーザーがクレジットを使用する可能性のあるすべてのスケジュールを選択します。このワークフローは他のスケジュールで使用されたクレジットを追跡しないため、スプレッドシートにデータが欠けないよう、すべてのスケジュールを選択してください。
Save and continueボタンをクリックし、SuperSaaSでテスト用のクレジット変更イベントを生成してトリガーをテストおよびアクティブ化してください。
クレジット付きの新しいクライアントを作成すると、数秒後に次のように表示されるはずです：
青いContinueボタンをクリックして次に進み、トリガーが発生したときに実行されるアクションを追加します。
Google Sheetsのロギングステップを追加する
トリガーが設定されたので、利用可能なアクションのリストからGoogle Sheetsを選択できます。事前構築済みのAdd Single Rowが推奨されます。
青いConnect a Google Sheets accountボタンをクリックし、指示に従ってPipedreamアカウントをユーザーのクレジットログを保存したいGoogle Sheetsアカウントに接続します。
接続が完了したら、Google Sheetsを開いてクレジットログを保存するスプレッドシートを作成します。名前は自由につけることができます。その名前が次のPipedreamのドロップダウンに表示されます。
ドロップダウンから作成したスプレッドシートを選択し、次にWorksheet IDフィールドでシート/タブ名を選択します。
スプレッドシートにフィールド名のヘッダー行があるかどうかに応じて、次のフィールドでTRUEまたはFALSEを選択して続行します。
Valuesフィールドでは、テストイベントから読み込まれたデータの中から、新しい列に入力したい各フィールドを選択する必要があります。推奨されるセットアップは次のとおりです：
これにより、作成日時、イベントの種類（新規ユーザー、クレジット変更など）、ユーザーのメールアドレス、クレジット値がきれいに表示されます。
青いTestボタンをクリックし、スプレッドシートに行が作成されたことを確認します。あとはDeployボタンをクリックするだけで、パイプラインが稼働します！
動作確認のテスト！
すべての設定が完了したら、新しいアカウントを作成し、予約を行い、スプレッドシートを確認してすべてが正常に動作しているかを確認してください。ユーザーがアクションを実行するたびに、5秒未満でスプレッドシートが更新されるはずです。
通常のGoogle Sheetsのフィルターを使用して、特定のユーザーの特定の日時範囲における残高履歴を確認します。
さらに活用する
この種の自動化やサービス連携に興味があれば、あなたの特定のニーズに合った別の何かを構築したいと思うかもしれません。
その場合は、Pipedream向けに利用可能な他のSuperSaaSイベントソース/トリガーも確認してみてください：
トリガーの設定手順は、先ほど作成したクレジット残高の変更のものと常に非常によく似ているため、他のオプションも試してみる気になることでしょう。
他の出力インテグレーションは、予約が作成または更新されたときに自分にメールを送信するなど、多くの技術的な知識を必要としない場合があります—しかも無料で。
代わりにSuperSaaSのカスタムWebhooksを使用する
PipedreamでSuperSaaSのトリガーを使用している場合、実際には内部でSuperSaaSのWebhooksをPipedreamのHTTP/Webhook組み込みトリガーに対して設定しています。
SuperSaaSのプレミアムなカスタムWebhooks機能を使用すると、これを手動で行い、Changed formやSend mailイベントなど、まだPipedreamに統合されていないものを含む、可能なあらゆるSuperSaaS Webhookイベントを自分のPipedreamワークフローに転送することができます。
例えば、ユーザーの一人がフォームを更新するたびにトリガーされるワークフローを設定したいとします：Pipedreamアカウントで再度New Workflowをクリックし、HTTP / Webhook組み込みトリガーを選択します。
デフォルトのエンドポイント設定はSuperSaaS Webhooksに適しています。Save and continueをクリックします。
Save and continueをクリックし、生成されたエンドポイント（例：https://example.m.pipedream.net）をSuperSaaSのカスタムWebhooksページにコピーします。興味のあるトリガーを選択し（例：Changed form）、そのパラメータを入力し（ある場合、例：この場合は追跡するフォーム）、PipedreamのHTTPエンドポイントをターゲットURLとして使用します。
スクリーンショット内の他の既存のWebhooksはすべて、このチュートリアルの最初に設定したSuperSaaSのクレジット残高の変更トリガーによって自動的に作成・管理されています。
同じターゲットURLに対して複数のカスタムWebhooksを作成することも、特定のユースケースに適している場合は可能です。例として、クレジット残高の変更イベントソースには少なくとも3つのWebhooksが必要です。例えば：Changed user、Credit purchase、Changed appointment（追跡する各スケジュールに1つ）、そしてすべてが同じワークフローエンドポイントを指します。
カスタムWebhookを作成したら、Test webhookリンクをクリックし、次にPost payload nowボタンをクリックしてテストイベントをワークフローに送信できます。このテストイベントをワークフローの残りの設定の参考として使用できるほか、PipedreamのUIから簡単に再生してワークフロー全体をすばやく試すことができます。
ペイロードが送信されると、まもなくPipedreamワークフローに表示されるはずです。
これで、追跡しているフォームのSuperSaaSアカウントがChanged formイベントを発行したときに実行される、適切なPipedreamアクションを追加する準備ができました。
SuperSaaSに関するご質問は、サポートチームがお手伝いします。
この記事は2020年11月2日に公開された記事を書き直したものです