Ko-fi Triggers

Ko-fi events delivered straight to your SAMMI!
Honoring your Ko-fi members and automatically thanking them for their subscriptions and purchases on your stream is now possible with this extension!

Features

Triggers

• Donation – single donation events
• Subscription – first time and monthly
• Commission
• Shop Orders – any shop order

Setup

1. Install the extension. You can follow the Extension Install Guide.
2. Reload your Bridge. It must be running at all times for the extension to function properly.
3. Edit the red INIT button:
   1. Itch Key – Enter the itch key you received upon purchase on the Itch.io page (you'll also find the link in your email).
   2. Navigate to Ko-fi Webhooks (while logged in):
      • Fill out the Webhook URL (replace YOURITCHKEY with your own key):
        https://lioranboard-websocket-7we7k.ondigitalocean.app/kofihook/YOURITCHKEY
      • Press Update.
      • Click on Advanced and copy-paste the verification token.
   3. Press Save and then Save again.
4. Reload your Bridge again.
5. Navigate to the Ko-Fi Triggers tab in your Bridge, and it should say connected.
6. Navigate back to Ko-fi Webhooks, scroll down, and send test triggers. The example buttons in the premade deck should trigger when you send a test trigger.

Triggers

Donation

Triggers for every new donation.
Extension Trigger: Ko-Fi Donation

Example payload:

{
  "message_id": "3a1fac0c-f960-4506-a60e-824979a74e74",
  "timestamp": "2022-08-21T13:04:30Z",
  "type": "Donation",
  "is_public": true,
  "from_name": "Ko-fi Team",
  "message": "Good luck with the integration!",
  "amount": "3.00",
  "url": "https://ko-fi.com/Home/CoffeeShop?txid=0a1fac0c-f960-4506-a60e-824979a74e71",
  "email": "someone@example.com",
  "currency": "USD",
  "is_subscription_payment": false,
  "is_first_subscription_payment": false,
  "kofi_transaction_id": "0a1fac0c-f960-4506-a60e-824979a74e71",
  "verification_token": "3401eedb-7a5e-4ceb-aa43-40038281222f",
  "shop_items": null,
  "tier_name": null
}

Subscription

Triggers for all Ko-Fi subscription events (first-time and recurring).
Extension Trigger: Ko-Fi Subscription

Example payload:

{
  "message_id": "3a1fac0c-f960-4506-a60e-824979a74e74",
  "timestamp": "2022-08-21T13:04:30Z",
  "type": "Subscription",
  "is_public": false,
  "from_name": "Ko-fi Team",
  "message": "Good luck with the integration!",
  "amount": "3.00",
  "url": "https://ko-fi.com/Home/CoffeeShop?txid=0a1fac0c-f960-4506-a60e-824979a74e71",
  "email": "someone@example.com",
  "currency": "USD",
  "is_subscription_payment": true,
  "is_first_subscription_payment": true,
  "kofi_transaction_id": "0a1fac0c-f960-4506-a60e-824979a74e71",
  "verification_token": "3401eedb-7a5e-4ceb-aa43-40038281222f",
  "shop_items": null,
  "tier_name": null
}

Commission

Triggers for all Ko-Fi commission events.
Extension Trigger: Ko-Fi Commission

Example payload not provided by Ko-fi.

Shop Order

Triggers for all Ko-Fi shop order events.
Extension Trigger: Ko-Fi Shop Order

Example payload:

{
  "message_id": "3a1fac0c-f960-4506-a60e-824979a74e74",
  "timestamp": "2022-08-21T13:04:30Z",
  "type": "Shop Order",
  "is_public": true,
  "from_name": "Ko-fi Team",
  "message": "",
  "amount": "27.95",
  "url": "https://ko-fi.com/Home/CoffeeShop?txid=0a1fac0c-f960-4506-a60e-824979a74e71",
  "email": "someone@example.com",
  "currency": "EUR",
  "is_subscription_payment": false,
  "is_first_subscription_payment": false,
  "kofi_transaction_id": "0a1fac0c-f960-4506-a60e-824979a74e71",
  "verification_token": "3401eedb-7a5e-4ceb-aa43-40038281222f",
  "shop_items": [
    { "direct_link_code": "1a2b3c4d5e" },
    { "direct_link_code": "a1b2c3d4e5" }
  ],
  "tier_name": null
}