afaztech / reactor-referral

v0.2.0 2026-10-23 16:17 UTC

Requires

• php: >=8.1
• afaztech/reactor-framework: ^0.5.0

MIT

• Abolfazl Majidi (Afaz)

• reactor
• referral
• Invite
• telegram
• telegram-bot
• deep-link
• afaztech

Published on Packagist.org on 2026-10-23 17:55 UTC

README

Referral tracking for Reactor Telegram bots.

Features

• Deep-link referral attribution
• Lazy referral code generation per user
• Manual referral confirmation
• Referral statistics per user
• Configurable code length and prefix
• Self-referral prevention
• Custom referral code generator

Requirements

• afaztech/reactor-framework ^0.5.0

Installation

composer require afaztech/reactor-referral
./reactor migrate

Usage

use AfazTech\ReactorReferral\Contracts\ReferralManagerInterface;

$referral = $container->get(ReferralManagerInterface::class);

// Get a user's invite link.
$link = $referral->getLink($userId);

// Read their referral statistics.
$stats = $referral->stats($userId);

// Confirm a referral once the reward conditions are met.
$referral->confirm($referredUserId, 'force_join_passed');

Documentation

For detailed documentation, see DOCUMENT.md.

Contributing

Contributions are welcome. Please read the contribution guidelines.

License

This project is licensed under the MIT License.