keyboard_arrow_up

    Webhookと帳票出力APIを使って決裁後に帳票を添付したメールを送信する

    経路のWebhookと帳票出力APIを利用し、決裁時に帳票を添付してメールを送信するサンプルです。
    ※Webhookの受信先は、Zapierを利用します。

    サンプルについて

    本サンプルのソースコードについてや、カスタマイズ方法等の技術的なお問合せは承っておりません。

    事前準備

    認証キーの作成

    1. システム管理者のユーザーで、コラボフローにログインします。
    2. システム管理エリアの環境設定画面を開き、REST APIの設定を表示します。
    3. 任意のクライアント名を入力し、認証タイプに「HTTPヘッダー認証」を選択します。
    4. [APIキーを発行する] をクリックして、APIキーを取得します。
    5. REST APIを実行するユーザーのIDとAPIキーを組み合せた文字列「{ユーザーID}/apikey:{APIキー}」を、BASE64に変換し認証キーを取得します。

    ※Base64のエンコードは、 Web上の無料サイト 等で行えます。

    例：ユーザーID「taro」、APIキー「qQzEC6cUAZfV03RvbABYm40L5mC6qUFn」の場合

    「taro/apikey:qQzEC6cUAZfV03RvbABYm40L5mC6qUFn」

    → dGFyby9hcGlrZXk6cVF6RUM2Y1VBWmZWMDNSdmJBQlltNDBMNW1DNnFVRm4=

    出力する帳票IDの確認

    1. アプリ設定権限のユーザーで、コラボフローにログインします。
    2. コラボフローのアプリ設定＞フォーム設定から対象の経路設定画面を表示します。
    3. 帳票設定タブを表示します。
    4. 帳票IDを確認し、IDを控えておきます。

    1. Zapierで、WebhookのURLを取得する

    1. Zapierにログインします。
    2. [Create Zap] をクリックします。
    3. Search apps... から Webhooks by Zapier を検索し、Webhooks by Zapierをクリックします。
    4. Event から Catch Hook を選択します。
      [Continue] をクリックします。
    5. [Continue] をクリックします。
    6. [Copy] をクリックし、Your webhook URLのURLをコピーし、控えます。

    2. コラボフローで、経路のWebhookを設定する

    1. コラボフローにアプリ設定権限のあるユーザーでログインします。
    2. アプリ設定 ＞ 経路設定から、対象の経路の編集画面を表示します。
    3. 経路のWebhook設定 を参考に、1章で取得したWebhookのURLを設定します。
    4. 通知条件で、経路終了時の通知にチェックを入れます。
    5. [保存] をクリックします。

    3. Zapierで、Webhookのテストを行う

    1. コラボフローにて、手順2で作成した経路で申請を行います。
    2. 申請した申請書を決裁し、Webhookの通知を行います。
    3. 章1のZapierのTriggerで、[Test trigger] をクリックします。
    4. 通知されたWebhookの内容が読み込まれていることを確認します。

    4. Zapierで、帳票出力APIの実行設定を行う

    1. [+] ボタンの下にある項目 [2. Action] をクリックします。
    2. Search apps... から Webhooks by Zapier を検索します。
    3. Event から POST を選択します。
      [Continue] をクリックします。
    4. 帳票出力APIのURLを入力します。
      URL内の{document_id}と{app_cd}については、以下の動画を参考に、章1のWebhookで取得した内容を設定します。
      https://cloud.collaboflow.com/{インスタンス名}/api/index.cfm/v1/documents/{document_id}/prints/{事前準備で取得した出力対象の帳票ID}?app_cd={app_cd}
    5. Headers の左の項目に、X-Collaboflow-Authorizationを入力します。
    6. Headers の右の項目に、「Basic」固定文字＋半角空白＋「事前準備で取得した認証キー」を入力します。
      例：Basic dGFyby9hcGlrZXk6cVF6RUM2Y1VBWmZWMDNSdmJBQlltNDBMNW1DNnFVRm4=
    7. [Continue] をクリックします。
    8. [Test & review] をクリックします。
    9. [Continue] をクリックします。

    5. Zapierで、メール送信の設定を行う

    1. Search apps... から email by zapier を検索し、Email by Zapier をクリックします。
    2. Event から Send Outbound Email を選択します。
      [Continue] をクリックします。
    3. メールの送信先 (To）を入力します。
    4. メールの件名（Subject）を入力します。
    5. メールの本文（Body）を入力します。
    6. Attachment をクリックします。
      章4の実行結果（帳票出力のファイル）を選択します。
    7. メールの送信内容を確認し、[continue] をクリックします。
    8. [Test & Continue] をクリックします。
      ※Testせずに終了する場合は、[Skip Test]をクリックします。
    9. 右上にある [Publish] をクリックします。
    10. [Publish & Turn On] をクリックします。

    補足

    関連記事

    関連記事

    この記事の内容