More than 1 year has passed since last update.

SaaS連携をノーコードで実現するiPaaS「BizteX Connect」でGmailの添付ファイルをfreeeに連携してみる

Posted at 2021-12-06

この記事はWeb API Advent Calendar 2021 の7日目の記事です。

6日目は @nanoka さんの記事でした。

BizteXでプロダクトマネージャー(PM)をしている大坪です。
今回は弊社で開発・提供しているiPaaS「BizteX Connect」の紹介記事として、簡単なAPI 連携する例についての記事を書いてみます。

BizteX Connect とは

BizteX Connect はノーコードでkintoneやfreee、Slackなど様々なサービス間を主に Web API で連携するiPaaSです。詳細は下記製品ページをご参照ください。

twitterに1分動画もアップロードされていたので下記も雰囲気を見てもらう上ではわかりやすいかと思います。

特徴をまとめると下記になります。

簡単操作で様々なサービス連携が可能(2021/12時点で連携サービス数 31)
クラウドRPA「BizteX cobit」と標準連携
よくある自動化の雛形をまとめたシナリオテンプレート機能
toB 向けの管理機能(SAML認証・組織管理・実行結果ダッシュボード etc)
大きめのファイルサイズのアップロードも対応可能

Gmailで受信した添付ファイルをfreeeに連携するシナリオを作ってみる

Connectでは自動化フローをシナリオと呼びます。
使い方の具体例として、タイムリーな話題の電子帳簿保存関連(ちょうど今日２年の猶予を設けるとのニュースが出てました)で、Gmailに添付されて送信されてきた請求書ファイルを、freee会計に連携(ファイルボックスに自動保存)する シナリオを設定してみます。

完成イメージ

シナリオを作成する

1.新規シナリオを作成する

ログイン後のConnectのシナリオの一覧画面です。

左のメニューボタンから新規シナリオを作成します。

2.シナリオの名前や説明文を設定する

新規作成ボタンを押すと新規シナリオの編集画面が表示されます。

左側にあるのがシナリオの基本的な情報の設定欄です。シナリオの名前や説明文、検索などで利用できるタグを設定できます。

3.Gmailの連携設定を行う

ここからGmail→freee連携の設定を行っていきます。
最初に「Gmailの新規受信」についての設定を行っていきます。
設定の手順の概要は下記のようになっています。

連携したいアプリ(サービス)を選択
検知したいイベントや、行いたいアクションを選択
API利用のための認証情報を設定
各種パラメータを設定
連携設定のテストを行う（任意）

1~5までが1つのアプリを連携する場合の設定になります。Connectではこの処理の単位をステップと呼んでいます。シナリオの設定ではステップの設定を行いたい処理の数分設定していきます。
ここから最初のステップである「Gmailの新規メール検知」を設定していきます。

1.アプリ選択でGmailを選択

2.イベントで新規

3.認証コネクタを選択

登録済みの認証情報(認証コネクタ)がある場合、それらを利用することもできます。
ここでは新規作成をしていきます。

「＋新しいコネクタを作成する」を選択すると認証情報を設定するモーダルが表示されます。
認証コネクタの名前を入力して認証ボタンを押します。

GmailのAPIはOAuth認証に対応しているので、認証ボタンを押すとアカウント連携や権限スコープなどの確認を行うポップアップウィンドウが表示されます。

「許可」のボタンを押すと認証コネクタが保存できるようになるので、保存して選択します。

4.各種パラメータを設定する

添付ファイルをfreeeに連携するメールの条件を設定します。ここでは「メール件名に請求書を含む」「添付ファイルが存在する」メールを対象にします。

※フィルタ種別でカスタムを利用するとGmailが検索フィルタで利用できるクエリを直接記述して複雑な条件を指定することもできます

5.テスト実行をする

1-4まででステップの設定は完了です。Connectでは設定した内容が意図したとおりの処理を実現できるか？を確認したり、実際のデータを取得するために、ステップ単位でのテスト実行機能が存在しています。
テスト実行ボタン押すと、現在の受信トレイを検索し、条件に当てはまるメールのサンプルデータを取得できます。