Telegram attribution

Your funnel doesn't only end on OnlyFans — part of the traffic is routed straight into a Telegram sales bot, and that bot produces its own revenue. Telegram attribution answers the same question Attribution answers for OnlyFans, but for the bot: which of your domains sent each paying Telegram fan, and how much did they pay?

The catch: the bot is reached through a plain redirect, so most fans arrive without a tracking payload. TEASE therefore resolves each fan with a layered model — an exact match where one exists, a time-and-country match for the bulk, and an honest organic residual — and stamps every row with a precision badge so a calculation is never passed off as a fact.

The mental model

Every Telegram fan resolves to exactly one origin kind:

How the time-and-country match works

When a fan first writes to the bot, TEASE looks back 5 minutes from that first message at the human clicks that headed toward Telegram — the direct Telegram geo-redirects and the landing pages' Telegram buttons — from the same country. The nearest click preceding the first message wins, and its domain becomes the fan's origin. No qualifying click in the window (or no country on the fan) → the fan stays organic.

Two honest lenses

The report deliberately mixes two windows, mirroring how the bot itself reports:

• Revenue (money) — every sale inside the window, dated by the sale, attributed to the paying fan's resolved origin. An old fan (first message long before the window) who pays today is counted today. This drives summary.payers, summary.revenue_net_cents, the leaderboard money, countries, and the trend's revenue/payers.
• Acquisition (funnel) — the arrival cohort: fans whose first message falls inside the window, walked through arrived → wrote 5+ messages → paid in-period. This drives summary.fans, funnel, per-source fans / msg5plus / nonpayers, and the trend's arrivals.

Read the report

GET /api/admin/tg-attribution returns the whole report in one owner-scoped read. All money values are integer net cents; responses are briefly cached server-side.

curl "https://app.tease.link/api/admin/tg-attribution?period_from=1751328000&period_to=0" \
  -H "Authorization: Bearer $TEASE_API_KEY"

const res = await fetch(
  'https://app.tease.link/api/admin/tg-attribution?period_from=1751328000&period_to=0',
  { headers: { Authorization: `Bearer ${process.env.TEASE_API_KEY}` } },
);
const report = await res.json();

import os, requests

res = requests.get(
    "https://app.tease.link/api/admin/tg-attribution",
    headers={"Authorization": f"Bearer {os.environ['TEASE_API_KEY']}"},
    params={"period_from": 1751328000, "period_to": 0},
)
report = res.json()

Query parameters

Response

{
  "summary": { "fans": 214, "payers": 57, "revenue_net_cents": 331900, "msg5plus": 122 },
  "funnel": { "arrived": 214, "msg5plus": 122, "payers": 31 },
  "leaderboard": [
    {
      "domain_source": "yourbrand.link",
      "source_label": "Main IG",
      "source_icon": "instagram",
      "kind": "tg_match",
      "fans": 96,
      "spenders": 24,
      "msg5plus": 61,
      "revenue_net_cents": 182400,
      "pct": 55.0,
      "countries": [
        { "country": "DE", "revenue_net_cents": 96100 },
        { "country": "AE", "revenue_net_cents": 51200 }
      ],
      "users": [
        { "fan_id": "7093412885", "username": "fan_handle", "country": "DE",
          "revenue_net_cents": 44900, "first_ts": 1752537600 }
      ],
      "nonpayers": [
        { "fan_id": "7093412901", "username": "quiet_fan", "country": "DE",
          "message_count": 18, "first_ts": 1752882000 }
      ]
    }
  ],
  "organic": {
    "domain_source": "", "source_label": "Органика (TG)", "source_icon": "",
    "kind": "organic", "fans": 84, "spenders": 21, "msg5plus": 40,
    "revenue_net_cents": 101800, "pct": 30.7,
    "countries": [], "users": [], "nonpayers": []
  },
  "countries": [
    { "country": "DE", "fans": 41, "spenders": 12,
      "revenue_net_cents": 121300, "msg10plus": 9 }
  ],
  "trend": [
    { "date": "2026-07-18", "arrivals": 24, "payers": 6, "revenue_net_cents": 21500 }
  ],
  "trend_unit": "day"
}

Top-level fields

Source row fields

Country row fields

One fan's card

GET /api/admin/tg-fan/{user_id} opens a single Telegram fan — identity, resolved origin with the precision badge, lifetime totals, a per-day net series, the transaction list, and the purchased content. Returns 404 when the fan is unknown (or not yours — the read is tenant-scoped).

curl "https://app.tease.link/api/admin/tg-fan/7093412885" \
  -H "Authorization: Bearer $TEASE_API_KEY"

{
  "fan_id": "7093412885",
  "username": "fan_handle",
  "name": "Alex",
  "country": "DE",
  "origin": {
    "kind": "tg_match",
    "label": "TG-трафик yourbrand.link",
    "source": "yourbrand.link",
    "domain": "yourbrand.link",
    "country": "DE",
    "precision": "approx"
  },
  "total_net_cents": 44900,
  "purchases": 6,
  "message_count": 132,
  "closeness_level": "warm",
  "closeness_score": 62,
  "first_ts": 1752537600,
  "last_ts": 1753142400,
  "last_purchase_ts": 1753056000,
  "blocked": false,
  "summary_text": "…",
  "preferred_name": "Alex",
  "conversion": 3,
  "paywall_triggers": 2,
  "active_hours": [20, 21, 22],
  "by_day": [ { "day": "2026-07-18", "net_cents": 9900 } ],
  "transactions": [
    { "ts": 1753056000, "net_cents": 9900, "gross_cents": 12900, "kind": "content" }
  ],
  "purchased": [
    {
      "content_id": "c_412", "net_cents": 19800, "count": 2, "last_ts": 1753056000,
      "sale_type": "content", "description": "…", "tags": ["…"],
      "level": 2, "level_label": "…", "media_count": 4,
      "media_types": { "video": 1, "photo": 3 }, "in_catalog": true
    }
  ]
}

Card fields

In the panel

The same report renders as the dashboard's «Telegram» mode — the funnel, the arrivals-and-payments trend, the source leaderboard (every fan chip opens the fan card above), and the country map. Each source row and each fan card carries the precision badge, so «точно» vs «расчёт» is always visible next to the money.

FAQ

Next steps

• Attribution — the OnlyFans-side revenue leaderboard this report mirrors.
• Landing pages — the geo-segments and direct redirects that route fans toward Telegram.
• Smart Links — the trackable links behind every click this report matches against.