自動化

ワークフローの名前の入力

実行条件の選択

以下の項目から選択するパラメーターに基づいて、ワークフローを起動するタイミングを選択できます。

ワークフローの種類

ワークフローには2種類あります。

• 予定基準
• 日付基準

予定基準：ワークフローが予定基準の場合、対象のモジュールで以下の操作が行われた場合に起動されます。

• 作成
• 編集
• 作成または編集
• 削除

モジュールの操作を［編集済み］／［作成済みまたは編集済み］と選択した場合、以下の追加項目が表示されます。

日付基準：ワークフローが日付基準の場合、以下の追加項目が表示されます。

項目	説明
実行日	ワークフローを実行するタイミングを設定します。モジュールの日付、有効期限、作成日時などをドロップダウンから選択し、その前または後の日数を指定できます。
実行時間	［hh］と［mm］を選択することで、正確な実行時間を指定できます。
実行頻度	ワークフローを実行する頻度として、ドロップダウンから［一度のみ］、［毎週］、［毎月］、［年間］を選択できます。

実行条件のフィルター

実行条件のフィルターでは、処理を実行するための条件を1つ以上設定できます。

項目	説明
条件	設定した条件に基づいて、フィルターが適用されます。［+ 条件の追加］をクリックすることで、ワークフロールールが実行される複数の条件を追加できます。 次の条件は、両方の条件を含めるかどちらかの条件を含めるかに応じて、ANDまたはORになります。また、［条件を変更する］を選択すると、条件のパターンを自由に変更できます。
属性の項目	この項目では、モジュールに関連する用語を広くカバーするリストこの項目では、モジュールに関連する用語を広くカバーするリスト
ルール	システムが実行条件をフィルタリングする際の基準となるルールを選択します。 項目に英数字の値が含まれる場合、ルールは次のようになります。 項目が数値だけの場合、ルールは次のようになります。
値の項目	フィルターを適用する属性の値を入力します。

条件の編集：

要件に合わせて条件パターンを編集することができます。編集では、論理演算子の「AND」「OR」を使用して、自分の選択したパターンを定義できます。

たとえば、［見積書番号］が「1」であり、［見積書のステータス］が「未請求」かつ［総額］が「500」と等しい場合にワークフロールールを実行する場合、パターンは「(((1)AND 2) OR 3)」になります。条件パターンが要件に合わないと感じた場合は、「(1AND (2 OR 3))」のように編集することができます。

［保存］をクリックしてください。

メモ：各ワークフロールールごとに、最大10件の条件を設定できます。

アクション

ルールを設定した後、条件が満たされたときに実行する処理を指定する必要があります。ビジネスニーズに応じて、すぐに実行する処理や時間基準の処理を設定できます。

すぐに実行する処理

項目	説明
種類	3種類の処理から1つを選択します、 - メール通知 - 特定の項目の更新 - Webhook ［+ 新しい処理の追加］をクリックして、複数の処理を追加することもできます。
名前	この項目には、メール通知、特定の項目の更新、またはWebhookの名前 たとえば、メール通知の場合、すでに作成したリストから選ぶか、［+ 新しいメール通知の追加］を選択して新しいメール通知を追加することができます。 特定の項目の更新やWebhookの場合も同じ手順に従ってください。
詳細	実行する処理の詳細が表示されます。

すぐに実行する処理

特定の時間に処理したい場合、［時間基準の処理を追加しますか？］のチェックボックスにチェックを入れてください。これにより、対象の時間を入力するための追加項目が表示されます。

次は、処理の種類を選択します。メール通知、特定の項目の更新、Webhookのいずれ かを選択できます。また、［+ 新しい時間基準の処理の追加］を選択することで、複数 の時間基準の処理を追加することができます。

メモ：最大5件の時間基準の処理を追加できます。また、時間基準の処理ごとに、最大5件の処理が設定可能です。

最後に、［保存］をクリックすると、ワークフロールールが作成され、Zoho Booksのモジュールに実装されます。

その他の操作

ワークフロールールを有効／無効に設定することもできます。ワークフロールールを削除するには、ワークフローの横にあるごみ箱アイコンをクリックしてください。

ワークフロールールの編集：

ワークフロールールを編集するには、リストからワークフロールールをクリックするか、ワークフロールールにカーソルを合わせて［編集］を選択してください。

ワークフロールールのフィルタリング：

ワークフロールールをフィルタリングするには、以下の手順に従ってください。

• ［自動化］→［ワークフローのルール］の順に移動してください。
• ［タブ］の横にあるドロップダウンからいずれかを選択し、ワークフローをモジュールに基づいてフィルタリングします。

ワークフロールールは、有効／無効に基づいてフィルタリングすることもできます。選択内容に沿って、対応するワークフロールールがリストとして表示されます。

メモ：

• 各モジュールに対して、最大10件のワークフロールールを作成できます。
• Zoho Booksにインポートされた請求書には、ワークフロールールを適用することはできません。

Webhookの作成

Webhookを設定するには：

