Zum Hauptinhalt springen
connic
Starte kostenlos
Verbindungen

Notion

Agenten starten, wenn in Notion Seiten entstehen, sich ändern oder Kommentare dazukommen, und ihre Ergebnisse als Kommentar oder neue Seite posten.

Zuletzt aktualisiert
ModiInbound, Outbound
YAML-Typnotion
ZugangsdatenEin Kontozugang (Connection) vom Typ notion mit dem Secret einer internen Notion-Integration
BridgeNicht unterstützt
Custom DomainNicht unterstützt
Verknüpfte AgentenEiner oder mehrere. Jedes passende Event startet alle verknüpften Agenten.
Während der PauseEvents erhalten 200 und starten keine Runs. Outbound sendet nichts.

Einrichtung

  1. Lege unter notion.so/my-integrations eine interne Integration an und schalte die Capabilities ein, die deine Verbindungen brauchen. Kopiere das Internal Integration Secret aus dem Tab Configuration. Öffne dann jede Seite oder Datenbank, die deine Agenten sehen sollen, wähle im Drei-Punkte-Menü Connections und füge die Integration hinzu.

  2. Klicke in connic unter Projekt-Settings → Connections auf New connection und wähle Notion. Den Kontozugang kannst du auch im Formular der Verbindung über die Auswahl unter Connection anlegen. Gib einen Name ein, füge das Secret unter Integration secret ein und klicke auf Create connection. connic prüft das Secret bei Notion und zeigt die Webhook URL.

  3. Für Inbound-Verbindungen öffnest du in Notion den Tab Webhooks der Integration, legst ein Abo mit der Webhook-URL an und wählst die Events, die deine Verbindungen nutzen. Klicke danach in connic im Kontozugang auf Refresh, bis das Verification token erscheint, kopiere es und füge es in Notion unter Verify ein.

  4. Öffne den Agenten. Klicke im Connector Flow für Events zu Seiten und Kommentaren auf Add inbound connector oder für Kommentare und Seiten auf Add outbound connector. Klicke dann auf Create New Connector und wähle Notion.

  5. Wähle den Modus, Inbound (Page and comment events) oder Outbound (Comments and pages), und unter Connection den Kontozugang. Trag bei Inbound die Events ein, optional auch eine Data source. Klicke auf Create. Bei Outbound legst du danach fest, wie der Agent die Verbindung nutzt, und klickst auf Link connector.

Konfiguration

