NGO.tools Hilfe

Apps

Aktualisiert am 14.11.2026
Eigene Apps für deine Organisation
  1. 0:00Apps
  2. 1:40Apps in NGO.tools

Unter Benutzermenü › Apps verwaltest du die Apps, die deine Organisation selbst entwickelt. Apps sind externe Mini-Apps, die in NGO.tools eingebettet werden. Hier legst du sie an, installierst sie in deiner Organisation, pflegst ihre Angaben und öffnest ihre Entwicklerseite.

So kommst du hin

  1. Öffne das Menü hinter deinen Initialen oben rechts und wähle Apps.#

Die Liste deiner Apps

Die Liste zeigt die Apps deiner Organisation mit Name, Slug, Version und Status. Die Spalte Installiert zeigt, ob die App in deiner Organisation installiert ist. Über Suche findest du eine App nach Name oder Slug, mit Spalten auswählen blendest du Spalten ein oder aus. Neu angelegte Apps erscheinen zuerst.

Eine neue App erstellen

  1. Klicke auf Erstellen.#

    Es öffnet sich der Dialog Quick App.

  • App-Name ist Pflicht. Daraus bildet NGO.tools auch den Slug der App.
  • Eigene Seite ist vorausgewählt und legt einen Menüpunkt mit einer eigenen Seite für die App an. Nur solange es angehakt ist, erscheint Menübereich, in dem du wählst, in welchem Bereich des Menüs die App steht.
  • Dashboard-Widget zeigt die App als kompakte Karte auf dem Dashboard.
  • Kontakt-Tab fügt der Detailseite eines Kontakts einen zusätzlichen Tab hinzu.
  • Kontakt-Massenaktion ergänzt die Kontaktliste um eine Aktion für ausgewählte Kontakte.
  • Mit Abschnitt ausklappen öffnest du die zugeklappten Abschnitte, in denen du optional Ereignisse für Webhooks und die Daten wählst, auf die die App zugreifen darf. Voreingestellt ist Lesezugriff auf Kontakte.
  • Begründung für Berechtigungen erklärt in höchstens 1000 Zeichen, wofür die App ihre Zugriffsrechte braucht. Organisationen, die die App per Einladungscode einbinden, sehen den Text vor der Installation.

Mit Absenden legst du die App an. NGO.tools installiert sie direkt zur Entwicklung in deiner Organisation, trägt dich als Entwickler ein und öffnet ihre Entwicklerseite mit dem Hinweis, den angezeigten Befehl auszuführen. Wo die App erscheint, kannst du später jederzeit ändern.

Eine App aus einer Datei importieren

  1. Klicke auf Aktionen.#
  2. Wähle Aus Datei importieren.#

    In JSON-Datei gehört die Exportdatei einer App.

Nach Absenden prüft NGO.tools die Datei. Gibt es in deiner Organisation schon eine App mit demselben Slug, wird sie aktualisiert, sonst entsteht eine neue App. Gehört der Slug zu einer App einer anderen Organisation, bricht der Import mit einer Meldung ab.

Eine App von einer Adresse importieren

  1. Klicke auf Aktionen.#
  2. Wähle Von URL importieren.#

    In Base URL gehört die Adresse, unter der die App läuft.

Nach Absenden liest NGO.tools unter dieser Adresse die Selbstbeschreibung der App und legt die App mit ihren Angaben, Zugriffsrechten und Oberflächen an. Sie ist zunächst nur für deine Organisation bestimmt. Findet NGO.tools keine gültige Beschreibung, erscheint eine Fehlermeldung.

Eine App per Einladungscode einbinden

  1. Klicke auf Aktionen.#
  2. Wähle Einladungscode einlösen.#

    Gib unter Einladungscode den Code ein, den du von der anderen Organisation bekommen hast. Er hat mindestens 10 Zeichen.

Ist der Code gültig, zeigt NGO.tools die App und, falls vorhanden, ihre Begründung. Fragt die App Zugriff an, wählst du unter Zugriff gewähren auf, was sie bekommt, und bindest sie mit Installieren & Zugriff gewähren ein. Ist der Code ungültig oder abgelaufen oder die App schon installiert, erscheint ein Hinweis.