• ［設定］→［自動化］の順に選択してください。
• ［自動化］ペインで［Webhook］を選択してください。
• 右上の［+ 新しいWebhook］をクリックしてください。

• 新しいWebhookページで、以下の詳細を入力してください。
• ［名前］項目にWebhookの名前を入力します。
• ［タブ］項目の隣にあるドロップダウンから、Webhookを作成するモジュールを選択します。
• 必要に応じて、［詳細］項目にWebhookに関する詳細を追加します。

• ［URLのパラメーター］項目でHTTPメソッドを選択し、サードパーティーアプリケーションのURLを入力します。Zoho Booksで利用可能なHTTPメソッドは以下のとおりです。
  • POST：送信されたデータを新しいものとして考慮する必要があるというリクエスト
  • PUT：送信されたデータを、既存のデータの修正バージョンとして考慮するようにリクエストします。
  • DELETE：データを削除する必要があることをリクエストします。

［+ 新しいパラメーターを追加する］をクリックし、［キー］と［Value］項目に必要 な値を入力することで、クエリパラメーターを追加することもできます。認証トーク ン、セキュリティトークン、APIキーなどのカスタムパラメーターを追加できます。 Webhookを保護したい場合は、［このWebhookを保護したいです］オプションを チェックします。［シークレット］項目にシークレットキーを入力します。これは、 WebhookがZoho Booksから送信されたかどうかを確認するのに役立ちます。半角英数 字で、12～50文字の範囲で入力してください。

• ［ヘッダー］セクションでは、HTTPリクエストに追加したい情報を含めることができます。ヘッダーを追加する場合は、［+ 新しいヘッダーを追加する］をクリックします。

• ［認証の種類］セクションで、Webhookの認証方法を選択します。
  • 自己認証：このオプションを選択すると、認証の詳細を手動で入力してWebhookを設定できます。
  • コネクション：コネクションを使用してWebhookを設定するには、このオプションを選択します。コネクションの作成方法について、詳細はこちらをご参照ください。

• ［本文］セクションで、データの送信方法を選択します。［初期設定のデータの内容］、［x-www-form-urlencloded］、［生データ］パラメーターから選択できます。
  • 初期設定のデータの内容：［初期設定のデータの内容］形式では、モジュールに関連するすべてのパラメーターがapplication/json形式のコンテンツタイプでリクエストボディに送信されます。
  • x-www-form-urlencoded：［x-www-urlencoded］形式では、データはエンコードされてサーバーに送信されます。
  • 生データ：［生データ］形式では、リクエストボディに送信するパラメーターを選択できます。コンテンツタイプはapplication/jsonになります。

• ［保存して実行］をクリックしてWebhookが正しく動作することを確認するか、後で実行する場合は［保存］をクリックします。

Webhookの保護

Webhookを保護することにより、Zoho Booksから送信されたWebhookであることを確 認できます。この操作を行うには、サーバーを設定してZoho BooksからのWebhookを 受信する必要があります。サーバーは受信したWebhookのペイロードとシークレット トークンを使用してハッシュ値を生成する必要があります。生成されたハッシュ値を使 用して、Zoho Booksからのハッシュ値と一致するかどうかを検証し、Webhookの送信 元を検証します。これにより、サーバーはZoho Booksを送信元とするサードパー ティーのWebhookを無視し、追加のセキュリティレイヤーが提供されます。

Webhookの検証

サーバーがWebhookを受信すると、Zoho Booksが生成したものと同じ方法で、ペイ ロードのハッシュ値を生成する必要があります。これによって、Webhookの検証に使 用される同じハッシュ値が生成されます。

ハッシュ値の生成には、以下のパラメーターが利用可能な場合に使用されます。

• クエリ文字列パラメーター
• 初期設定のペイロードまたはカスタマイズされた生のJSONペイロード
• x-www-form-urlencodedペイロード（キーと値のペア）

ペイロードのキーと値のペアをアルファベット順にソートし、文字列を構築する必要があります。キーと値のペアは、キーに対してアルファベット順にソートされている必要があります。

例

1.初期設定のデータの内容

クエリ文字列パラメーターのキーと値のペア：

subscription\_id=90343, name=basic

初期設定のデータの内容／生データ：

{"created\_date":"2019-03-06","event\_id":"5675"}

設定される文字列：

namebasicsubscription\_id90343{"created\_date":"2019-03-06","event\_id":"5675"}

クエリ文字列パラメーターのキーと値のペア：

customer\_name=Brandon, status=active

2. x-www-form-urlencoded

x-www-form-urlencoded payload’s key-value pairs:

customer\_name=Brandon, status=active

x-www-form-urlencodedペイロードのキーと値のペア：

addon\_description=Monthly addon, quantity=1

構成される文字列：

addon\_descriptionMonthly addoncustomer\_nameBrandonquantity1statusactive

ハッシュ値は、この文字列にHMAC-SHA256アルゴリズムを適用することで、Zoho Booksで使用されたシークレットトークンと組み合わせて計算されます。

