- Dokumentation
- Automationen
- BuiltByBit: Käufe, Updates und Bewertungen melden
BuiltByBit: Käufe, Updates und Bewertungen melden
Für Creator auf BuiltByBit: yurna meldet Käufe, neue Versionen und Bewertungen in deinen Kanälen und vergibt auf Wunsch eine Käufer-Rolle.
Für Creator auf BuiltByBit: yurna meldet Käufe, neue Versionen und Bewertungen deiner Ressourcen als Embeds in deinen Kanälen. Auf Wunsch bekommen Käufer automatisch eine Rolle.
Im Dashboard#
- Öffne Dashboard → Inhalte & Automationen → BuiltByBit (
/dashboard/<server>/builtbybit). - Klicke unter Verbindungen auf BuiltByBit verbinden. yurna legt dir eine eigene Webhook-Adresse samt Vorlage an.
- Kauf-Webhook: Lege auf BuiltByBit im Creator-Dashboard unter Webhooks einen neuen Webhook an – Trigger „Purchase“, Methode POST, Inhaltstyp application/json, Vorlage „Custom template“. Füge die Webhook-Adresse ein. Die Vorlage holst du über Vorlage mit Secret anzeigen → Vorlage kopieren.
- API-Token (Ultimate) – optional: Für Updates, Bewertungen und die Käufer-Rolle fügst du deinen Private-Token der BuiltByBit Ultimate API ein und klickst auf Prüfen & speichern.
- Unter Meldungen wählst du je Ereignis (Käufe, Updates, Bewertungen) einen Kanal, auf Wunsch Ping-Rollen, einen Link-Knopf und ein eigenes Embed. Schalte Meldung aktiv ein und klicke auf Test senden.
- Optional: Ordne unter Käufer-Rolle einer Ressource (oder allen) eine Rolle zu und sende das Panel „Kauf bestätigen“ in einen Kanal.
Käufe kommen sofort per Webhook. Updates und Bewertungen fragt yurna regelmäßig ab.
Achtung
Gib die Vorlage nicht weiter – sie enthält dein Secret. Bei Verdacht klickst du auf Neues Secret erzeugen und ersetzt die Vorlage in BuiltByBit. Der API-Token hat vollen Zugriff auf dein Konto: yurna nutzt ihn nur lesend, speichert ihn verschlüsselt und zeigt ihn nie wieder an.
Datenschutz#
Standardmäßig steht in Meldungen „ein Käufer“ statt des BuiltByBit-Namens. Mit Käufername anzeigen änderst du das – wähle dann am besten einen Kanal, den nur dein Team sieht.
Käufer-Rolle#
Käufer verknüpfen ihr Discord-Konto in ihrem BuiltByBit-Konto. Ist die Person schon auf dem Server, gibt yurna die Rolle beim Kauf sofort. Alle anderen klicken im Panel auf „Kauf bestätigen“; yurna prüft die Lizenz über die API. Codes oder Formulare brauchst du nicht.
Premium#
| Neumond | Halbmond | Vollmond | |
|---|---|---|---|
| Kauf- und Update-Meldungen | ✓ | ✓ | ✓ |
| Bewertungs-Meldungen | – | ✓ | ✓ |
| Eigene Embeds | – | ✓ | ✓ |
| Käufer-Rolle | – | ✓ | ✓ |
| Mehrere BuiltByBit-Konten je Server | – | – | ✓ |
Die aktuell gültigen Grenzen zeigt die Premium-Seite.
Per Befehl#
Verbindung, Webhook-Secret, API-Token und eigene Embeds richtest du im Dashboard ein – /shop status verlinkt die Seite. Alles andere geht auch in Discord mit /shop builtbybit:
| Befehl | Was er macht | Wichtige Optionen |
|---|---|---|
/shop status | zeigt verbundene Shops, aktive Meldungen und Käufer-Rollen (Etsy und BuiltByBit) | – |
/shop builtbybit set <event> (deutsch: setzen) | richtet eine BuiltByBit-Meldung ein oder ändert sie | event (ereignis): Kauf, Update oder Bewertung · connection (verbindung): nur nötig, wenn du mehrere hast (Liste) · channel (kanal) · enabled (aktiv): an/aus · ping-roles (ping-rollen): Rollen-Erwähnungen, - = keine · link-button (link-knopf) · resources (ressourcen): nur diese Ressourcen-IDs, z. B. 123, 456, - = alle · min-stars (min-sterne): Bewertungen ab so vielen Sternen |
/shop builtbybit test <event> | sendet die gespeicherte Meldung mit Beispielwerten als Test (höchstens 5 je Minute) | connection |
/shop builtbybit role-set <resource> <role> (rolle-setzen) | Käufer dieser Ressource bekommen die Rolle; * = jede Ressource | resource (ressource): aus der Liste oder Ressourcen-ID · role (rolle) · connection |
/shop builtbybit role-remove <resource> (rolle-entfernen) | entfernt die Zuordnung; bereits vergebene Rollen bleiben | connection |
/shop builtbybit panel <channel> | postet das Panel „Kauf bestätigen“ (erst nach mindestens einer Käufer-Rolle) | connection |
Du brauchst „Server verwalten“. Optionen, die du weglässt, bleiben unverändert. Käufer-Rollen brauchen den API-Token und Halbmond.
Häufige Fragen#
Warum kommen keine Kauf-Meldungen?#
Prüfe in BuiltByBit, ob der Webhook die richtige Adresse und die aktuelle Vorlage hat. Unter Kauf-Webhook siehst du, wann zuletzt ein Aufruf kam. Nach Neues Secret erzeugen musst du die Vorlage in BuiltByBit ersetzen.
Was heißt „Token ungültig“?#
BuiltByBit nimmt den gespeicherten Token nicht mehr an – etwa weil er widerrufen wurde oder Ultimate abgelaufen ist. Updates, Bewertungen und die Käufer-Rolle ruhen dann. Hinterlege einen neuen Token.
Brauche ich BuiltByBit Ultimate?#
Nur für Updates, Bewertungen und die Käufer-Rolle. Kauf-Meldungen laufen über den Webhook auch ohne Token.
Was passiert beim Trennen?#
Secret, Token, alle Meldungen und Rollen-Zuordnungen dieser Verbindung werden sofort gelöscht. Entferne den Webhook danach auch in deinem BuiltByBit-Konto.
Die Seite zeigt „BuiltByBit-Modul pausiert“?#
Der Betreiber hat das Modul gerade abgeschaltet. Deine Einstellungen bleiben erhalten.
Siehe auch#
Zuletzt aktualisiert am 29. Oktober 2026