Actions

The User Manual has moved! For the most up-to-date information, please visit our new site at docs.antavo.com.
We're committed to providing you with the best resources, and our new site offers an enhanced experience with the latest documentation. Thank you for your understanding and continued support.

Actions are essentially the end results of your workflow, they perform the tasks that the workflow is set up for. You can add multiple actions to a workflow, either on different branches or next to one another.

Please note, that some of the actions and their configuration options appear after the necessary module is turned on in your loyalty program. Contact the Antavo Service Desk if a node is not available for you.

Action node

Module required

Action node

Module required

Trigger Marketing Communication

Integration with a newsletter provider

Sync Bloomreach event

Integration with Bloomreach

Sync data

Integration with a newsletter provider

Sync multiple fields

Integration with a newsletter provider

Webhook message

Webhooks (legacy)

Webhook message

Trusted sites
Webhooks

Update a Wallet pass

Wallet

Update a Google pass

Wallet

Assign pass

Wallet

Set tier

Tiers

Change tier

Tiers

A/B test

-

Assign coupon

-

Entity lookup

-

Add to list

-

Remove from list

-

Remove tier

Tiers

Campaign bonus

-

Complete challenge

Challenges

Trigger event

-

Coupon transfer

-

Push notification

Wallet

Switch Pass Template (beta)

Wallet

Pass Lookup

Wallet

Create custom entity

Custom Entities

Referral bonus

Friend referral

Participate in contest

Contest lite

Revoke from contest

Contest lite

Reward claim

Rewards

Action outputs

Each action type listed below, except for the A/B test node, has two types of outputs: success (green) and failure (red).

  • Success: Further actions attached to the success output of the action will only be executed after the action has been successfully executed.

  • Failure: Further actions attached to the failure output of the action will only be executed when the action has not been executed successfully.


Action Types

Trigger Marketing Communication

Triggers an event in your integrated newsletter provider (for Bloomreach event sync, use this node and for Braze use this node).

  • Select the external event to be triggered using the dropdown list

  • Enter the key and value of the event data to be sent in the payload of the event
    You can add multiple data fields to the payload using the ‘Add’ button.

You can find all the triggered events (POST requests) and associated responses under the Sync tab of the customer profile.


Sync Bloomreach event

Triggers an event in an integrated Bloomreach project.

  • Insert the Antavo identifier of the customer who should receive this event.
    The event should not necessarily be registered for the customer making the triggering action, and you can use that as well. (eg. {customer.referrer}). Leave it empty to trigger an event for the current customer.

  • Select the external event to be triggered using the dropdown list

  • Enter the key and value of the event data to be sent as payload within the event
    You can add multiple data fields to the payload using the ‘Add’ button.

You can find all the triggered events (POST requests) and associated responses under the Sync tab of the customer profile.


Sync Braze event

Triggers an event in an integrated Braze workspace.

  • Insert the Antavo identifier of the customer who should receive this event.
    The event should not necessarily be registered for the customer making the triggering action, and you can use that as well. (eg. {customer.referrer}). Leave it empty to trigger an event for the current customer.

  • Enter the external event to be triggered

  • Enter the key and value of the event data to be sent as payload within the event
    You can add multiple data fields to the payload using the ‘Add’ button.

 

You can find all the triggered events (POST requests) and associated responses under the Sync tab of the customer profile.


Sync data

Synchronizes the value of one single customer data field to your integrated newsletter provider.

The Sync data action node is not supported anymore and soon be deprecated. Please use the Sync multiple fields node instead which entirely covers the functionality of this node.

  • Add the Unique ID of the Antavo (local) field to be synced

  • Enter or select (depending on the newsletter provider you use) the (external/remote) field to be updated to the value of the selected Antavo field.

You can find all the synchronization attempts (POST or PUT requests depending on the requirement of the recipient newsletter provider ) and associated responses under the Sync tab of the customer profile.


Sync multiple fields

