Skip to main content

Integrations

Connect Resonance to your website, e-commerce platform, and social channels to reward users across every touchpoint.

Access integration settings from Dashboard → Integrations.

Website SDK​

Embed the Resonance SDK on your website to automatically detect user actions and distribute RSNC.

Installation​

Add the SDK script to your website's <head> tag:

<script src="https://reward.rsnc.network/resonance-sdk.js"></script>
<script>
  ResonanceAutomation.init('YOUR_BRAND_ID', {
    autoDetect: true,
    events: 'form_submit:25,newsletter_signup:50'
  });
</script>

Replace YOUR_BRAND_ID with your wallet address (found in Profile → Account Address, starts with 0x).

What the SDK Detects​

With autoDetect: true, the SDK automatically detects:

  • Form submissions (signup, contact, newsletter)
  • Page visits matching URL patterns you configure
  • Custom events you trigger via JavaScript

Custom Events​

Trigger events manually in your code:

ResonanceAutomation.trackEvent('purchase_completed', {
  email: 'customer@example.com',
  value: 49.99
});

The event ID must match an event configured in your Reward → Events page.

REST API​

Submit events programmatically from your backend.

Endpoint​

POST https://reward.rsnc.network/resonance-api/manual-event

Example Request​

curl -X POST https://reward.rsnc.network/resonance-api/manual-event \
  -H "Content-Type: application/json" \
  -H "X-Resonance-Brand-Id: 0xYOUR_BRAND_ID" \
  -H "X-Resonance-Signature: YOUR_HMAC_SIGNATURE" \
  -H "X-Resonance-Timestamp: 1700000000000" \
  -d '{
    "event_id": "purchase_completed",
    "user_email": "customer@example.com",
    "metadata": { "order_value": 49.99 }
  }'

Authentication​

The API uses HMAC-SHA256 signatures for authentication:

  • X-Resonance-Brand-Id — Your wallet address (lowercase)
  • X-Resonance-Signature — HMAC-SHA256 of BrandId | EventData | Timestamp using your Security Key
  • X-Resonance-Timestamp — Current time in milliseconds (5-minute replay window)

Find your Security Key in Profile → Security Key.

Discord Bot​

The Resonance Discord Bot rewards community engagement automatically. See the full Discord Bot Setup Guide for details.

Quick setup:

  1. Go to Integrations → Discord in the Partner Portal
  2. Click "Add Resonance Bot to Discord"
  3. Select your server and authorize
  4. Run /setup connect brand_id:0x... security_key:... in your server

Shopify​

Connect your Shopify store to reward purchases and registrations automatically.

Setup​

  1. Go to Integrations → Shopify in the Partner Portal
  2. Enter your Shopify store URL
  3. Configure webhook events:
    • Order completed — Reward customers when they complete a purchase
    • Customer registration — Reward new account signups
  4. Save your configuration

Shopify webhooks are processed by the Resonance event handler and matched to events you've configured in your Reward page.

Social Platforms​

Connect social accounts to reward engagement across platforms.

Supported Platforms​

PlatformIntegration TypeWhat You Can Reward
DiscordBot + OAuthMessages, reactions, voice time, check-ins
Twitter/XBearer tokenLikes, retweets, mentions, follows
InstagramMeta appLikes, comments, story views
FacebookMeta appPage engagement, event attendance
TelegramBot integrationGroup activity, message engagement
FarcasterFID + credentialsCasts, reactions, follows

Connecting Social Platforms​

  1. Go to Integrations in the Partner Portal
  2. Select the platform you want to connect
  3. Follow the OAuth flow or enter API credentials
  4. Configure which actions trigger rewards
  5. Map actions to events in your Reward page

Social platform credentials are encrypted at rest using AES-256-GCM and decrypted only at runtime.

Next Steps​

Last updated on