Zeitgesteuerte Nachrichten

Mit den zeitgesteuerten Nachrichten von BurgerBot kannst du Discord-Nachrichten automatisch zu einem bestimmten Zeitpunkt veröffentlichen.

Du kannst Nachrichten entweder einmalig zu einem festgelegten Datum und einer Uhrzeit oder jeden Tag zu einer bestimmten Uhrzeit senden lassen.

Das eignet sich beispielsweise für:

regelmäßige Erinnerungen

tägliche Community-Nachrichten

Stream-Erinnerungen

Event-Ankündigungen

Shoutouts

Gewinnspiel-Hinweise

wiederkehrende Informationen

Nach der Einrichtung übernimmt der BurgerBot Discord-Bot den Versand automatisch.

Voraussetzung ist, dass dein Discord-Server bereits mit BurgerBot verbunden wurde.

Zeitplanung aktivieren

Aktiviere zunächst:

„Zeitplanung aktiv“

Anschließend kannst du unter „Zeitplan (JSON)“ deine geplanten Nachrichten hinterlegen.

Nach dem Speichern übernimmt BurgerBot die weitere Ausführung.

Wie funktioniert der Zeitplan?

Die geplanten Nachrichten werden aktuell im JSON-Format hinterlegt.

Ein Zeitplan besteht aus einem Array mit einer oder mehreren Nachrichten.

Jede Nachricht enthält Informationen darüber:

welche Nachricht gesendet wird

in welchen Discord-Kanal sie gesendet wird

wann sie gesendet wird

und optional:

ob sie täglich wiederholt werden soll

Aufbau einer Nachricht

Eine geplante Nachricht kann beispielsweise so aussehen:

{"id":"daily1","channelId":"123456789","content":"Guten Abend!","at":"18:00","daily":true}

Die einzelnen Angaben haben folgende Bedeutung.

id

id ist die eindeutige interne Bezeichnung des Eintrags.

Beispiel:

"id":"daily1"

Jede geplante Nachricht sollte eine eigene ID besitzen.

Du kannst dafür beispielsweise sprechende Namen verwenden:

stream_reminder

daily_news

community_abend

giveaway

Vermeide es, dieselbe ID mehrfach innerhalb deines Zeitplans zu verwenden.

channelId

Unter:

channelId

trägst du die Discord Channel-ID des Kanals ein, in dem die Nachricht veröffentlicht werden soll.

Beispiel:

"channelId":"123456789"

Damit weiß BurgerBot, wohin die Nachricht gesendet werden soll.

Channel-ID kopieren

Um die Channel-ID eines Discord-Kanals kopieren zu können, muss der Developer Mode / Entwicklermodus in Discord aktiviert sein.

Klicke anschließend mit der rechten Maustaste auf den gewünschten Kanal und wähle:

„Kanal-ID kopieren“

Die kopierte ID kannst du anschließend in deinen JSON-Zeitplan eintragen.

content

Unter:

content

trägst du die Nachricht ein, die BurgerBot auf Discord veröffentlichen soll.

Beispiel:

"content":"Guten Abend!"

Oder beispielsweise:

"content":"🔴 Nicht vergessen: Heute um 20 Uhr startet der Stream!"

at

Mit:

at

bestimmst du, wann die Nachricht veröffentlicht werden soll.

Wie dieser Wert verwendet wird, hängt davon ab, ob es sich um eine tägliche oder einmalige Nachricht handelt.

Tägliche Nachrichten

Möchtest du eine Nachricht jeden Tag zur gleichen Uhrzeit veröffentlichen, verwendest du eine Uhrzeit zusammen mit:

"daily":true

Beispiel:

[
  {
    "id": "daily1",
    "channelId": "123456789",
    "content": "Guten Abend!",
    "at": "18:00",
    "daily": true
  }
]

BurgerBot sendet diese Nachricht anschließend jeden Tag um 18:00 Uhr in den angegebenen Discord-Kanal.

Zeitzone

Bei täglichen Nachrichten verwendet BurgerBot die Serverzeit:

Europe/Berlin

Dadurch beziehen sich Uhrzeiten wie:

18:00

auf die entsprechende lokale Zeit.

Das solltest du insbesondere beachten, wenn sich deine Community überwiegend in einer anderen Zeitzone befindet.

Einmalige Nachrichten

Du kannst Nachrichten auch nur einmal zu einem bestimmten Zeitpunkt veröffentlichen lassen.

