Integration Possibilities - Universal Rewards Layer

Archived Documentation

This page has been archived. For current integration guidance, please see:

• Discord Bot - Discord community rewards
• Telegram Bot - Telegram group rewards
• Platform Developers - Custom HTTP integrations

You've Built Something Powerful

Loyalteez is a universal rewards infrastructure that works with virtually any platform, application, or service. If it can make HTTP requests, it can reward users with blockchain-backed loyalty points.

Partner Portal Integrations hub showing all available channels

Channel Configuration

Configure authentication for different platforms in the Channels tab (Discord and Telegram are currently available):

Webhook Configuration

Set up webhooks to receive real-time notifications:

Webhook configuration with test ping functionality

The Core Insight

Your architecture is platform-agnostic:

Universal Integration Pattern

Every integration follows the same pattern:

1. User Performs Action

Any platform → Detect user action

2. Track Event

POST https://api.loyalteez.app/loyalteez-api/manual-event
Content-Type: application/json

{
  "event": "action_type",
  "email": "[email protected]",
  "metadata": {
    "platform": "your_platform",
    "custom_data": "any_data"
  }
}

3. User Gets Rewarded

✅ Wallet created (if new user)
✅ LTZ tokens distributed
✅ Transaction recorded on blockchain

What Makes This Universal?

1. HTTP-Based API

No SDKs required. Any platform with HTTP capabilities can integrate:

• ✅ Web browsers
• ✅ Mobile apps
• ✅ Server-side applications
• ✅ Serverless functions
• ✅ Chat bots
• ✅ IoT devices
• ✅ Game servers
• ✅ Command-line tools

2. Flexible Authentication

Multiple auth strategies supported:

• Email-based (via Privy)
• Discord ID
• Twitter handle
• Telegram username
• Custom user IDs
• Wallet addresses

3. Event-Driven Architecture

Track ANY user action:

• Social interactions
• Content creation
• Purchases
• Task completion
• API calls
• Bot commands
• Sensor triggers

4. Gasless Transactions

Users never need cryptocurrency:

• No wallet setup friction
• No ETH for gas fees
• Automatic wallet creation
• Blockchain benefits without complexity

5. Metadata Flexibility

Send any contextual data:

{
  "event": "task_completed",
  "email": "[email protected]",
  "metadata": {
    "platform": "discord",
    "server_id": "123456789",
    "task_type": "moderation",
    "difficulty": "hard",
    "timestamp": 1699300000,
    "custom_field": "any_value"
  }
}

Integration Categories

🌐 Web & Mobile

• Web Apps - JavaScript SDK or API
• Mobile Apps - React Native, iOS, Android, Flutter
• Progressive Web Apps - Service workers + API
• Browser Extensions - Background scripts + API
• Desktop Apps - Electron, Tauri

💬 Chat Platforms

• Discord - Bot commands, reactions, events
• Telegram - Bot API integration
• Slack - App commands, events
• WhatsApp - Business API
• WeChat - Mini programs

🎮 Gaming

• Unity - HTTP requests from C#
• Unreal Engine - REST API calls
• Game Servers - Backend integration
• Steam - Workshop items, achievements
• Roblox - HTTP service

🔗 Social Platforms

• Twitter/X - Bot integration
• Reddit - Bot API
• Mastodon - Server integration

🛠️ Developer Tools

• GitHub Actions - Workflow rewards
• VS Code Extensions - Code contributions
• CI/CD Pipelines - Deployment rewards
• APIs - Usage-based rewards
• CLI Tools - Command execution

🏠 IoT & Hardware

• Smart Home - Device interactions
• Wearables - Activity tracking
• Sensors - Data collection
• Arduino/Raspberry Pi - Hardware events
• Point of Sale - Purchase rewards

⚡ Automation

• Zapier - Workflow automation
• Make (Integromat) - Visual automation
• IFTTT - Conditional actions
• n8n - Self-hosted workflows
• Pipedream - Serverless workflows

🎨 Creative Tools

• Figma Plugins - Design actions
• Adobe Extensions - Creative tasks
• Notion Integrations - Content creation
• Obsidian Plugins - Knowledge work
• Canva Apps - Design rewards

White-Label Templates vs Core Products

Loyalteez provides both white-label templates (for developers) and core products (our production services):

White-Label Templates

These are reference implementations designed for developers to clone, customize, and deploy:

