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 single-action interactions

For the simplest case — a tap that does one thing — create a single-action interaction from the Interactions page using the quick-create dropdown. Each option corresponds to an App:

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.

Step-based interactions: multi-action flows

For scenarios where a tap should do more than one thing — show a welcome screen, collect a form, call a webhook, redirect — use the full Interaction Builder.

Step-based interactions chain multiple step types together into a single tap flow:

  • Display steps the Tapper sees: Message, Form Input, vCard, WiFi Share, Display Information Table.
  • Silent steps that run in the background: Webhook, Zapier.
  • Terminal step that ends the flow: URL Redirect.

See the Interaction Builder guide for the full step catalog, the Design tab, and example flows.

How the Interaction Builder works

The Interaction Builder is a visual drag-and-drop editor inside the dashboard, with three tabs:

  1. Steps — Add, reorder, and configure the steps in your flow. A fixed Step 0: Kitetag Tapped marker sits at the top.
  2. Design — Set the colors, fonts, and logo used by every display step.
  3. Settings — Name the interaction and choose the KDS it reads from.

A live iPhone 14 preview updates on the right as you edit. You do not need to write any code.

Who can create and edit interactions?

Both Account Managers and Tag Managers can create, edit, publish, and delete interactions through the Interaction Builder. Account Managers additionally control billing, team membership, and organization-level settings. See the Organizations and Users guide for the full role breakdown.

Next steps

Last updated 17 Apr 2026, 15:38 +0900 . history