計算されたハッシュ値が、Zoho BooksからのWebhookのヘッダー（X-Zoho-Webhook-Signature）に含まれる値と一致するかどうかを確認することで、Webhookを検証できます。

SMSゲートウェイの設定

SMSゲートウェイを通じてメッセージ通知を送受信するためにWebhookを設定することができます。URLを使ってSMSゲートウェイを設定し、以下の手順に従ってください。

Bulk SMS

Bulk SMSは人気のSMSゲートウェイで、世界中の800以上のモバイルネットワークプロバイダーと互換性があります。

URL：https://bulksms.vsms.net/eapi/submission/send_sms/2/2.0?username=%username%&password=%password%&msisdn=${CONTACT.CONTACT_MOBILE_PHONE}&message=%message_content%

Bulk SMSのURLを設定するには：

• 右上の歯車（設定）アイコンをクリックし、［自動化］を選択します。
• ［Webhook］タブに移動し、［+ 新しいWebhook］をクリックします。
• 上記のURLを通知先のURL項目にコピーします。
• URLの%username%と%password%の差出人をBulk SMSアカウントのユーザー名とパスワードに置き換えます。
• URLの最後の「message=」の後にメッセージを入力します。
• メッセージ内容のすべての空白を%20に、すべてのカンマを%2Cに置き換えてください。

メモ: メッセージの内容に他の句読点がある場合は、このウェブサイトから修飾子で置き換える方法を確認できます。ただし、メッセージの構文に不可欠な句読点を置き換えないようにしてください。

空白に%20を、カンマに%2Cを使ってメッセージを書式設定すると、次のようになります。

URL：https://bulksms.vsms.net/eapi/submission/send_sms/2/2.0?username=%username%&password=%password%&msisdn=${CONTACT.CONTACT_MOBILE_PHONE}&message=Hello%20${CONTACT.CONTACT_NAME}.Thank%20you%20for%20the%20purchase%20of%20${INVOICE.INVOICE_TOTAL}

同様に、他のSMSゲートウェイも、URLを変更するだけで設定できます。

SMS-Magic

SMS-MagicのようなSMSゲートウェイは、Webを設定するために追加のエンティティパラメーターを入力する必要があります。

SMS-Magicを設定するには：

• 通知先のURL項目にURL「https://sms-magic.in/smapi/post」を入力します。
• ［エンティティパラメーターの追加］をクリックします。
• パラメーター項目に次のテキストを入力します。

<?xml version="1.0"?>
<m:Library xmlns:m="http://screen-magic.com" xmlns="http://www.defns.com">
<userid>**User_ID**</userid>
<senderid>**%Sender_ID**</senderid>
<accountid>**%Account_ID**</accountid>
<hashkey>**%hashkey%**</hashkey>
<message mobilenumber="${CONTACT.CONTACT_MOBILE_PHONE}" >
<![CDATA[${INVOICE.INVOICE_TOTAL}]]>
</message>
</m:Library>

URLの差し込み項目をSMS-MagicアカウントのユーザーID、送信者ID、アカウントIDに置き換えてください。ハッシュキーは、ユーザーID、パスワード、アカウントID、送信者IDを連結した文字列の標準ハッシュ化md5値を指します。

メモ：ハッシュ化されたmd5値を生成するには、こちらのサイトをご覧ください。

Text Local

Text Localを機能させるには、エンティティパラメーターとカスタムパラメーターが必要です。

Text Localを設定するには：

• 通知先のURL項目にURL「http://api.textlocal.in/send/」を入力します。
• ［カスタムパラメーターを追加］をクリックします。
• 送信者とapikeyパラメータを追加し、URLの差し込み項目をText Localの関連情報に置き換えます。
• ［エンティティパラメーターを追加］をクリックします。
• パラメーターに名前を付け、ドロップダウンメニューから必要な条件を選択します。例：numbers = ${CONTACT.CONTACT_MOBILE_PHONE}。
• ［ユーザー定義パラメーターの追加］ボックスを選択し、送信するメッセージと必要な差し込み項目を入力します。
• ［保存］をクリックします。

その他の操作

Webhookの削除

Webhookを削除するには：

• ［設定］→［自動化］の順に移動してください。
• ［自動化］ペインで［Webhook］を選択します。
• 削除するWebhookにカーソルを合わせ、ごみ箱アイコンをクリックします。

• 表示されるポップアップで［はい］をクリックします。

Webhookが削除されます。ワークフロールールでWebhookを使用している場合、ワークフロールールが実行されないように、必ずワークフロールールを更新してください。

Webhookのフィルタリング

Webhookをフィルタリングするには、以下の手順に従ってください。

• ［設定］→［自動化］→［Webhook］の順に移動してください。
• ［タブ］の横にあるドロップダウンから、Webhookが作成されたモジュールを選択します。
• 選択に基づいて、対応するWebhookがリストとして表示されます。

メモ：

• 各ワークフロールールに対して、1件のWebhookのみを作成できます。
• 1日につき最大500件のWebhookを実行できます。