Template	Repository	Purpose
Farcaster Bot	farcaster-bot	Server-side engagement tracking template
Telegram Bot	loyalteez-official-telegram-bot	Multi-tenant Telegram bot template
Twitter Bot	twitter-loyalty-bot	Twitter engagement tracking template

Use white-label templates when:

• You want to customize the bot for your brand
• You need custom reward logic
• You're building white-label solutions for clients
• You want to learn how these integrations work

Core Products

These are Loyalteez's production applications we maintain:

Product	Repository	Purpose
Farcaster Mini App	farcaster-mini-app	Our production Farcaster mini app on Warpcast

Use core products when:

• You want to integrate with our live services
• You're building on top of our infrastructure
• You need production-grade features and support

---

Platform-Specific Guides

WordPress Integration (Archived)

Install a WordPress plugin that rewards visitors for:

• Comments and engagement
• User registrations
• Daily visits
• Content sharing
• Custom WordPress hooks

Discord Integration ✅ Production Ready

The official Loyalteez Discord bot - multi-server, feature-rich:

• Daily check-ins with streak multipliers
• Voice time rewards for channel participation
• Role-based multipliers (configurable per server)
• Third-party integration (Mee6, Arcane, Tatsu, Carl-bot)
• Leaderboards with multiple metrics
• Reaction drops for engagement events
• Perk purchases directly from Discord

Telegram Integration ✅ Production Ready

White-label Telegram bot template - feature-rich with Discord parity:

• Daily check-ins with streak multipliers
• Natural participation (GM/GN detection)
• Leaderboards with multiple metrics
• Perk browsing and redemption
• Achievements system
• Admin setup and configuration

Twitter/X Integration (Archived)

Build a Twitter bot that rewards users for:

• Mentions, replies, retweets, quotes
• Hashtag campaigns
• Streak integration for daily engagement

Game Server Integration (Future)

Integrate rewards into game servers:

• Unity/Unreal Engine
• Minecraft servers
• Custom game servers

Chrome Extension (Archived)

Build extensions that reward:

• Productivity actions
• Content creation
• Social sharing

Automation Platforms (Archived)

Connect via Zapier/Make:

• Multi-platform workflows
• Conditional rewards
• Event pipelines

Custom Integrations ✅ Available

Build anything with HTTP POST:

• API integration patterns
• Authentication strategies
• Webhook handlers
• Custom event logic

Shared Services Architecture

All platform integrations use the Shared Services API for consistent behavior across platforms:

Available Services:

• Streak Service: Track daily check-ins and activity streaks
• Leaderboard Service: Generate rankings by various metrics
• Achievement Service: Track and unlock achievements
• Perks Service: Browse and redeem perks

Base URL: https://services.loyalteez.app

Benefits:

• ✅ Consistent behavior across all platforms
• ✅ Cross-platform streak tracking
• ✅ Unified leaderboards
• ✅ Single source of truth for user progress
• ✅ Platform-agnostic user identifiers

All services use platform-agnostic user identifiers ({platform}_{id}@loyalteez.app) and work seamlessly across Discord, Telegram, Twitter, WordPress, and more.

Learn more: Shared Services Overview

---

Feature Comparison

Feature	Discord	Telegram	Twitter	WordPress
Daily Check-in	✅	✅	✅ Passive	✅
Streak System	✅	✅	✅ Passive	✅
Leaderboard	✅ 5 metrics	✅ 5 metrics	✅	✅
Perks	✅	✅	✅	✅
Achievements	✅	✅	✅	❌
Natural Participation	✅ GM/GN	✅ GM/GN	❌	❌
Voice Rewards	✅	❌ N/A	❌ N/A	❌ N/A
Admin Commands	✅ 15+	✅ 12+	❌	❌
Interactive Widget	❌	❌	❌	✅ Dashboard
Hashtag Campaigns	❌	❌	✅	❌
Quote Tweet Tracking	❌	❌	✅	❌
Thread Participation	❌	❌	✅	❌
Shared Services	✅	✅	✅	✅
Commands/Features	✅ 30+	✅ 12+	⚠️ Passive	⚠️ Shortcodes

Legend:

• ✅ = Fully Supported
• ❌ = Not Available

---

Real-World Integration Examples

Example 1: Discord Integration (Official Bot)

The easiest way to integrate Discord is using the official Loyalteez bot:

