ZapierからRobotic Crowdを起動する

概要
Robotic Crowdアプリを利用して、ワークフローを起動する方法について説明します。
このチュートリアルのゴール
Robotic CrowdアプリとGmail、Google Spleadsheetを使用したZapを作成して、Robotic Crowd に作成したワークフローを起動させます。 具体的には、
「担当者が休暇中にGmailの特定の送信者から来たメールを新たに受信したら、その内容ををRobotic Crowdへ送信し、Slackのチャネルに通知して他の社員に対応を依頼するワークフローを起動する」
というケースを試してみます。
手順
1.Robotic Crowd にワークフローを作成
2.メール情報一時保存用のGoogle SpleadSheetを準備する
3.ZapierでZapを作成する
4.メールを送信してZapを起動し、Robotic Crowd のセッションを確認
1. Robotic Crowd にワークフローを作成
Robotic Crowdに、受信したメールの情報をslackに通知するワークフローを作成します。 設定画面をエディタモードに切り替えて、以下のyamlファイルを貼り付けてください。(※slackコネクションのプロバイダーや投稿先のチャネル名はご自身の環境に合わせて設定してください。slackの設定についてはドキュメントを参照) ワークフロー内では休暇予定の日付とワークフロー実行時点の日付を比較して、休日にワークフローが実行された場合、slackで他の社員に対応を依頼するメッセージを送信する処理をしています。 ここで作成したワークフローはZapierから起動するために使用します。
1
# 休暇予定の日付を取得
2
+get_time_1:
3
  action>: GetTime
4
  format: 'YYYY-MM-DD'
5
  timezone: 'Asia/Tokyo'
6
  relativeTime:
7
    number: 3
8
    unit: day
9
    preposition: after
10
    startEndOption: ''
11
​
12
# 変数に保存
13
+store_value_1:
14
  action>: StoreValue
15
  key: holiday
16
  value: +get_time_1
17
​
18
# 今日の日付を取得
19
+get_time_2:
20
  action>: GetTime
21
  format: 'YYYY-MM-DD'
22
  timezone: 'Asia/Tokyo'
23
​
24
# 変数に保存
25
+store_value_2:
26
  action>: StoreValue
27
  key: today
28
  value: +get_time_2
29
​
30
# 今日が休日のとき
31
+if_1:
32
  if>: ${today === holiday}
33
  _do:
34
​
35
    # テキストを作成
36
    +text_1:
37
      action>: Text
38
      text: "<!here>\n本日休暇のため、以下のメールでお問い合わせ頂いている件の対応をよろしくお願いします。\n------------------------------------------------------------------------------------\n件名 ${subject}\n送信者 ${sender}\n本文 ${body}\n------------------------------------------------------------------------------------"
39
​
40
    # Slackでメッセージを送信
41
    +send_slack_message_1:
42
      action>: SendSlackMessage
43
      provider: slack_dummy1234
44
      channel: '#営業部'
45
      text: +text_1
46
      send_select: false
47
      response_message: false
48
      meta:
49
        display:
50
          provider:
51
            type: chip
52
            label: 'Slack (Tutorial Inc.)'
53
            icon: slack
Copied!
2. メール情報一時保存用のGoogle SpleadSheetを準備する
ZapierのGmailアプリでは、Gmailから取得した情報を直接利用することができる外部アプリが制限されているため、一時的にメールから取得した情報をスプレッドシートに記録しておくことで取得したメール情報をRobotic Crowdアプリに送信できるようにします。
以下の例を参考にスプレッドシートを新規作成します。 1行目に入力されている件名, 送信者, 本文といった項目はあとでZapを作成する際に参照するために入力しておきます。
zapier_sample_sheet
3. ZapierでZapを作成する
​zap作成画面 にアクセスして、Creat Zapボタンを選択します。
zapier_create_zap
検索ボックスに「Gmail」と入力し、表示されたGmailアプリを選択します。
zapier_select_gmail
Trigger Eventには、Gmailに事前に設定したフィルター条件で新しいメールを受信したことを検知する「New Email Matching Search」を設定します。
zapier_trigger_gmail
次にZapで利用したいGoogleアカウントを選択します。
zapier_choose_account
Search StringにはGmailでどんな条件のメールを受信したら、トリガーを起動する対象にするのかを指定することができます。 メールをフィルタリングするための構文についてはGmailヘルプ に詳しく記載されています。
今回はfrom:[email protected] と指定することで[email protected] から送信されたメールを新たに受信したときにトリガーが起動するように設定します。
zapier_filter_mail)
「Test Trigger」を押してTriggerのテストを実行します。テストに成功すれば以下のような画面になります。 これでGmailのTrigger設定は完了です。
zapier_test_gmail
次にGoogle Sheetsアプリを利用してGmailから取得したメール情報をスプレッドシートに記録するActionの設定を行います。 検索ボックスに「Google Sheets」と入力し、表示されたGoogle Sheetsアプリを選択します。
zapier_select_sheet
Action Eventには「Create Spreadsheet Row」を設定します。
zapier_create_row
Choose accountには事前に手順2で準備したスプレッドシートにアクセスできるアカウントを選択してください。
zapier_select_sheet_account
Set up actionには以下の画像のように事前に用意したシートにメールから取得した情報を記録できるように設定を行なっていきます。DriveとSpreadsheet、Worksheetには用意したシートの情報を選択し、件名、送信者、本文にはそれぞれメールのSubject、From、Bodyを紐付けます。
zapier_setup_sheet
最後にRobotic Crowdアプリを利用してワークフローを起動するActionの設定を行います。 検索ボックスに「Robotic Crowd」と入力し、表示されたRobotic Crowdアプリを選択します。
zapier_select_rc
Action Eventには「Run Workflow」を設定します。
zapier_select_wf
Choose accountには作成したコネクションを選択してください。
zapier_select_rc_conn
次に起動したいワークフローと、ワークフローに引き渡すパラメータの設定を行います。 今回は先ほど作成した「Zap Test Workflow」を起動したいワークフローとして設定します。 ワークフローに引き渡すパラメータの名前をsubject、sender、bodyを指定し、それぞれの値にスプレッドシートの件名、送信者、本文を設定します。
zapier_setup_action
テストを実行します。テストに成功すれば以下のような画面になります。 これでRobotic CrowdのAction設定は完了です。
zapier_rc_test
これまでの手順でZapの構築を完了しました。 Zapを有効化するために、「Turn on Zap」ボタンを押しましょう。
zapier_turnon_zap
4. メールを送信してZapを起動し、Robotic Crowd のセッションを確認
先程の手順で作成したZapを起動して、ワークフローを実行してみましょう。 Zapを起動するためのトリガーとして、Gmailのメール受信という操作を設定しているので、 [email protected]からメールを送信してみます。 メールを送信してから数分後に確認すると、Zapで設定したワークフローが実行されたのが確認できます。
zapier_zap_session
zapier_zap_test
slackにもメールの内容が投稿されていることが確認できました。
zapier_slack
Robotic Crowdアプリについて
利用できるTrigger
Get All Workflows Zapierで設定したコネクションに紐づくプロジェクトのワークフローを全て取得します。
利用できるAction
Run Workflow 指定したワークフローを実行します。