Integration

Pally.gg

Receive donation alerts from Pally.gg directly in FaustBot. Trigger actions when supporters send tips through your Pally.gg page.

Overview

Pally.gg is a creator monetization platform. FaustBot connects via webhooks:

Donation Alerts

Receive real-time tip notifications.

Supporter Messages

Access messages sent with donations.

Amount Tracking

Track donation amounts and currency.

Custom Actions

Trigger any action on donations.

Setup

Get Webhook URL

In FaustBot, go to Integrations → Pally.gg. Copy the webhook URL displayed.

Configure Pally.gg

Test Connection

Use the test button in Pally.gg to send a test donation. Verify it appears in FaustBot's action log.

Port Forwarding

Webhooks require FaustBot to be accessible from the internet. Enable the HTTP server and configure port forwarding if needed.

Triggers

Donation Received A supporter sent a tip

Trigger Variables

Variable	Description
`%userName%`	Supporter's display name
`%amount%`	Donation amount
`%currency%`	Currency code (USD, EUR, etc.)
`%message%`	Message from supporter
`%isAnonymous%`	Whether donation is anonymous

Effects

No specific effects are available for Pally.gg. Use the donation triggers to activate other effects like TTS, alerts, or OBS changes.

Scripting API

Control and query Pally.gg donations from your scripts using the CPH API:

Connection Management

Connection management

# Check if connected to Pally.gg
connected = CPH.PallyGGIsConnected()

# Get connection info
info = CPH.PallyGGGetConnectionInfo()

# Connect to Pally.gg
CPH.PallyGGConnect()

# Disconnect from Pally.gg
CPH.PallyGGDisconnect()

# Get connection state
state = CPH.PallyGGGetConnectionState()

Donation Data

Donation data

# Get recent donations (up to 50)
donations = CPH.PallyGGGetRecentDonations(10)

# Get the most recent donation
last = CPH.PallyGGGetLastDonation()
if last:
    CPH.SendMessage(f"Last donation: {last['amount']} {last['currency']} from {last['donorName']}")

# Get donation statistics
count = CPH.PallyGGGetDonationCount()
total = CPH.PallyGGGetTotalDonationAmount()

# Get the top donor
top = CPH.PallyGGGetTopDonor()
if top:
    CPH.SendMessage(f"Top donor: {top['name']} with {top['amount']}")

Available Methods

Method	Description
`PallyGGIsConnected()`	Check if connected to Pally.gg
`PallyGGGetConnectionInfo()`	Get connection details map
`PallyGGConnect()`	Connect to Pally.gg
`PallyGGDisconnect()`	Disconnect from Pally.gg
`PallyGGGetRecentDonations(limit)`	Get list of recent donations (max 50)
`PallyGGGetLastDonation()`	Get the most recent donation
`PallyGGGetDonationCount()`	Get total donation count for session
`PallyGGGetTotalDonationAmount()`	Get total donation amount for session
`PallyGGGetTopDonor()`	Get the top donor from recent donations
`PallyGGHasApiKey()`	Check if API key is configured
`PallyGGGetConnectionState()`	Get state: connected, connecting, disconnected, error

See the full API reference for more details.