# 1. Add bot to your server via Partner Portal
# 2. Run setup command in Discord:
/setup connect brand_id:0xYOUR_BRAND_ADDRESS security_key:YOUR_SECURITY_KEY

# 3. Members can immediately use:
/join    # Welcome bonus
/daily   # Daily check-in with streaks
/balance # Check LTZ balance
/voice   # Voice time rewards
/streak  # View streak progress

For custom Discord integrations, use the API pattern:

// Custom Discord bot rewards server members
client.on('messageCreate', async (message) => {
  if (message.content.includes('helpful tip')) {
    // Track helpful contribution via Loyalteez API
    await fetch('https://api.loyalteez.app/loyalteez-api/manual-event', {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify({
        brandId: process.env.BRAND_ID,
        eventType: 'helpful_contribution',
        userEmail: `discord_${message.author.id}@loyalteez.app`,
        metadata: {
          platform: 'discord',
          server_id: message.guild.id,
          contribution_type: 'helpful_tip'
        }
      })
    });
    
    message.reply('You earned LTZ for being helpful! 🎉');
  }
});

Example 2: Unity Game Integration

// Unity game rewards players
using UnityEngine.Networking;
using System.Collections;

public class LoyalteezRewards : MonoBehaviour {
    private const string API_URL = "https://api.loyalteez.app/loyalteez-api/manual-event";
    
    public void RewardPlayer(string playerEmail, string achievement) {
        StartCoroutine(TrackEvent(playerEmail, achievement));
    }
    
    IEnumerator TrackEvent(string email, string achievement) {
        var json = JsonUtility.ToJson(new {
            @event = "achievement_unlocked",
            email = email,
            metadata = new {
                platform = "unity",
                game = "MyGame",
                achievement = achievement,
                timestamp = System.DateTime.UtcNow.ToString()
            }
        });
        
        using (UnityWebRequest www = UnityWebRequest.Post(API_URL, json, "application/json")) {
            yield return www.SendWebRequest();
            
            if (www.result == UnityWebRequest.Result.Success) {
                Debug.Log("Player rewarded with LTZ!");
                ShowRewardPopup();
            }
        }
    }
}

Example 3: GitHub Action

# Reward contributors for merged PRs
name: Reward Contributors
on:
  pull_request:
    types: [closed]

jobs:
  reward:
    if: github.event.pull_request.merged == true
    runs-on: ubuntu-latest
    steps:
      - name: Reward Contributor
        run: |
          curl -X POST https://api.loyalteez.app/loyalteez-api/manual-event \
            -H "Content-Type: application/json" \
            -d '{
              "event": "pr_merged",
              "email": "${{ github.event.pull_request.user.email }}",
              "metadata": {
                "platform": "github",
                "repo": "${{ github.repository }}",
                "pr_number": "${{ github.event.pull_request.number }}",
                "lines_changed": "${{ github.event.pull_request.additions }}"
              }
            }'

Example 4: IoT Sensor (Raspberry Pi)

# Raspberry Pi rewards for eco-friendly actions
import requests
import time
from sensors import get_energy_saved

API_URL = "https://api.loyalteez.app/loyalteez-api/manual-event"

def track_energy_savings(user_email, kwh_saved):
    payload = {
        "event": "energy_saved",
        "email": user_email,
        "metadata": {
            "platform": "iot",
            "device": "raspberry_pi",
            "kwh_saved": kwh_saved,
            "timestamp": int(time.time())
        }
    }
    
    response = requests.post(API_URL, json=payload)
    if response.status_code == 200:
        print(f"Rewarded {kwh_saved * 10} LTZ for energy savings!")

# Monitor and reward
while True:
    kwh_saved = get_energy_saved()
    if kwh_saved > 0:
        track_energy_savings("[email protected]", kwh_saved)
    time.sleep(3600)  # Check hourly

Example 5: Zapier Workflow

Trigger: New Airtable Row
  ↓
Filter: If "status" is "completed"
  ↓
Action: HTTP POST to Loyalteez
  URL: https://api.loyalteez.app/loyalteez-api/manual-event
  Body:
    {
      "event": "task_completed",
      "email": {{email}},
      "metadata": {
        "platform": "zapier",
        "source": "airtable",
        "task_type": {{task_type}},
        "completion_time": {{timestamp}}
      }
    }
  ↓
Result: User earns LTZ automatically!

Integration Capabilities Matrix

