Zum Hauptinhalt springen
connic
Starte kostenlos

Notion

Lass connic-Agenten reagieren, wenn in Notion Seiten entstehen, sich ändern oder Kommentare dazukommen. Die Agenten antworten in der Diskussion des Kommentars oder legen neue Seiten an.

Modi
Inbound, Outbound
Einrichtung
Dashboard oder connectors/*.yaml
Dokumentation
Notion Docs
Publisher
Von connic

Reagiere auf Seiten und Kommentare

Passt eine Seite oder ein Kommentar zu den Events und der Datenquelle einer eingehenden Verbindung, startet jeder damit verknüpfte Agent. Eine ausgehende Verbindung mit derselben Connection postet das Ergebnis als Kommentar.

Events und Datenquelle wählen
Reagiere auf neue Seiten, geänderte Properties oder neue Kommentare, überall, wo die Integration hinsieht, oder nur in einer Datenbank.
Ein Abo, viele Verbindungen
Das Abo gehört zur Integration. connic leitet jedes Event an alle passenden Verbindungen der Connection weiter.
Keine Schleifen, keine doppelten Runs
Änderungen der Integration selbst ignoriert connic, und ein Event, das Notion erneut schickt, startet keinen zweiten Run.
  1. In Notion passiert etwas

    Jemand legt eine Seite an, ändert ihre Properties oder schreibt einen Kommentar.

    page.created
  2. connic prüft das Event

    connic prüft die Signatur mit dem Verifizierungstoken des Abos und liest die Seite oder den Kommentar bei Notion nach.

    X-Notion-Signature
  3. Verknüpfte Agenten starten

    Der Run erhält Titel, Link, Properties und Inhalt der Seite in Markdown oder den Text des Kommentars.

    comment.created
  4. Die Antwort landet in der Diskussion

    Eine ausgehende Verbindung mit derselben Connection kommentiert die Seite, in der Diskussion des Kommentars, der den Run gestartet hat.

Ein Secret, ein Abo

Du fügst das Secret der Integration einmal ein und legst in Notion ein Webhook-Abo mit der URL an, die connic dir zeigt. Notion schickt danach ein Verifizierungstoken, das connic dir zum Zurückkopieren anzeigt.

Deine Integration, dein Workspace
Die Integration gehört zu deinem Notion-Workspace und sieht nur, was du mit ihr teilst. Du kannst sie in Notion jederzeit entfernen.
Signierte Events
connic prüft jedes Event mit dem Verifizierungstoken und behält es, sobald das erste signierte Event angekommen ist.
Aktuelle Inhalte
Events nennen nur eine Seite oder einen Kommentar. connic liest deshalb die aktuelle Fassung bei Notion, bevor der Agent startet.
notion-verification.http
POST https://connect.connic.co/notion/<connection-id>

{
  "verification_token": "secret_…"
}

Kommentiere Seiten oder lege neue an

Eine ausgehende Notion-Verbindung postet den Output des Agenten, egal ob der Run auf eine Seite antwortet oder von einer anderen Verbindung oder einem Zeitplan kommt.

Routing
Eine page_id im Output hat Vorrang. Ohne sie kommentiert ein Run, den eine Seite über dieselbe Connection gestartet hat, genau dort. Jeder andere Run legt eine Seite in der Datenquelle der Verbindung an.
Drei Wege zu senden
Sende nach jedem abgeschlossenen Run, gib dem Modell ein Tool oder rufe send_connector aus Middleware auf, wenn dein Code entscheidet.
Seiten in Markdown
Neue Seiten übernehmen den Output als Markdown, mit Überschriften und Listen. Bremst Notion per Rate Limit, wartet connic und sendet erneut.
output.json
{
  "title": "Weekly churn report",
  "body": "## Summary\n\n4 accounts cancelled."
}
connector-payload.json
{
  "body": "Approved. The refund goes out today.",
  "page_id": "1f2e3d4c5b6a47988a7b6c5d4e3f2a1b"
}

Wo Notion passt

Wähle ein Szenario und sieh, was beim Agenten ankommt und was er in Notion postet.

Jemand trägt eine Anfrage in eine Datenbank ein, und der Agent kommentiert mit einer ersten Einschätzung.

Neue Seite
Inbound Notion
request-triage
Kommentar auf der Seite
notion-payload.json
{
  "event": "page.created",
  "page_id": "1f2e3d4c-5b6a-4798-8a7b-6c5d4e3f2a1b",
  "title": "Refund request: order 1042",
  "text": "Order 1042 arrived two weeks late. The customer asks for a refund.",
  "url": "https://www.notion.so/acme/1f2e3d4c5b6a47988a7b6c5d4e3f2a1b"
}
output.json
{
  "body": "Eligible: delivery was 14 days late. Suggest a full refund of 49 EUR."
}

Jemand stellt in einem Kommentar eine Frage, und der Agent antwortet in derselben Diskussion.

Neuer Kommentar
Inbound Notion
docs-helper
Antwort in der Diskussion
notion-payload.json
{
  "event": "comment.created",
  "page_id": "1f2e3d4c-5b6a-4798-8a7b-6c5d4e3f2a1b",
  "title": "Onboarding guide",
  "text": "Does this still apply to the EU region?",
  "url": "https://www.notion.so/acme/1f2e3d4c5b6a47988a7b6c5d4e3f2a1b"
}
output.json
{
  "body": "Yes, except step 4: EU projects pick the region at signup."
}

Ein Entwurf wechselt auf Ready for review, und der Agent liest ihn und hinterlässt seine Anmerkungen.

Status geändert
Inbound Notion
draft-review
Review-Kommentar
notion-payload.json
{
  "event": "page.properties_updated",
  "page_id": "1f2e3d4c-5b6a-4798-8a7b-6c5d4e3f2a1b",
  "title": "Launch post draft",
  "text": "# Launch post\n\nToday we ship…",
  "url": "https://www.notion.so/acme/1f2e3d4c5b6a47988a7b6c5d4e3f2a1b"
}
output.json
{
  "body": "Two claims need a source, and the pricing paragraph is outdated."
}

Ein Zeitplan startet den Agenten jeden Montag, und er schreibt den Bericht als Seite in eine Datenbank.

Zeitplan
Cron
weekly-report
Neue Seite in Reports
schedule.json
{
  "schedule": "0 8 * * MON",
  "timezone": "Europe/Berlin"
}
output.json
{
  "title": "Weekly churn report",
  "body": "## Summary\n\n4 accounts cancelled."
}

FAQ zu Notion

Das Secret einer internen Notion-Integration, die du unter notion.so/my-integrations anlegst. Die Integration sieht nur die Seiten und Datenbanken, die du mit ihr teilst.

Von der Integration. Events, die die Integration auslöst, ignoriert connic, damit sich ein Agent nicht mit seinen eigenen Kommentaren erneut startet.

Notion schickt ein Event meist innerhalb einer Minute. Änderungen an den Properties einer Seite innerhalb von etwa einer Minute kommen als ein Event, Events können in anderer Reihenfolge ankommen, und Notion versucht, jedes Event höchstens einmal zu schicken.

Ja, mit type: notion, den Events, optional einer Datenquelle und dem Namen einer Notion-Connection, die das Secret der Integration enthält.