Die Angaben einer App bearbeiten

  1. Klicke bei der App auf Bearbeiten.#

    Es öffnet sich App bearbeiten mit mehreren Reitern.

  • Allgemein: Pflicht sind Name, Slug und Status. Slug ist der eindeutige technische Bezeichner der App für Adressen und API-Aufrufe und enthält nur Buchstaben, Ziffern, Binde- und Unterstriche. Base URL ist die Adresse, unter der die App läuft, und darf zunächst leer bleiben. Außerdem pflegst du Beschreibung, OAuth Redirect-Pfad, Version, Autor und Autor-URL.
  • Berechtigungen: Unter Berechtigungen legst du fest, auf welche Daten und Funktionen die App zugreifen darf. Organisationen bestätigen sie bei der Installation und neue Berechtigungen erneut.
  • UI-Slots: Unter UI-Slots fügst du mit + Zeilen hinzu, die bestimmen, wo die App erscheint, etwa als Dashboard-Karte, Navigationseintrag oder Tab auf Kontaktseiten. Jede Zeile braucht die Art des Platzes, die Art der Einbindung, einen Pfad und eine Bezeichnung.
  • Webhooks: In Webhook-Pfad steht der relative Pfad auf deinem Server, an den NGO.tools Ereignisse sendet. Unter Events wählst du, bei welchen Ereignissen die App benachrichtigt wird.
  • Einstellungen-Schema: Unter Einstellungen legst du Einstellungsfelder der App an. Jedes Feld braucht einen Schlüssel, einen Feldtyp und eine Bezeichnung; Standardwert und Pflicht sind optional.
  • Entwickler: Unter Freigeschaltete Entwickler wählst du weitere Nutzer deiner Organisation, die den Entwicklermodus der App nutzen dürfen. Wer die App angelegt hat, darf das automatisch.

Wählst du in einer Zeile von UI-Slots einen Navigationseintrag, erscheint in dieser Zeile zusätzlich die Auswahl, in welchem Bereich des Menüs die App steht, und sie ist dort Pflicht.

Die Einstellungsfelder fragt NGO.tools bei der Installation nicht ab. Ausgefüllt werden sie erst nach der Installation auf der Entwicklerseite der App, wenn die App mindestens ein Einstellungsfeld hat. Mit Speichern übernimmst du deine Änderungen.

Eine App in deiner Organisation installieren

  1. Klicke bei der App auf Installieren.#

    Es öffnet sich App installieren.

Installieren erscheint nur bei Apps, die in deiner Organisation noch nicht installiert sind. Unter Zugriff gewähren auf sind die Zugriffsrechte vorausgewählt, die die App anfragt; mit Installieren & Zugriff gewähren installierst du sie.

Gewährst du nur einen Teil der angefragten Rechte, bleibt die App nutzbar und erhält nur diese Rechte.

Die Entwicklerseite einer App öffnen

  1. Klicke bei der App auf Entwickler-Tools.#

Die Entwicklerseite trägt den Namen der App. Sie zeigt, ob die App installiert ist, nach dem Erstellen den Befehl zum Verbinden deiner Entwicklungsumgebung und bei einer installierten App, die Webhooks empfängt, die letzten Zustellungen von Ereignissen.

Eine App exportieren

Mit Exportieren lädst du die Angaben einer App als JSON-Datei herunter. Mit Aus Datei importieren liest du eine solche Datei wieder ein, etwa um die App zu aktualisieren.

Eine App pausieren

  1. Klicke bei der App auf Deaktivieren.#

    Bestätige im Dialog Deaktivieren mit Bestätigen.

Die Aktion gibt es nur bei installierten Apps. Die App wird für alle Nutzer deiner Organisation pausiert: Iframes und Dashboard-Karten werden ausgeblendet, Webhooks nicht mehr zugestellt, und ein Menüpunkt der App verschwindet. Bei einer pausierten App schaltest du sie über dieselbe Aktion wieder ein; sie heißt dann entsprechend anders.

Eine App löschen

  1. Klicke bei der App auf Löschen.#

    Bestätige in App löschen mit Löschen.

Mit Abbrechen bleibt die App erhalten. Der Slug einer gelöschten App bleibt belegt; legst du eine neue App mit demselben Namen an, bekommt sie einen abgewandelten Slug.