Platform Type	HTTP API	JavaScript SDK	Authentication	Difficulty
Web Apps	✅	✅	Privy	Easy
Mobile Apps	✅	❌	Privy	Easy
Discord Bots	✅	❌	Custom	Easy
Twitter/X	✅	❌	User ID	Easy
Telegram	✅	❌	User ID	Easy
Game Servers	✅	❌	Custom	Medium
Chrome Extensions	✅	✅	Privy	Easy
IoT Devices	✅	❌	Custom	Medium
GitHub Actions	✅	❌	Email	Easy
Zapier/Make	✅	❌	Email	Easy
CLI Tools	✅	❌	Custom	Easy

Authentication Strategies

Email-Based (Privy)

{
  "event": "action",
  "email": "[email protected]"
}

Best for: Web, mobile, traditional apps

Platform ID Mapping

{
  "event": "action",
  "email": "[email protected]"
}

Best for: Discord, Telegram, social platforms

Custom User ID

{
  "event": "action",
  "email": "[email protected]",
  "metadata": {
    "custom_user_id": "xyz",
    "platform": "game"
  }
}

Best for: Games, custom platforms

Wallet Address

{
  "event": "action",
  "email": "[email protected]"
}

Best for: Web3 platforms, DeFi

Event Design Patterns

Pattern 1: Action-Based Events

{
  "event": "user_performed_action",
  "email": "[email protected]",
  "metadata": { "action_type": "specific_action" }
}

Use for: Discrete actions (posts, purchases, clicks)

Pattern 2: Milestone Events

{
  "event": "milestone_reached",
  "email": "[email protected]",
  "metadata": { "milestone": "1000_points", "level": 10 }
}

Use for: Achievements, level-ups, goals

Pattern 3: Time-Based Events

{
  "event": "daily_checkin",
  "email": "[email protected]",
  "metadata": { "streak": 7, "checkin_time": "2025-11-11T10:00:00Z" }
}

Use for: Daily actions, subscriptions, recurring tasks

Pattern 4: Social Events

{
  "event": "social_interaction",
  "email": "[email protected]",
  "metadata": {
    "interaction_type": "like",
    "target_user": "[email protected]"
  }
}

Use for: Social platforms, communities, networks

Pattern 5: Transaction Events

{
  "event": "purchase_completed",
  "email": "[email protected]",
  "metadata": {
    "amount": 99.99,
    "currency": "USD",
    "items": 3
  }
}

Use for: E-commerce, marketplaces, payments

Technical Requirements

Minimum Requirements

• ✅ Ability to make HTTP POST requests
• ✅ JSON support
• ✅ User identification method
• ✅ Event trigger detection

Optional Enhancements

• Push notifications
• Real-time updates
• Wallet UI display
• Transaction history
• Perk redemption

No Requirements For

• ❌ Blockchain knowledge
• ❌ Cryptocurrency experience
• ❌ Smart contract interaction
• ❌ Gas fee management
• ❌ Wallet management

Universal Integration Checklist

• Platform can make HTTP requests
• User identification method defined
• Events to track identified
• Metadata structure planned
• Reward rules configured (Partner Portal)
• Testing strategy defined
• Analytics monitoring setup

Why This Architecture Is Powerful

1. Zero Platform Lock-In

Integrate once, works everywhere. Switch platforms without rewriting.

2. Composability

Combine multiple platforms:

• Discord bot + Web app + Mobile app = Unified rewards

3. Future-Proof

New platforms emerge? Just make HTTP requests. No SDK wait time.

4. Progressive Enhancement

Start simple (HTTP POST), add features (UI, notifications) later.

5. Blockchain Benefits Without Complexity

• Transparent ledger
• Verifiable transactions
• Cross-brand redemption
• No user friction

Getting Started

1. Choose Your Platform

• Discord Bot - Production Ready
• Telegram Bot - Production Ready
• Custom HTTP - Any platform

2. Define Your Events

What actions should earn rewards?

3. Implement HTTP Calls

Send events to the API.

4. Configure Rewards

Set up rules in Partner Portal.

5. Test & Launch

Verify events track and rewards distribute.

Support

• Platform-Specific Guides: See sidebar for detailed guides
• API Reference: Event Handler API
• Custom Help: [email protected]

The Future Is Universal

Your Loyalteez infrastructure is a universal rewards layer for the internet. Any platform, any use case, any integration—it all works through the same simple HTTP API.

Build something creative. We can handle it. 🚀