Synchronizes the value of multiple customer data fields to your integrated newsletter provider at one go.

  • Enter or select (depending on the newsletter provider you use) the (external/remote) field to be updated

  • Enter the field value to be synced to the selected remote field
    You can enter a constant value or use expressions of transported variables as well.

Use the ‘Add’ button to add more fields to be synced within one request.

 

You can find all the synchronization attempts (POST or PUT requests depending on the requirement of the recipient newsletter provider ) and associated responses under the Sync tab of the customer profile.


Webhook message legacy

Sends a webhook message to any web service.

  • Paste the URL of the endpoint where the webhook message should be sent
    You can add a dynamic URL by inserting a variable (eg. {customer._id}).

  • Set a timeout value for the webhook request in seconds

  • Select the content type of the webhook message

  • Select the request method (POST or PUT)

  • Use the ‘Add’ button to define the key and values of the headers and payload of the webhook message
    Click the ‘Add’ button as many times as the number of headers and data fields you want to include in one request.

  • Decide if you want a proxy with a static IP address to be used to send requests

    • Select ‘No’ if Antavo should send the coupon request to the endpoint directly (various IP addresses might be used)

    • Select ‘Yes’ if Antavo should use a proxy with a static IP address to send requests (all requests will be sent from the same IP address)

  • Decide if you want Antavo to use an async method of webhook messaging

    • Select ‘Yes’ if you don’t want Antavo to wait for the web service on your end before sending the next webhook message

    • Select ‘No’ if you want Antavo to wait for the response to a webhook message before sending the next one (this option might delay the workflow execution if it takes longer for the endpoint to process the requests)

You can find all the webhook messages sent under the Log page of the Webhook (legacy) module.


Webhook message

Sends a webhook message to any web service. This node conveniently offers a dropdown list containing the sites that have been added and activated earlier through the Trusted sites module.

  • Choose the pre-configured authentication from the ‘Site’ dropdown menu

  • Select the request method (GET, POST, PUT, DELETE or PATCH)

  • Add a dynamic parameter to the ‘URL path’ field
    This extends the pre-configured trusted site path.

  • Use the ‘Add’ button to define the key and values of the headers and payload of the webhook message
    Click the ‘Add’ button as many times as the number of headers and data fields you want to include in one request.

  • Decide if you want Antavo to use an async method of webhook messaging

    • Select ‘Yes’ if you don’t want Antavo to wait for the web service on your end before sending the next webhook message

    • Select ‘No’ if you want Antavo to wait for the response to a webhook message before sending the next one (this option might delay the workflow execution if it takes longer for the endpoint to process the requests)

  • You can set a timeout for webhook messages in the ‘Max response time (seconds)' field to customize response waiting duration. Please note that the specified duration must be between 0 and 120 seconds.

You can find all the webhook messages sent under the Log page of the Webhooks module.


Update a Wallet pass early access

Triggers field and display updates on assigned Apple passes added in the Wallet module.

  • Select the pass to be updated

  • Enter the key (the headers of fields configured in the Wallet module) and the new value of the pass field
    You can add multiple fields using the ‘Add’ button.

  • Configure asset (image) updates on the pass
    The value of the new asset should be a URL where the image is accessible.

  • Define the new colors of the pass using hexadecimal color codes

You can find further information about the structure of passes in the Wallet Developer Guide.


Update a Google pass early access

Triggers field updates on the customer’s Google pass added in the Wallet module.

  • Select the pass to be updated

  • Enter the key and the new value of the pass field
    You can add multiple fields using the ‘Add’ button.
    Please contact the Antavo Service Desk if you need help with adding the keys of Google pass fields.


Assign pass

Assigns a Wallet pass to the loyalty member.

  • Select the pass to be assigned to the customer
    You can only select active passes.

The Assing pass action registers an Assign pass event and you can find the new pass under the Passes tab of the customer profile.


Set tier

Moves customers to a specific tier.

  • Select the tier that the workflow should assign
    You can only select active tiers that are grouped by tier structures in the dropdown field.
    If a customer is already a member of the selected tier, no update will be triggered, but the execution of the Set tier action will still be considered a success.

