Create conditional webhooks

You may decide that you want to trigger a webhook only if its payload meets certain conditions. For example, you could decide to calculate taxes using a third-party service for specific postal codes only. If the postal code provided in the payload does not match the selected postal code, there is no value in triggering the webhook.

A conditional webhook can significantly reduce the number of API calls, which reduces the waiting time for clients.

Conditional webhooks can have one or more rules. Each rule contains the following:

The field to be evaluated. For nested fields, use the dot-separated format, such as data.order.product.id.

An operator, which is represented as a comparison statement between the value supplied in the webhook payload and the threshold value.

The operator must be one of the following:

Operator	Description
`greaterThan`	Checks whether the value supplied in the payload of the webhook is greater than a specified value. Applicable for integer and float data types.
`lessThan`	Checks whether the payload value is less than a specified value. Applicable for integer and float data types.
`equal`	Checks whether the payload value matches the specified value. For Boolean data types, use `1` to compare to `true` and `0` to compare to `false`.
`notEqual`	Checks whether the payload value does not match the specified value.
`regex`	A regular expression that checks for matches. The specified value must be compatible with the regular expression match.
`in`	Checks whether the payload value is one of multiple specified values. The value must be a comma-separated list. You do not need to provide additional escape characters.
`isEmpty`	Checks whether the payload value is empty.
`notEmpty`	Checks whether the payload value is not empty.

The value to compare against. When you assign the regex operator, you must delimit the regular expression value with valid characters, such as forward slashes (/). For example, /^TV .*/i, which checks whether the string starts with TV, ignoring the case of the letters.

Define conditional webhooks in `webhooks.xml`

The following example creates and registers a conditional webhook for the event plugin.magento.tax.api.tax_calculation.calculate_tax. The webhook will be only triggered when all of the conditions are true:

The value of quoteDetails.shipping_address.country_id must be equal to US.
The quoteDetails.billing_address.postcode must begin with 123.

<method name="plugin.magento.tax.api.tax_calculation.calculate_tax" type="after">
   <hooks>
      <batch name="Order_Updates">
         <hook name="update_order" url="{env:APP_URL}/calculate-taxes" method="POST" timeout="5000" softTimeout="1000" priority="300" required="false" fallbackErrorMessage="The taxes can not be calculated">
            <fields>
               <field name="quoteDetails" />
               <field name="storeId" />
            </fields>
            <rules>
               <rule field="quoteDetails.shipping_address.country_id" operator="equal" value="US" />
               <rule field="quoteDetails.billing_address.postcode" operator="regex" value="/^123/" />
            </rules>
         </hook>
      </batch>
   </hooks>
</method>
Copied to your clipboard
<method name="plugin.magento.tax.api.tax_calculation.calculate_tax" type="after">
   <hooks>
      <batch name="Order_Updates">
         <hook name="update_order" url="{env:APP_URL}/calculate-taxes" method="POST" timeout="5000" softTimeout="1000" priority="300" required="false" fallbackErrorMessage="The taxes can not be calculated">
            <fields>
               <field name="quoteDetails" />
               <field name="storeId" />
            </fields>
            <rules>
               <rule field="quoteDetails.shipping_address.country_id" operator="equal" value="US" />
               <rule field="quoteDetails.billing_address.postcode" operator="regex" value="/^123/" />
            </rules>
         </hook>
      </batch>
   </hooks>
</method>

The following example sends a webhook to a third-party service when the product short description is empty. The service generates the text for the description. The webhook returns the operation with information to update the product short description. As a result, the webhook will not be triggered again for the same product.

       <method name="observer.catalog_product_save_before" type="before">
       <hooks>
           <batch name ="Product_Updates">
               <hook name="generate_description" url="{env:APP_URL}/generate-product-description" timeout="5000" softTimeout="1000" priority="300" required="true" fallbackErrorMessage="The product could not be updated">
                   <fields>
                       <field name="product.name" source="data.product.name" />
                       <field name="product.category_ids" source="data.product.category_ids" />
                       <field name="product.sku" source="data.product.sku" />
                   </fields>
                   <rules>
                       <rule field="product.short_description" operation="isEmpty" />
                   </rules>
               </hook>
           </batch>
       </hooks>
   </method>
Copied to your clipboard
       <method name="observer.catalog_product_save_before" type="before">
       <hooks>
           <batch name ="Product_Updates">
               <hook name="generate_description" url="{env:APP_URL}/generate-product-description" timeout="5000" softTimeout="1000" priority="300" required="true" fallbackErrorMessage="The product could not be updated">
                   <fields>
                       <field name="product.name" source="data.product.name" />
                       <field name="product.category_ids" source="data.product.category_ids" />
                       <field name="product.sku" source="data.product.sku" />
                   </fields>
                   <rules>
                       <rule field="product.short_description" operation="isEmpty" />
                   </rules>
               </hook>
           </batch>
       </hooks>
   </method>