Die Notion-URL-Shortener-Integration wechselte am 4. Juni 2026 von Beta in den Live-Status. Wer Notion als Kampagnenzentrale nutzt, profitiert davon: Elido liest die URLs aus jeder ausgewählten Datenbank, erstellt gebrandete Kurzlinks auf Ihrer Domain, schreibt sie zurück in die Tabelle und beobachtet Zieländerungen. Ein OAuth-Klick, keine eingefügten Tokens, die Feldzuordnung ist pro Datenbank konfigurierbar.
Dieser Artikel beschreibt den OAuth-Verbindungsschritt mit den Berechtigungen, die sechsspaltige Datenbankstruktur und den bidirektionalen Bearbeitungsfluss mit Konfliktlösung. Wer die frühere Notion-Kurzlink-Einführung gelesen hat, findet hier die Vertiefung.
Ein-Klick-OAuth: Was beim Klick auf Verbinden wirklich passiert
Frühere Token-Einfüge-Workflows verlangten, dass man manuell ein internes Notion-Integrationstoken erstellt, einfügt und dann jede Datenbank einzeln mit der Integration teilt. Das ist Geschichte. Der neue Ablauf besteht aus drei Klicks: Verbinden in Elido, Arbeitsbereich und Datenbanken im Notion-Zustimmungsbildschirm auswählen, fertig. Der OAuth-Austausch folgt dem Standard in der Notion-API-Authentifizierungsdokumentation - mit PKCE beim Autorisierungscodetausch.
Die erteilten Berechtigungen sind bewusst eng gefasst:
- read_content - Destination-, Tags- und Title-Eigenschaften in den ausgewählten Datenbanken lesen.
- insert_content - neue Zeilen erstellen, wenn Sie Elido aus einer externen Quelle (einem Zap, einem Webhook, einer CSV-Datei) einen Link erstellen lassen.
- update_content - Short URL, Clicks, QR und Last Synced zurückschreiben.
Elido fragt niemals nach arbeitsbereichsweitem Lesezugriff oder nach Seiten, die nicht ausgewählt wurden. Notion erzwingt dies auch serverseitig: Eine Abfrage gegen eine Datenbank außerhalb der Berechtigung gibt einen 403 zurück. Die Notion-API-Referenz für Datenbankoperationen beschreibt die von der Integration verwendeten Methoden.
Nach Abschluss der Zustimmung trifft der Browser bei api.elido.app/v1/oauth/notion/callback mit dem Autorisierungscode ein. api-core tauscht den Code gegen ein Zugriffstoken aus, verschlüsselt das Token mit dem Arbeitsbereich-KMS-Schlüssel (gemäß ADR-0036) und speichert es in integration_credentials. Das Klartext-Token berührt weder Festplatte noch Logs. Ein Eintrag landet auch im Auditprotokoll, sodass ein Administrator sehen kann, wer welchen Notion-Arbeitsbereich wann verbunden hat.
Die Verbindungsschaltfläche befindet sich im Integrations-Tab des jeweiligen Arbeitsbereichs - genau wie bei jedem anderen Anbieter im Integrationskatalog. Die Notion-Integrationsseite zeigt einen Screenshot des Zustimmungsbildschirms. Berechtigungen können über Notions Einstellungen im Bereich Verbindungen widerrufen werden - ein Widerruf dort löst einen Webhook aus, der das Elido-seitige Token innerhalb von 60 Sekunden löscht.
Zwei Modi: Anhängen oder Erstellen
Im Anhänge-Modus verweist man Elido auf eine bestehende Datenbank mit einer URL-Eigenschaft. Elido fügt nur die benötigten Spalten hinzu, ohne etwas umzubenennen. Im Erstellungs-Modus richtet Elido eine neue "Elido Links"-Datenbank auf der ausgewählten Seite ein. Die meisten Teams wählen den Anhänge-Modus, weil ihre Kampagnentabelle bereits mit Daten aus vielen Quartalen existiert. In beiden Fällen ist das Schema identisch.
Feldzuordnung: die sechs Spalten und ihre Bedeutung
Das ist das Spaltenlayout, das die Integration verwendet. Die Namen sind Standardwerte und können pro Datenbank unter Einstellungen, Notion, Feldzuordnung umbenannt werden.
| Spalte | Notion-Typ | Richtung | Hinweise |
|---|---|---|---|
| Short URL | URL | Elido schreibt | Vom Nutzer aus schreibgeschützt; Bearbeitung hat keinen Effekt. |
| Destination | URL | Notion schreibt | Das Ziel, auf das der Kurzlink verweist. Bearbeitbar. |
| Tags | Mehrfachauswahl | Bidirektional | Tags werden bei Konflikten per Mengenvereinigung zusammengeführt. |
| Clicks | Zahl | Elido schreibt | Alle 5 Minuten abgerufen. Schreibgeschützt. |
| QR | Dateien | Elido schreibt | Ein 1024px-PNG des QR-Codes für die Kurz-URL. |
| Last Synced | Datum | Elido schreibt | UTC-Zeitstempel der letzten Synchronisation. |
Einige Entscheidungen verdienen eine Erklärung.
Clicks ist absichtlich nicht live. Notion hat kein Streaming-Primitiv, und ein Aufruf pro Klick würde das Ratenlimit aufbrauchen. Fünf Minuten entsprechen der Aktualität, die die meisten Ops-Teams benötigen. Für Echtzeit kann ein Webhook für Link-Klickereignisse ausgelöst und an ein eigenes Dashboard weitergeleitet werden. Notion ist die Kampagnenansicht; der Webhook ist der Datenstrom.
QR ist eine Dateieigenschaft, keine URL. Notion rendert externe Bild-URLs nicht in Tabellen, aber eingefügte Dateien werden als Miniaturansichten angezeigt. Elido lädt das PNG beim ersten Sync hoch und lädt es nur dann erneut hoch, wenn sich die Kurz-URL ändert. Siehe die QR-Codes-Funktionsseite und den GS1-QR-Leitfaden.
Tags ist bidirektional mit Mengenvereinigung. Die einzige Spalte, in die beide Seiten schreiben. Wird eine Zeile in Notion mit "launch-2026" markiert und Elido hat "winter-promo" aus einem Zap, existieren beim nächsten Sync beide Tags auf beiden Seiten. Entfernungen werden weitergegeben. Das Auditprotokoll erfasst jede Änderung.
Für UTM-Parameter verknüpft der UTM-Vorlagen-Leitfaden eine Vorlage mit einem Ordner, sodass jeder Link das richtige utm_source erbt. Die Destination-Spalte bleibt sauber, und Elido fügt die Parameter zur Klick-Auflösungszeit über intelligente Linkregeln an.
Der bidirektionale Bearbeitungsfluss: Wer gewinnt, wenn Notion und Elido nicht übereinstimmen
Das ist der Teil, der Teams am meisten interessiert, weil Synchronisationstools eine Geschichte stiller Überschreibungen haben. Hier ist der Vertrag.
Ein Worker in api-core fragt alle fünf Minuten jede verbundene Datenbank nach Änderungen seit dem letzten last_edited_time-Wasserzeichen ab. Bei einer Eigenschaftsänderung lädt er die Feldzuordnung und bestimmt die Eigentümerschaft. Die Regeln sind fest:
- Notion besitzt: Destination, Tags (Schreibseite), Title.
- Elido besitzt: Short URL, Clicks, QR, Last Synced.
- Geteilt: Tags (Leseseite, beide Seiten sehen die zusammengeführte Menge).
Wenn ein Notion-eigenes Feld in Notion geändert wurde, aktualisiert Elido den internen Zustand und sendet ein integration.notion.sync-Ereignis. Wenn ein Elido-eigenes Feld sich geändert hat (eine Klickzahlaktualisierung), schreibt Elido beim nächsten Sync zurück.
Der interessante Fall ist eine Kollision. Angenommen, Destination wird in Notion um 14:02:10 geändert und ein Zap schreibt um 14:02:30 eine neue Destination in Elido - dasselbe Fünf-Minuten-Fenster. Notion besitzt Destination, also gewinnt Notion. Elido verwirft den Zap-Schreibvorgang, hinterlässt einen Kommentar in der Zeile ("Destination-Konflikt um 14:02:30, Notion-Wert behalten, siehe Auditprotokoll") und sendet ein Konfliktereignis, das über Webhooks abonniert werden kann. Der Zap lauscht und entscheidet, ob er es erneut versucht oder eine Benachrichtigung sendet.
Keine stillen Überschreibungen irgendwo. Jeder Schreibvorgang wird protokolliert. Jeder Konflikt erhält einen Zeilenkommentar. Für eine dauerhafte Aufzeichnung kann der Audit-Stream über den ClickHouse-Export-Leitfaden in ein Data Warehouse geleitet oder direkt die GraphQL-API verwendet werden.
Wann eine Zieländerung NICHT weitergegeben werden soll
Manchmal bearbeitet man ein Ziel als Entwurf. Zwei Muster helfen dabei.
Status-Eigenschaft als Schutzschalter. Eine Auswahl namens "Sync" mit den Werten Draft, Live, Paused hinzufügen. Die Integration synchronisiert nur Zeilen, bei denen Sync = Live gilt. Im Entwurf bearbeiten, auf Live umschalten, beim nächsten Tick wird es aufgegriffen. Die meisten Marketing-Teams nutzen diesen Ansatz.
Gesamte Datenbank pausieren. Einstellungen, Notion, pro Datenbank pausieren. Nützlich während einer Migration oder bei Massenbearbeitungen.
Einrichtungsanleitung: von null zur ersten synchronisierten Zeile in 4 Minuten
- Notion verbinden. Arbeitsbereichseinstellungen, Integrationen, Notion, Verbinden. Arbeitsbereich auswählen, Datenbanken ankreuzen, Erlauben.
- Datenbank auswählen. Einstellungen, Notion, "Datenbank hinzufügen". Das Dropdown listet alle gewährten Datenbanken auf. Eine auswählen.
- Felder zuordnen. Destination, Title und den Rest bestätigen. Fehlende Eigenschaften? Elido bietet an, sie zu erstellen.
- Domain auswählen. Eine gebrandete Domain für die Kurzlinks wählen. Noch keine eigene Domain? Die Standarddomain wählen - die Migration ist später ein einziger Klick.
- Speichern und nachfüllen. Elido liest jede Zeile, generiert einen Kurzlink für alle mit Destination aber ohne Short URL und schreibt zurück. Vorhandene Short URLs bleiben unverändert.
Die Wanduhrzeit beträgt etwa 4 Minuten für 200 Zeilen. Größere Nachfüllvorgänge stoßen bei kostenlosen Arbeitsbereichen an Notions Limit von drei Anfragen pro Sekunde. Eine Datenbank mit 5.000 Zeilen wird in etwa 30 Minuten nachgefüllt; der Worker stapelt und setzt automatisch fort, wenn er ratenlimitiert wird.
Wann diese Integration vs. Zapier vs. direkte API-Nutzung sinnvoll ist
Es gibt drei Wege, die sich nicht gegenseitig ausschließen.
Die native Integration ist die richtige Standardwahl, wenn Notion der Arbeitsort ist. OAuth, Konfliktlösung, Auditprotokoll, Feldzuordnung, kein Code erforderlich.
Ein Zap eignet sich für mehrstufige Workflows ("wenn eine Zeile hinzugefügt wird UND eine Slack-Reaktion eingeht, dann einen Link erstellen"). Für die einfache Eins-zu-eins-Zuordnung von Zeile zu Link ist die native Integration schneller und günstiger. Siehe den Zapier-Automatisierungsbeitrag.
Die REST-API ist die richtige Wahl für den Aufbau eines eigenen Workflows auf Elido-Basis. Für Entwickler, die Produktintegrationen bauen, ist der Quellcode unter services/api-core/internal/integrations/notion/ klein genug, um ihn in einer Sitzung zu lesen.
Verglichen mit Bitly oder Rebrandly: Keiner der beiden Anbieter hat zum Zeitpunkt des Schreibens eine native Notion-Integration. Beide erfordern Zapier oder ein benutzerdefiniertes Skript. Siehe die vs. Bitly-Seite für den Vergleich und die Preisseite für die Tarife, die unbegrenzte Notion-Datenbanken einschließen.
Fehlerbehebung: die vier Probleme aus der Beta-Phase
Während der achtwöchigen Beta-Phase traten vier Problemklassen auf. Alle werden jetzt im Code behandelt, aber es hilft zu wissen, wonach man Ausschau halten muss.
"Datenbank nicht gefunden" nach einer Arbeitsbereichsumbenennung. Wenn ein Notion-Administrator den Arbeitsbereich umbenennt, bleibt die Arbeitsbereich-ID stabil, aber zwischengespeicherte Metadaten veralten auf unserer Seite bis zu einer Stunde lang. Abhilfe: "Neuynchronisation erzwingen" unter Einstellungen, Notion. Die Cache-TTL ist in der Produktion auf 15 Minuten eingestellt, sodass dies hauptsächlich ein Beta-Artefakt ist.
Ratenlimit bei einer großen Nachfüllung. Notions Integrationslimit liegt bei drei Anfragen pro Sekunde. Eine Datenbank mit 5.000 Zeilen trifft dieses Limit hart bei der ersten Nachfüllung. Der Worker exponentiell verzögert sich (250ms, 500ms, 1s, 2s, maximal 8s) und setzt fort. Im Aktivitätsprotokoll erscheint "Gedrosselt von Notion, wird fortgesetzt"; das ist normal.
Eigenschaftstyp-Konflikt. Der häufigste Beta-Fehler. Ein Nutzer wählte eine Notion-Spalte vom Typ "Text" für Destination statt "URL". Der Feldzuordnungs-Validator weist dies jetzt beim Speichern zurück. Wenn "Destination muss eine URL-Eigenschaft sein" erscheint, zuerst den Spaltentyp in Notion ändern.
Mehrarbeitsbereich-Nutzer mit gemeinsamen Datenbanken. Wenn dieselbe Person Mitglied zweier Notion-Arbeitsbereiche ist und beide Elido verbinden möchten, benötigt jeder Arbeitsbereich seine eigene OAuth-Berechtigung. Das Token ist arbeitsbereichsbezogen, nicht nutzerbezogen. Der Verbindungsfluss behandelt dies korrekt; man muss nur zweimal auf Verbinden klicken.
Für alles, was nicht auf dieser Liste steht, geht die Kontaktseite direkt an das Integrationsteam. Probleme werden dort schneller gesehen als im allgemeinen Support.
Was als Nächstes kommt
Zwei Erweiterungen sind in der Roadmap. Ein "Notion-Formular zu Kurzlink"-Rezept, sodass eine Formularübermittlung einen nachverfolgten Link erstellt. Und bidirektionale Synchronisation einer Workspace-Eigenschaft, damit ein Link folgen kann, wenn eine Zeile zwischen Datenbanken verschoben wird. Beide sind für Q3 geplant; sie werden im Changelog vermerkt.
Um die Wirkung zu messen, erklärt der Kurzlink-Analyseprimer, welche Metriken wirklich wichtig sind und wie man die Notion-Dashboard-Zeilen so einrichtet, dass sie die richtigen Fragen beantworten.
Häufig gestellte Fragen
Welche Berechtigungen fordert die Notion-Integration an?
Elido fordert insert_content, update_content und read_content für die Seiten oder Datenbanken an, die Sie beim OAuth-Zustimmungsschritt auswählen. Das reicht aus, um neue Zeilen hinzuzufügen, Kurzlinks und Klickzahlen zurückzuschreiben und Zieländerungen zu lesen. Elido fragt niemals nach arbeitsbereichsweitem Zugriff - die Berechtigung ist auf das beschränkt, was Sie in der Notion-Zustimmungsoberfläche ausgewählt haben.
Kann ich die Ziel-URL in Notion bearbeiten und Elido folgt der Änderung?
Ja. Ein Feldbeobachter prüft alle fünf Minuten, ob sich die Destination-Eigenschaft geändert hat. Wenn sich die URL ändert, aktualisiert Elido das Linkziel in api-core, schreibt eine neue Zeile in das Auditprotokoll und sendet einen Webhook, damit nachgelagerte Systeme informiert werden. Die Kurz-URL selbst ändert sich nie, sodass vorhandene QR-Codes und gedruckte Materialien weiterhin funktionieren.
Wie funktioniert die Konfliktlösung, wenn beide Seiten gleichzeitig bearbeiten?
Notion ist die maßgebliche Quelle für Destination, Tags und Title. Elido ist die maßgebliche Quelle für Short URL, Clicks, QR und Last Synced. Wenn eine Eigenschaft während eines Synchronisationsfensters kollidiert, gewinnt die Seite, der das Feld gehört - die andere Seite erhält einen Kommentar in der Zeile, der erklärt, was passiert ist. Es gibt keine stillen Überschreibungen.
Funktioniert die Integration mit dem kostenlosen Notion-Tarif?
Ja, mit zwei Einschränkungen. Kostenlose Notion-Arbeitsbereiche haben ein API-Ratenlimit von drei Anfragen pro Sekunde, sodass sehr große Datenbanken (ab 5.000 Zeilen) in Stapeln von 100 mit kurzem Backoff synchronisiert werden. Außerdem muss beim ersten Mal ein Administrator im Notion-Arbeitsbereich die OAuth-Berechtigung genehmigen. Danach kann jeder mit Datenbankbearbeitungsrechten eine manuelle Neusynchronisation auslösen.
Was passiert, wenn ich die Integration trenne?
Das OAuth-Token wird widerrufen und die verschlüsselte Kopie in api-core innerhalb von 60 Sekunden gelöscht. Vorhandene Zeilen bleiben mit ihren Kurzlinks in der Datenbank erhalten, aber Clicks und Last Synced werden nicht mehr aktualisiert. Wenn Sie die Integration später wieder verbinden, setzt sie dort an, wo sie aufgehört hat, und füllt die Klickzahlen nach, die in der Zwischenzeit aufgelaufen sind.
Elido testen
URL einfügen, kurzer Link in Sekunden
Kein Konto nötig. Link bleibt 30 Tage aktiv. Konto erstellen, um ihn dauerhaft zu behalten.
Kostenlos, keine Anmeldung erforderlich · 2 pro Tag