The Set tier action registers a Tier up or Tier down event depending on the customer’s current tier and the newly set tier will be displayed on the customer profile page. If the customer is already on the selected tier, no event is registered and the tier information will not change on the customer profile.


Change tier

Changes the expiration of customers' tier memberships.

  • Select the tier membership to be updated
    You can only select active tiers that are grouped by tier structures in the dropdown field.

  • Set the new expiration date or leave it empty if the tier membership should never expire
    The new date should be inserted in a ‘date: YYYY-MM-DD’ format.

  • Select the expiration method

    • select Date if you have entered a date in the previous field

    • select Never if you left the previous field empty

The Change tier action registers a Tier change event with the new expiration date of the tier affected.


A/B test

Divides the audience in order to test different actions and adds customers to predefined lists.

  • Define the percentage of the test groups

  • Select the list the test group should be added to
    This step is optional, adding customers to lists is not required.

Click the '+' button to divide the audience into a maximum of 20 groups within one A/B test node. The total percentage of all the groups cannot exceed 100%.

As mentioned before, the A/B test node has a different set of outputs than the rest of the action nodes.

Each group added in the A/B test will populate an output of the node. All nodes added to each output will be applied to the associated customer group.

You can find the customers added to each list if you open the selected lists under the Customer lists tab of the Customer Insights menu.


Assign coupon