Dafür verwendest du bei at ein entsprechendes ISO-Datum mit Uhrzeit und lässt die tägliche Wiederholung weg.

Der Eintrag ist dann für einen konkreten Zeitpunkt vorgesehen und wird nicht jeden Tag erneut ausgeführt.

Das eignet sich beispielsweise für:

ein einmaliges Community-Event

einen besonderen Stream

eine Deadline

eine Ankündigung

oder:

eine einmalige Erinnerung

Mehrere Nachrichten planen

Du kannst mehrere Einträge gleichzeitig innerhalb des JSON-Arrays hinterlegen.

Beispielsweise:

[
  {
    "id": "morning",
    "channelId": "123456789",
    "content": "☀️ Guten Morgen zusammen!",
    "at": "09:00",
    "daily": true
  },
  {
    "id": "evening",
    "channelId": "123456789",
    "content": "🌙 Schönen Abend euch!",
    "at": "18:00",
    "daily": true
  }
]

BurgerBot verarbeitet beide Einträge unabhängig voneinander.

Damit kannst du mehrere automatische Nachrichten für unterschiedliche Uhrzeiten erstellen.

Unterschiedliche Discord-Kanäle

Die Nachrichten müssen nicht alle im gleichen Discord-Kanal veröffentlicht werden.

Da jeder Eintrag eine eigene:

channelId

besitzt, kannst du unterschiedliche Nachrichten in unterschiedlichen Kanälen planen.

Beispielsweise:

09:00 Uhr

Community-Nachricht in #allgemein

18:00 Uhr

Stream-Erinnerung in #stream

20:00 Uhr

Event-Hinweis in #events

Du hinterlegst dafür einfach bei jedem Eintrag die entsprechende Channel-ID.

Beispiel: tägliche Stream-Erinnerung

Du möchtest deine Community jeden Abend um 19:30 Uhr an deinen Stream erinnern.

Dein Zeitplan könnte so aussehen:

[
  {
    "id": "stream_reminder",
    "channelId": "123456789",
    "content": "🔴 Gleich geht's los! Wir sehen uns im Stream 🧡",
    "at": "19:30",
    "daily": true
  }
]

BurgerBot veröffentlicht die Nachricht anschließend jeden Tag automatisch.

Beispiel: mehrere tägliche Nachrichten

Du kannst beispielsweise einen kleinen automatischen Tagesablauf erstellen:

[
  {
    "id": "community_morning",
    "channelId": "123456789",
    "content": "☀️ Guten Morgen Community!",
    "at": "09:00",
    "daily": true
  },
  {
    "id": "stream_reminder",
    "channelId": "987654321",
    "content": "🔴 Heute Abend wieder Stream!",
    "at": "18:00",
    "daily": true
  }
]

Damit kann BurgerBot regelmäßig unterschiedliche Bereiche deiner Community automatisch mit Informationen versorgen.

JSON richtig formatieren

Achte darauf, dass dein Zeitplan gültiges JSON ist.

Der gesamte Zeitplan beginnt mit:

[

und endet mit:

]

Mehrere Einträge werden mit einem Komma voneinander getrennt.

Texte und Werte stehen innerhalb von doppelten Anführungszeichen.

Ein typischer Eintrag enthält:

id

channelId

content

at

und bei täglichen Nachrichten:

daily

Falls BurgerBot den Zeitplan nicht übernehmen kann, solltest du deshalb zuerst überprüfen, ob das JSON korrekt formatiert ist.

Berechtigungen

Damit BurgerBot die geplanten Nachrichten veröffentlichen kann, benötigt der Discord-Bot entsprechende Schreibrechte im angegebenen Kanal.

Sollte eine geplante Nachricht nicht erscheinen, überprüfe deshalb:

Ist die Zeitplanung aktiviert?

Ist die Channel-ID korrekt?

Ist das JSON gültig?

Hat BurgerBot Schreibrechte im Kanal?

Ist die eingetragene Uhrzeit korrekt?

Typische Einsatzmöglichkeiten

Mit zeitgesteuerten Nachrichten kannst du verschiedene wiederkehrende Aufgaben automatisieren.

Beispielsweise:

🔴 Heute Abend um 20 Uhr geht der Stream los!

🎁 Denkt an unser aktuelles Giveaway.

📅 Heute ist Community-Abend!

🎮 Um 19 Uhr starten die Community Games.

📢 Neue Woche, neuer Streamplan!

Dadurch musst du regelmäßig wiederkehrende Discord-Nachrichten nicht mehr jedes Mal selbst schreiben.