What is a Kitetag Interaction?

A Kitetag Interaction (KI) is the configuration that controls the response when a Tapper taps a Kitetag. It connects the data stored in a Kitetag Data Structure (KDS) to an App that produces the final result — a URL redirect, a digital business card, a webhook payload, or something else.

Every Kitetag Group has one KI assigned to it. All tags in that group use the same interaction.

How interactions, data structures, and Apps connect

The KI sits between your data and the App. It reads the fields from the KDS, maps them to the App’s requirements, and triggers the response.

For example, if your KDS has a “Website” field and your KI uses the URL Redirect App, the interaction tells the App to redirect the Tapper to the URL stored in that field.

What you need before creating an interaction

Make sure your KDS has the fields your chosen App needs. For example, the vCard App requires name and contact fields, while the URL Redirect App requires a website field.

How to create a Kitetag Interaction

  1. Navigate to Interactions in the dashboard.
  2. Click Create Interaction.
  3. Select the KDS that this interaction will use. The builder shows you the available data fields from that structure.
  4. Choose an App for the interaction (see available Apps below).
  5. Use the Interaction Builder to map your data fields to the App’s settings. Each App has its own builder interface tailored to its features.
  6. Click Save.

After saving, assign the KI to a Kitetag Group. Tags in that group will start using the new interaction on their next tap.

Available Apps for interactions

Each App handles the tap response differently. Choose the one that fits your use case:

App What it does Best for
Test Flight Shows the tag’s UID and Callsign Verifying new tags work
URL Redirect Sends the Tapper to a URL Marketing links, product pages
vCard Delivers a downloadable contact card Digital business cards, employee directories
Webhooks Sends tap data to your server Custom integrations, logging
Zapier Triggers a Zapier automation No-code workflows, Google Sheets logging

Visit the Apps section for detailed setup guides for each App.

How the Interaction Builder works

The Interaction Builder is a visual editor inside the dashboard. It changes depending on which App you select, but the general flow is the same:

  1. Select data fields — pick which KDS fields the App should use.
  2. Configure App settings — set options specific to the App (such as the redirect URL pattern or vCard layout).
  3. Preview — see a preview of what the Tapper will experience.
  4. Save and assign — save the interaction and link it to a group.

You do not need to write any code. The builder handles the mapping between your data and the App.

Next steps

Last updated 27 Mar 2026, 06:51 +0900 . history