Issues a coupon to the customer.

  • Select coupon source

    • Generate: Antavo will generate codes

    • Remote: Antavo sends a request to an endpoint which provides a coupon code that is assigned to the customer
      This option allows you to have more control over coupon management.

  • Add the coupon type and value
    Decide whether you want to assign a percentage-off coupon or a fixed-amount discount and set the coupon value.

  • Define the pattern of the coupon code to be assigned
    # denotes a digit (0-9)
    @ denotes an alphabet character (a-z)
    ^ denotes a capital alphabet character (A-Z)
    * denotes an alphanumeric character
    $ denotes a capital alphanumeric character

    All other characters should be copied into the generated code as literals (eg. if you set ‘@##COUPON’, a generated coupon code could be G11COUPON or T35COUPON).

    If you would like to assign a generic coupon code to all customers, don’t use pattern characters, only literals (eg. if you set ‘SPRINGCOUPON’, all coupons codes to each customer will be generated as SPRINGCOUPON)

  • Set the coupon expiration time
    You can add a period so that the expiration date of the coupon will be dynamically set when the coupon is assigned (eg. Date: 1 week, Date: 2 months, etc.), or set a predefined date (eg. Date: 2012-08-31).
    If you don’t want the coupon to expire, leave the field empty.

  • If you chose to use a remote endpoint as the coupon source, set a callback URL endpoint

  • Set the type of the request root

    • Select ‘Direct’ if Antavo should send the coupon request to the endpoint directly (various IP addresses might be used)

    • Select ‘Use proxy’ if Antavo should use a proxy with a static IP address to send requests (all requests will be sent from the same IP address)

The Assign coupon action registers a Coupon assign on the customer’s event history and the new coupon is added to the list of coupons under the Coupons tab.


Entity lookup

Looks up a specific entity item of an entity type you select and adds it to transport, so that the entity can be used in other workflow nodes.

  • Select the entity type from the dropdown list (contains all factory and custom entity types)

  • Select the filter attribute from the dropdown list (contains all attributes of the previously selected entity)
    You can use any attribute that has a unique tag, meaning that the attribute value of each entity is unique.

  • Enter the value of the attribute you are searching for

  • Enter the transport variable name of the filtered entity item
    You can refer to the filtered entity item by this name in nodes following this one within the workflow.

  • Add further filter conditions, if necessary
    You can use mongo expressions to define conditions, please contact the Antavo Service Desk to help with advanced use cases.


Add to list

Adds customers to predefined lists.

  • Select the list that customers should be added to

Even if a customer is already on the selected list, the workflow will continue running on the success (green) output of the Add to list action.

You can keep track of the members in the selected list if you open the list under the Customer lists tab of the Customer Insights menu.


Remove from list

Removes customers from predefined lists.

  • Select the list that customers should be removed from

If a customer is not in a selected list, the workflow will continue running on the failure (red) output of the Remove from list action, please make sure you configure that as well, if necessary.

You can keep track of the members in the selected list if you open the list under the Customer lists tab of the Customer Insights menu.


Remove tier

Removes customers from a selected invitation-only tier structure.

  • Select the tier structure the customer should be removed from
    You can only select active tier structures.
    Use the ‘Remove all’ option to remove the customer from all the invitation-only tier structures if they are part of more structures.

The Remove tier action registers a Tier remove event. This event is only operational with workflows, it cannot be submitted through the Events API or manually added on the platform.


Campaign bonus

Rewards loyalty members with bonus points.

  • Set the number of points that the customer will receive as a bonus

  • Add a description
    The description will be registered in the Campaign bonus event.

  • Select the account to which the bonus points should be added, in case you use the Multi Accounts module

  • Set the expiration date of the points
    The new date should be inserted in a ‘date: YYYY-MM-DD’ format. If no date is added, then the points will not expire or if you use the Expiring points module, the expiration date will automatically be set based on the configured logic.

The Campaign bonus action registers a Campaign bonus event on the customer’s event history.

If the Checkout accept module is enabled in your brand and you use the Checkout event (or Checkout item events included) to trigger a Campaign bonus node, the bonus points are allocated as pending points first through the registration of a Pending campaign bonus event. When the purchase is confirmed with a Checkout accept event, the Campaign bonus event is automatically registered which converts the pending bonus points to spendable points.


Complete challenge

Registers the completion of a predefined challenge and grants the points associated. This node adds the challenge completion even if the customer does not meet the criteria defined in the editor of the selected challenge. However, the maximum completion setting still applies, which means that the workflow will not assign the challenge if the customer has reached the completion limit.

The challenge progress that the customer might have earned previously will not be reset, if the challenge is repeatable the customer can continue completing the challenge where they left off.

  • Select the challenge that should be assigned to the customer
    You can only select active challenges.

The Complete challenge action registers a Challenge event on the customer’s event history. The new challenge is added to the list of completed challenges on the customer overview page.


Trigger event

With the Trigger event action, you can trigger the registration of any event as a result of the running of a Workflow.

  • Insert the customer who should receive this event
    This field allows you to trigger the event to any loyalty program member who is not necessarily the customer of the current workflow execution.
    You can add the ID of a specific customer, or use a variable (eg. {customer.referrer}) as well.

  • Select the event to be registered

  • Add event attributes, if necessary

  • Select the account to which the event should be registered, in case you use the Multi Accounts module

The Trigger event action registers the selected event on the customer’s event history with all the defined attributes.


Coupon transfer

This node gives the opportunity to reassign a coupon that has been assigned to a customer previously.

  • Add the ID and/or email address of the target customer
    If the customer does not exist in the Antavo database, a new inactive customer will be created to which the coupon gets assigned.
    You can target a specific customer or use a variable in the Target customer field (eg. {customer.referrer}) instead.

  • Define the coupon code to be transferred
    You can add a specific coupon code or use a variable (eg. {event.coupon_code}) instead.

 

The Coupon transfer action registers a Coupon receive event in the event history of the recipient.


Push notification early access

Sends push notifications to a specific pass saved on the customer’s device.

  • Select which wallet pass should be the subject of the notification

  • Add a message that will pop up on the screen
    You can insert variables (eg. {event.coupon_code}, {customer.first_name} or volt expressions in the notification.


Pass Lookup early access

Looks up a customer pass or passes and adds the pass ID(s) to the transport, so that the template of the pass(es) can be modified through a Switch Pass Template node later in the workflow.

  • Select the search method:

    • Pass ID
      Enter the ID of the pass in the ‘Pass ID' field to search for a specific customer pass by the ID.

    • Customer and Pass Template Variant Group ID
      Select the Variant Group ID to search for the pass(es) that use the selected Variant group ID.

    • Customer and Coupon Reward
      Enter the coupon code and the ID of the reward to search for a pass that was assigned when the coupon reward was claimed.

  • Enter the transport variable name of the filtered pass(es) in the Pass ID Transport Variable field.
    You can refer to the filtered pass(es) by this name in nodes following this one within the workflow.


Switch Pass Template (beta) early access

Replace the current pass template of an assigned pass with a new one. The pass(es) to be modified should be added to a transport variable in a preceding Pass Lookup node.

  • Enter the transport variable name that has been defined in the Pass Lookup node previously

  • Select the new template to be assigned to the transported pass(es)


Create custom entity

Creates an entity item that will appear in the appropriate custom entity collection.

  • Use the dropdown field to select the type of entity that you want to create (eg. car)

  • Enter the key and the new value of the new entity item (eg. brand of the new car entity)
    You can add multiple fields using the ‘Add’ button. Make sure you add all the required (*) entity fields (eg. ID)

  • Enter the transport variable name of the new entity item
    You can refer to the new entity item by this name in nodes following this one within the workflow.

You can find the new entity that is created through the Create new entity node under the specific entity page of the Custom entities module.


Referral bonus

Rewards referrers with bonus points based on the actions of their invited friends.

  • Set the number of points to be added to the referrer of the customer who is the subject of the current rule execution.
    If the Referral bonus action is added to a workflow that uses an On date trigger, the bonus will be added to all active customers who have ever referred a friend in the loyalty program.

  • Optionally, you can add a reason why the bonus was added.

The Referral bonus action registers a Referral bonus event on the referrer’s event history with the defined reason (if any).


Participate in contest

Using the Participate in contest action you can add customers to the participants of a currently active promotion configured in the Contest lite module. Entries can be added between the start and end dates of the contest, while it is active.

  • Select the contest in which the customer should participate

  • Decide if you would allow customers to re-enter the contest
    If you don’t allow re-enters, the workflow will proceed on the failure (red) output of the action in case the customer has already entered the selected contest

  • Decide if you will give this entry for free or get the entry point price deducted (configured in the Contest lite module) from the customer point balance

  • Set the number of contest entries that you’d like to grant to customers
    The number of entries you can add is unlimited.

The Participate in contest action registers a Promotion enter event on the customer’s event history with the configured number of entries recorded in the count event attribute.


Revoke from contest

With the Revoke from contest node, you can invalidate customers' previous contest entries, reducing the number of entries they have in a specific contest configured in the Contest lite module. Entries can be revoked from the activation of the contest until the winner is selected, while the contest is active.

  • Copy and paste the ID of the contest
    You can find the ID of the contest at the end of the URL of the contest editor configuration page.

  • Decide if you would give back the points that the customer spent to enter the contest
    If the customer received the entry (entries) for free and no points were spent, points cannot be given back, assuredly.

  • You can revoke multiple contest entries at the same time
    If the number of entries to be revoked is greater than the customer’s current number of entries, the number of entries will be set to 0.


Reward claim

The Reward claim action assigns rewards, previously set up in the Rewards module, to loyalty members.

  • Use the dropdown field to select the reward to be claimed
    Only active rewards can be selected.

  • You can choose to assign the reward for free or deduct the point price of the reward (set in the Reward editor) from the customer’s point balance.

The Reward claim action registers a Reward on the customer’s event history. The newly assigned reward is added to the list of claimed rewards on the customer overview page.


Toast message

The Toast message action triggers a toast notification on the customer’s screen.

  • Add a message that will pop up on the screen
    You can insert variables (eg. {event.coupon_code}, {customer.first_name} or volt expressions in the notification.

 

© Copyright 2022 Antavo Ltd.