Tango Integration

Tango Integration#

This documentation provides a guide on integrating the Tango rewards with your Talkable system. By enabling this feature, you can generate gift claim links for users and customize reward amounts based on campaign settings.

Tango integration consists of several parts:

  1. A Reward Link reward option in Tango portal.

  1. A Tango application installed from Talkable App Store. This application is responsible for storing all the necessary data required for Talkable to request gift cards from Tango and insert the generated claim links in the referral campaign theme.

  1. A referral campaign in Talkable having the following attributes:

    • An Advocate Referral Incentive with “Tango” reward type

    • A “tango” Liquid filter used in Reward Paid Email Page.

      The filter generates a claim link for the specified reward in Tango.

      <!-- An example of the claim link leading to Tango -->
<a href="{{ 'U957978' | tango: amount: 10 }}" target="_blank" title="{{ cta_text }}">
  {{ cta_text }}
</a>

How to find the reward ID (UTID)#

To use the tango Liquid filter, you will need to obtain the reward ID (called UTID) in the Tango portal:

  1. In the “Send rewards” portal section, select and click the Reward Link you intend to use to reward advocates in Talkable.

  2. On the reward details page, click “View all reward details”.

    Open Tango reward details

  3. Copy the “UTID” value and use it with the tango filter in the Talkable campaign theme.

    Copy Tango UTID

    Note

    Make sure to only copy the value of UTID, i.e “U957978”.

How to find the Talkable Reward ID (External Reference ID)#

When Talkable sends a reward request to Tango, it includes a Talkable Reward ID as the External Reference ID. This identifier is useful for:

  • Searching for specific rewards in the Tango portal

  • Canceling QA or test rewards

To find the Talkable Reward ID:

Option 1: From the Rewards report (Additional Columns)

  1. Navigate to the Rewards report in Talkable (Reports → Rewards).

  2. Click the “Additional Columns” button and enable the ID column.

  3. The Reward ID will be displayed in the ID column for each reward in the report.

Option 2: From the Reward Details page

  1. Navigate to the Rewards report in Talkable (Reports → Rewards).

  2. Locate the reward you want to reference and click “Details” to open the reward details page.

  3. The Reward ID is displayed in the ID field on the reward details page.

Using the Reward ID in Tango

Use the Reward ID to search for the corresponding order in the Tango portal’s “Orders” section by entering it in the “External reference ID” search field.

Note

The External Reference ID in Tango matches the Talkable Reward ID exactly. This allows you to easily trace rewards between both systems for reconciliation or cancellation purposes.

Contact us

Interested in setting this up? Contact your CSM or get in touch here.

Contents