Creator Studio | Claim listing funnel
Many catalog entries are imported (scraped) before a real owner signs up. The claim funnel turns those listings into active creators who improve trust and buy Promote / Verify.
User-facing flow
- Visitor opens an unclaimed listing → subtle Claim this listing banner
- Sign in with Telegram → Claim Listing (
/creator/claim?slug=...) - Verify ownership (token in bot bio/description or manual admin review)
- After approval: listing moves to My Apps or Channels & Groups; owner sees trust insights and monetization CTAs
No extra product toggle is required for steps 1–3: they work when the listing has an unclaimed creatorId.
Operator configuration
| Requirement | Purpose |
|---|---|
TELEGRAM_BOT_TOKEN | Claim verification via Bot API / admin bot |
Admin Claims panel (/admin/claims) | Approve or reject pending claims |
| Scraped/unclaimed listings in catalog | Supply for the funnel (scrapers + seed scripts) |
Optional: mark verified on approve
Admin claim approval can transfer ownership and set platform verified (see admin claims PATCH handler). Use for high-trust onboarding.
Post-claim upsell (built-in UI)
After claim, owners see in Creator Studio:
| Step | Path | Product |
|---|---|---|
| Improve listing | Edit listing + Listing insights (trust grade) | Free |
| Get verified | /creator/apps/{id}/verify | Verification |
| Promote | /creator/apps/{id}/promote | Promoted listing |
| Referral tracking | Edit → Referral links | Free → Analytics |
Promoted expiry notifications are sent automatically via the catalog bot when configured.
Metrics to watch
- Claim banner → claim started
- Claim approved → first edit / first paid product
- See Analytics referral and view data after ownership transfer