Die Felder einer Notion-Verbindung, in connectors/*.yaml genauso wie in der REST API und connic MCP. Die Beschreibungen nennen die passende Einstellung im Dashboard. Verbindungen im Code beschreibt die Felder, die alle Verbindungen gemeinsam haben, etwa agents und environments.

FeldTypStatusBeschreibung
typestringRequirednotion.
modestringRequiredinbound oder outbound. Dashboard: Mode.
connectionstringRequiredInbound und Outbound. Name oder ID eines Notion-Kontozugangs. Jede Inbound-Verbindung darauf erhält die Events der Integration. Dashboard: Connection.
configobjectRequiredEinstellungen der Notion-Verbindung.
eventsstring[]RequiredInbound. Die Events, die Runs starten: page.created, page.properties_updated und comment.created. Abonniere in Notion dieselben Events. Dashboard: Events, einer pro Zeile, vorausgefüllt mit page.created und comment.created.
data_sourcestringOptionalInbound und Outbound. Ein Link zu einer Datenbank oder einer ihrer Datenquellen. Hat eine Datenbank mehrere Datenquellen, brauchst du den Link einer davon. Inbound-Verbindungen erhalten nur Events ihrer Seiten, Outbound-Verbindungen legen dort Seiten an. Teile die Datenbank mit der Integration. Dashboard: Data source.

Das Secret der Integration gehört zum Kontozugang, nicht zur Verbindung. Das gilt auch für Accept a new verification token; siehe Abo in Notion.

Erzeugte Werte

connic setzt diese Werte, wenn du die Verbindung oder ihren Kontozugang speicherst oder Notion das Verifizierungstoken schickt.

WertModiBeschreibung
Webhook-URLInboundDie URL des Kontozugangs für das Abo in Notion. Eine URL bedient alle Verbindungen des Kontozugangs.
VerifizierungstokenInboundDas Token, das Notion an die Webhook-URL schickt, sobald du das Abo anlegst. connic prüft damit die Signatur jedes Events.
Bot-Nutzer und WorkspaceInbound, OutboundDer Bot-Nutzer der Integration und ihr Workspace. connic speichert beides beim Speichern des Kontozugangs.
DatenquelleInbound, OutboundID, Name und Titel-Property der Datenquelle, die du per Link einträgst.

Agent-Input

Modi: Inbound

Die Events von Notion nennen nur die Seite oder den Kommentar, deshalb liest connic beides zuerst bei Notion nach. Danach startet eine Inbound-Verbindung einen Run für jeden verknüpften Agenten, wenn Events und Datenquelle passen. Der Run erhält:

payload.json
{
  "event": "comment.created",
  "page_id": "1f2e3d4c-5b6a-4798-8a7b-6c5d4e3f2a1b",
  "title": "Erstattung: Bestellung 1042",
  "url": "https://www.notion.so/acme/Erstattung-Bestellung-1042-1f2e3d4c5b6a47988a7b6c5d4e3f2a1b",
  "data_source_id": "8c7b6a59-4e3d-4c2b-9a1f-0e9d8c7b6a59",
  "properties": { "Status": { ... }, "Name": { ... } },
  "text": "Können wir das heute freigeben?",
  "authors": ["3a2b1c0d-9e8f-4a7b-8c6d-5e4f3a2b1c0d"],
  "conversation_id": "notion:1f2e3d4c-5b6a-4798-8a7b-6c5d4e3f2a1b",
  "comment_id": "2a3b4c5d-6e7f-4089-9a1b-2c3d4e5f6a7b",
  "discussion_id": "9d8c7b6a-5f4e-4d3c-8b2a-1f0e9d8c7b6a",
  "raw": { ... }
}
  • event ist das Notion-Event, etwa page.created.
  • page_id, title, url und properties beschreiben die Seite, auch bei Kommentaren. data_source_id ist bei Seiten in einer Datenbank gesetzt.
  • text ist bei Events zu Seiten deren Inhalt in Markdown und bei comment.created der Text des Kommentars. Dann sind auch comment_id und discussion_id gesetzt.
  • conversation_id bleibt für alle Events einer Seite gleich. Soll dein Agent die früheren Events als Verlauf kennen, setze in seiner YAML session.key: input.conversation_id. Von sich aus schaltet der Connector keine Sessions ein.
  • authors sind die IDs der Notion-Nutzer, die das Event ausgelöst haben, und raw ist das Event, so wie Notion es gesendet hat.

Schickt Notion ein Event erneut, startet kein weiterer Run. Der Inbound-Modus antwortet nicht von selbst: Für einen Kommentar auf der Seite verknüpfst du den Agenten mit einer Outbound-Notion-Verbindung, die denselben Kontozugang nutzt; siehe Outbound-Zustellung.

Integration und Capabilities

Die Integration sieht nur Seiten und Datenbanken, die mit ihr geteilt sind. Kommentare und Seiten deiner Agenten erscheinen unter der Integration, und Events, die sie selbst auslöst, ignoriert connic. So starten sich Agenten nicht mit ihren eigenen Kommentaren selbst. Schalte die Capabilities im Tab Configuration der Integration unter Capabilities ein:

CapabilityNötig für
Read contentInbound. connic liest zu jedem Event die Seite.
Read commentsInbound, für comment.created.
Insert commentsKommentare über Outbound.
Insert contentNeue Seiten in einer Datenquelle über Outbound.

Abo in Notion

Modi: Inbound

Ein Webhook-Abo gehört zur Integration. Du legst es also einmal pro Kontozugang in Notion an, und connic leitet jedes Event an die Inbound-Verbindungen des Kontozugangs weiter. Nach dem Anlegen schickt Notion ein Verifizierungstoken an die Webhook-URL. connic speichert es am Kontozugang, zeigt es dort an und prüft damit die Signatur jedes Events.

Sobald das erste signierte Event angekommen ist, behält connic das Token und ignoriert neue. Notion kann ein Abo nicht auf eine andere URL umziehen. Schalte für ein neues Abo deshalb zuerst im Kontozugang Accept a new verification token ein. Das nächste Token von Notion ersetzt dann das gespeicherte, und connic schaltet die Einstellung wieder aus. Speicherst du den Kontozugang mit dem Secret einer anderen Integration, löscht connic das Token ebenfalls.

Outbound-Zustellung

Modi: Outbound

Eine Outbound-Notion-Verbindung postet bei jeder Nutzung einmal: wenn der Run eines verknüpften Agenten abgeschlossen ist, wenn das Modell sie als Tool aufruft oder wenn Middleware sie aufruft, je nach Nutzung der Verknüpfung. Dabei gilt die erste zutreffende Regel:

  1. Nennt die Ausgabe oder der Payload eine page_id, als Link oder ID einer Seite, kommentiert sie diese Seite.
  2. Kam der Run über eine Inbound-Notion-Verbindung mit demselben Kontozugang, kommentiert sie die Seite, aus der er stammt. Hat ein Kommentar den Run gestartet, antwortet sie in dessen Diskussion.
  3. Sonst legt sie eine neue Seite in der Datenquelle der Verbindung an. Ihr Titel ist title aus Ausgabe oder Payload, ohne ihn die erste Zeile des Texts, und der Text wird zum Inhalt der Seite.

Automatische Ausgabe

Eine automatische Verknüpfung postet die finale Ausgabe des Runs. Klartext wird zum Text. Bei einem JSON-Objekt kommt der Text aus body, text, message, response oder output, in dieser Reihenfolge, und title und page_id lassen sich mitgeben. Neue Seiten stellen den Text als Markdown dar, Kommentare als reinen Text.

output.json
{
  "title": "Erstattung freigegeben: Bestellung 1042",
  "body": "Die Bestellung kam zu spät an, die Erstattung ist freigegeben.\n\n- Betrag: 49 EUR\n- Weg: ursprüngliche Zahlungsart"
}

Payload für Agent-Tool und Middleware

Das Modell oder die Middleware übergibt body, Pflicht und nicht leer, und optional title und page_id. Andere Felder werden abgelehnt.

connector-payload.json
{
  "body": "Freigegeben. Die Erstattung geht heute raus.",
  "page_id": "https://www.notion.so/acme/Erstattung-Bestellung-1042-1f2e3d4c5b6a47988a7b6c5d4e3f2a1b"
}

Zustellung und Wiederholungen

Bremst Notion einen Kommentar oder eine Seite per Rate Limit aus, wartet connic und sendet erneut. Die Runs der Verbindung zeigen jede Zustellung mit dem Kommentar oder dem Link zur Seite oder mit dem Fehler.

Limits und Fehler

LimitWert
ZustelldauerNotion schickt ein Event meist innerhalb einer Minute, spätestens nach 5 Minuten.
Gebündelte ÄnderungenÄnderungen an den Properties einer Seite innerhalb von etwa einer Minute kommen als ein einziges Event page.properties_updated.
ReihenfolgeEvents können in anderer Reihenfolge ankommen, als sie passiert sind.
Höchstens einmalNotion versucht, jedes Event höchstens einmal zu schicken, ein Event kann also fehlen. Nimmt connic eine Zustellung nicht an, versucht Notion es bis zu achtmal innerhalb von etwa 24 Stunden erneut.
API-AnfragenNotion erlaubt einer Integration 180 Anfragen pro Minute, in den Tarifen Business und Enterprise 600. Jedes Event braucht zwei Anfragen, jeder Kommentar und jede Seite eine. Bremst Notion per Rate Limit, wartet connic und stellt erneut zu.
Länge eines Kommentars200.000 Zeichen.
Titel einer SeiteOhne title die erste Zeile des Texts, gekürzt auf 2.000 Zeichen.

Events mit fehlender oder falscher Signatur erhalten 401. Kann connic die Seite oder den Kommentar eines Events nicht lesen, zeigen die Runs der Verbindung den Grund; ein Event zu einer Seite, die nicht mit der Integration geteilt ist, startet nichts. Ein Kontozugang lässt sich nicht speichern, wenn Notion das Secret ablehnt, und eine Verbindung nicht, wenn die Integration ihre Datenquelle nicht sieht. Eine Zustellung schlägt fehl, wenn Notion sie ablehnt, etwa weil der Integration eine Capability fehlt.