Auf der Entwicklerseite arbeiten

Ist die App in deiner Organisation noch nicht installiert, bietet die Entwicklerseite Installieren an. Die weiteren Aktionen der Seite erscheinen erst, wenn die App installiert ist.

  1. Klicke auf Installieren.#

    Wähle in App installieren unter Zugriff gewähren auf die Zugriffsrechte und bestätige mit Installieren & Zugriff gewähren.

Mit Einladungscode erstellen erzeugst du einen Code, mit dem eine andere Organisation die App einbinden kann; optional legst du fest, wie oft er genutzt werden darf und bis wann er gilt. Der Code funktioniert auch, wenn die App nur für deine Organisation bestimmt ist. Unter Einladungen verwalten siehst du deine Codes und löschst sie bei Bedarf.

Mit Neuen Verbindungsbefehl erzeugen bekommst du einen neuen Befehl, den du im Terminal im Projektverzeichnis deiner App ausführst, um deine Entwicklungsumgebung zu verbinden. Er ersetzt einen verlorenen oder abgelaufenen Befehl.

Mit Entwicklermodus leitest du nur für dich die Adressen der App auf deine lokale Entwicklungsumgebung um; andere Nutzer sind nicht betroffen. Die Aktion sehen nur die Person, die die App angelegt hat, und die unter Freigeschaltete Entwickler eingetragenen Nutzer deiner Organisation.

Unter Dokumentation findest du die Angaben, die deine App für die Anbindung braucht, etwa die Adresse der Schnittstelle, die Webhook-Daten und die gewährten Zugriffsrechte.

Mit Berechtigungen verwalten änderst du, welche der angefragten Rechte die installierte App hat. Fragt die App neue Rechte an, ist die Aktion hervorgehoben und heißt so, dass du sie prüfen sollst. Rechte, die die App nicht mehr anfragt, bleiben erteilt, bis du die Berechtigungen erneut bestätigst.

Auch hier pausierst du die App mit Deaktivieren. Mit Deinstallieren entfernst du nach einer Bestätigung die Installation aus deiner Organisation und kehrst zur Liste zurück; die App selbst bleibt in der Liste.

Häufige Fragen

Warum sehe ich den Menüpunkt Apps nicht?

Die Seite steht nur Administratoren deiner Organisation offen. Bitte eine Administratorin oder einen Administrator, die Apps für dich anzulegen oder dir die Rolle zu geben.

Was ist der Unterschied zwischen Deaktivieren und Deinstallieren?

Deaktivieren pausiert die App für alle Nutzer deiner Organisation: Iframes und Dashboard-Karten verschwinden, Webhooks werden nicht mehr zugestellt, die Installation bleibt aber bestehen und lässt sich wieder einschalten. Deinstallieren entfernt die Installation aus deiner Organisation.

Können andere Organisationen eine App nutzen, die nur für uns bestimmt ist?

Ja. Einladungscodes erstellst du unabhängig davon, wie die App sichtbar ist, und beim Einlösen prüft NGO.tools das nicht. Mit einem gültigen Code kann eine andere Organisation die App einbinden; ohne Code bleibt sie ihr verschlossen.

Warum steht eine App, die wir per Einladungscode eingebunden haben, nicht in der Liste?

Die Liste zeigt nur Apps deiner eigenen Organisation. Apps anderer Organisationen, die ihr per Einladungscode oder aus dem Marketplace installiert habt, stehen hier nicht und haben hier keine Entwicklerseite.

Was passiert, wenn Ereignisse meine App dauerhaft nicht erreichen?

Schlägt die Zustellung dauerhaft fehl, schaltet NGO.tools die Webhooks dieser App ab und informiert die Administratoren deiner Organisation per E-Mail. Sobald der Endpunkt der App wieder erreichbar ist, schaltest du die Webhooks auf der Entwicklerseite der App wieder ein.

Auf welche Daten darf eine App zugreifen?

Eine App darf Zugriff auf die Fachbereiche anfragen. Ausgenommen sind der Chat, Shop-Bestellungen und das Vorsingen-Werkzeug. Technische Rechte wie Web-Sitzung, Datenimport, Stammdaten oder die OPTIGEM-Synchronisation bekommt sie ebenfalls nicht.