Alle Tools PAX PM-Toolbox · Integrationen

Integrationen und API

PAX mit Teams, Slack, Outlook, Jira, Trello, MS Project, n8n, Make, Zapier, Confluence und SharePoint verbinden.

Überblick

Die Tools laufen ohne Konto im Browser. Was hier steht, braucht den PAX-Server und meist den Team-Tarif. Grundregel überall: Eine Integration sieht nie mehr als die Person, die sie einrichtet. Private Dokumente und private Einträge gehen nie hinaus.

📥 Import Free

Jira (CSV, JSON), Trello (JSON) und MS Project (XML) als neues Kanban-Board oder Gantt-Projekt. Ohne Konto, ganz im Browser.

💬 Benachrichtigungen Team

Nachrichten an Microsoft Teams, Slack oder per Mail, wenn Dokumente angelegt, geändert oder gelöscht werden.

🔗 Webhooks Team

JSON an deine eigene Adresse, signiert, mit Wiederholung und Zustellprotokoll.

🔑 API-Schlüssel Team

Für n8n, Make, Zapier und eigene Skripte: Dokumente lesen und schreiben, Kalender lesen, Webhooks anmelden.

📅 Outlook Team

Urlaube, Termine, Sprints und Meilensteine aus dem Team-Jahreskalender im eigenen Outlook-Kalender.

🧩 Einbetten Team+

Tools in Confluence und SharePoint, mit Anmeldung und gemeinsamen Daten.

  1. Import aus Jira, Trello und MS Project
  2. Benachrichtigungen an Teams, Slack und E-Mail
  3. Webhooks und Signatur
  4. API und API-Schlüssel
  5. n8n, Make und Zapier
  6. Outlook-Kalender
  7. Einbetten in Confluence und SharePoint
  8. schauben-Konto für die Dienste von schauben_

Ob eine Integration bei dir zur Verfügung steht, siehst du im Admin Panel unter Integrationen oben in der Statuszeile. Einrichten dürfen Personen mit dem Team-Recht „Integrationen verwalten“ (Besitzer und Administratoren).

Import aus Jira, Trello und MS Project

Im Kanban-Board und im Gantt Chart gibt es den Knopf 📥 Importieren. Er legt immer ein neues Board bzw. Projekt an, nichts wird überschrieben. Die Datei bleibt in deinem Browser.

QuelleDateiWas übernommen wird
JiraFilter › Exportieren › CSV (alle Felder), englisch oder deutsch; oder JSON der REST-APIZusammenfassung, Schlüssel, Status (wird Spalte), Priorität, zugewiesene Person, Fälligkeit, Startdatum, Labels, Beschreibung, Epic (im Gantt eine Gruppe)
TrelloBoard-Menü › Drucken, Exportieren und Teilen › Als JSON exportierenListen (werden Spalten), Karten, Mitglieder, Fälligkeit, Labels mit Farbe, Checklisten als Text und Fortschritt; archivierte Karten nicht
MS ProjectDatei › Speichern unter › Dateityp XML-Format (*.xml)Vorgänge mit Start und Ende, Meilensteine, Fortschritt, Vorgänger, Ressourcen, Notizen; Sammelvorgänge werden Gruppen

Online abrufen (Team-Tarif, wenn euer PAX-Server es kann): Jira Cloud mit Adresse, Mail und API-Token und einer JQL-Abfrage, Trello mit Board-Link, Key und Token. PAX nutzt die Zugangsdaten nur für diesen Abruf und speichert sie nicht.

Benachrichtigungen an Teams, Slack und E-Mail

Admin Panel › Integrationen › + Neu. Ereignisse: Dokument angelegt, geändert, gelöscht, Mitglied beigetreten oder ausgetreten; auf Wunsch nur für ein Tool. Änderungen am selben Dokument fasst PAX zusammen (höchstens eine Nachricht je 30 Sekunden).

Microsoft Teams

  1. Im gewünschten Kanal: ⋯ › Workflows › Vorlage „Bei Empfang einer Webhook-Anforderung im Kanal posten“.
  2. Den Workflow anlegen und die angezeigte Adresse kopieren (sie beginnt mit https:// und enthält logic.azure.com oder powerplatform.com).
  3. In PAX Art „Microsoft Teams“ wählen, Adresse einfügen, Testen.

Slack

  1. Unter api.slack.com/apps eine App anlegen, Incoming Webhooks einschalten, „Add New Webhook to Workspace“, Kanal wählen.
  2. Die Adresse (https://hooks.slack.com/services/…) in PAX unter Art „Slack“ eintragen, Testen.

E-Mail

Geht nur an aktive Mitglieder des Teams (keine Gäste, keine fremden Adressen). Die Mail enthält Titel, Tool und Link, nie den Inhalt.

Adressen von Teams und Slack sind selbst ein Geheimnis. PAX speichert sie verschlüsselt und zeigt sie nur gekürzt an.

Webhooks und Signatur

PAX schickt ein POST mit JSON an deine Adresse (nur https, keine internen Netze). Beim Anlegen zeigt PAX einmal das Geheimnis whsec_….

Nutzlast

{
  "id": "5f0c…",                     // eindeutig je Ereignis, für Duplikate
  "ereignis": "dokument.geaendert",
  "zeit": "2026-11-03T10:15:00.000Z",
  "team": { "id": "…", "name": "Beispiel-Team" },
  "objekt": { "art": "dokument", "id": "…", "tool": "kanban", "toolName": "Kanban-Board",
              "titel": "Sprint-Board", "version": 12,
              "url": "https://pax-tools.de/tools/kanban.html?dok=…" },
  "von": { "id": "…", "anzeigename": "Ada Beispiel" }
}

Ereignisse: dokument.erstellt, dokument.geaendert, dokument.geloescht, mitglied.beigetreten, mitglied.ausgetreten, beim Testen test. Inhalte schickt PAX nie; den Inhalt holst du bei Bedarf über die API.

Köpfe und Signatur prüfen

X-PAX-Ereignis, X-PAX-Zustellung und X-PAX-Signatur: t=<Unix-Sekunden>,v1=<HMAC-SHA256>. Die Signatur ist HMAC-SHA256 über <t>.<Rumpf> mit dem Geheimnis, als Hex.

// Node.js
const crypto = require('crypto');
function echt(rumpf, kopf, geheimnis) {
  const [, t, v1] = /t=(\d+),v1=([0-9a-f]{64})/.exec(kopf) || [];
  if (!t || Math.abs(Date.now() / 1000 - Number(t)) > 300) return false;   // höchstens 5 Minuten alt
  const soll = crypto.createHmac('sha256', geheimnis).update(`${t}.${rumpf}`).digest('hex');
  return crypto.timingSafeEqual(Buffer.from(soll), Buffer.from(v1));
}
# Python
import hmac, hashlib, re, time
def echt(rumpf: bytes, kopf: str, geheimnis: str) -> bool:
    m = re.match(r"t=(\d+),v1=([0-9a-f]{64})", kopf or "")
    if not m or abs(time.time() - int(m[1])) > 300: return False
    soll = hmac.new(geheimnis.encode(), m[1].encode() + b"." + rumpf, hashlib.sha256).hexdigest()
    return hmac.compare_digest(soll, m[2])

Wiederholungen

Antwortet deine Adresse nicht mit 2xx, versucht PAX es nach 1, 5, 30, 120 und 360 Minuten erneut. Antworten 4xx (außer 408 und 429) gelten sofort als endgültig. 410 Gone pausiert den Webhook (so meldet ihn ein Dienst ab). Nach 20 endgültig fehlgeschlagenen Zustellungen in Folge pausiert PAX ihn und schickt der anlegenden Person eine Mail. Das Protokoll der letzten 30 Tage steht im Admin Panel.

API und API-Schlüssel

Admin Panel › Integrationen › API-Schlüssel. Der Schlüssel (pax_…) ist nur einmal sichtbar, PAX speichert nur einen Prüfwert. Er handelt mit den Rechten der Person, die ihn angelegt hat, und gilt nur, solange sie im Team ist und „Integrationen verwalten“ darf. Höchstens 60 Anfragen je Minute und Schlüssel.

Adresse: https://app.pax-tools.de/api/v1/extern · Kopf: Authorization: Bearer pax_…

AufrufRechtWas
GET /ich–Team, Schlüssel und Rechte
GET /dokumente?tool=kanbandokumente:lesenListe der Dokumente, die die Person sehen darf (ohne private), seitenweise über weiter
GET /dokumente/{id}dokumente:lesenInhalt (JSON wie beim Export des Tools)
POST /dokumentedokumente:schreibenneues Dokument im Team: { "tool", "titel", "inhalt" }
PUT /dokumente/{id}dokumente:schreibenändern: { "inhalt", "basisVersion" }, bei fremder Änderung 409 mit dem aktuellen Stand
GET /kalender?von=&bis=kalender:lesenTeam-Jahreskalender nach den Rechten der Person, private nur als „belegt“
GET /ereignisse–alle Ereignisse mit Beispiel-Nutzlast
POST /webhookswebhooksWebhook anmelden: { "url", "ereignisse": [ … ] } → { id, geheimnis }
DELETE /webhooks/{id}webhooksWebhook abmelden
curl -H "Authorization: Bearer pax_ab12cd34_…" \
     "https://app.pax-tools.de/api/v1/extern/dokumente?tool=statusreport"

Fehler kommen als { "fehler": { "code", "text" } } mit passendem Status: 401 Schlüssel ungültig, 403 Recht fehlt, 404 nicht gefunden (auch bei privaten Dokumenten), 409 Konflikt, 429 zu viele Anfragen.

n8n, Make und Zapier

Es gibt (noch) keine fertigen Bausteine im Katalog dieser Dienste. Die allgemeinen HTTP- und Webhook-Bausteine reichen aber für alles.

n8n

  1. Auslöser: Knoten „Webhook“ (POST) anlegen, die Produktions-Adresse in PAX als Webhook eintragen. Optional einen „Code“-Knoten mit der Signaturprüfung von oben dahinter.
  2. Aktion: Knoten „HTTP Request“ mit Credential „Header Auth“ (Name Authorization, Wert Bearer pax_…), URL z. B. …/extern/dokumente/{{ $json.objekt.id }}.

Make

  1. Auslöser: „Webhooks › Custom webhook“, Adresse kopieren und in PAX eintragen, in PAX Testen drücken, damit Make die Struktur lernt.
  2. Aktion: „HTTP › Make a request“ mit Kopf Authorization: Bearer pax_….

Zapier

  1. Auslöser: „Webhooks by Zapier › Catch Hook“, Adresse in PAX eintragen, Test schicken.
  2. Aktion: „Webhooks by Zapier › Custom Request“ oder „GET“ mit dem Kopf wie oben.
  3. Wer eine eigene Zapier-Integration baut: REST-Hooks über POST /extern/webhooks anmelden, beim Abschalten DELETE /extern/webhooks/{id}; Beispiel-Daten liefert GET /extern/ereignisse.

Outlook-Kalender

Jede Person verbindet ihr Microsoft-365-Konto im Panel › Verbindungen. PAX legt dort einen eigenen Kalender „PAX · Teamname“ an und schreibt hinein:

PAX bekommt nur die Rechte „Kalender lesen und schreiben“ und „Profil lesen“, keinen Zugriff auf Mails. Manche Firmen verlangen eine Freigabe durch die IT (Entra ID › Unternehmensanwendungen). Administratoren schalten den Abgleich fürs Team im Admin Panel ab. Ohne Microsoft geht weiter das Kalender-Abo (ICS) im Jahreskalender.

Einbetten in Confluence und SharePoint

Mit Team+ laufen die Tools direkt in eurem Wiki, mit Anmeldung und den gemeinsamen Daten des Teams.

1. Einschalten

  1. Admin Panel › Integrationen › Einbetten: die Domain eures Wikis eintragen, z. B. firma.atlassian.net oder firma.sharepoint.com, dann einschalten.
  2. Tool und optional ein Dokument wählen. PAX zeigt die Adresse (https://app.pax-tools.de/api/v1/einbetten/…) und den fertigen HTML-Code.

2. Confluence

3. SharePoint Online

  1. Websiteeinstellungen › HTML-Feldsicherheit: app.pax-tools.de zu den erlaubten Domains hinzufügen (macht ein Website-Besitzer).
  2. Seite bearbeiten › Webpart Einbetten › HTML-Code aus dem Admin Panel einfügen.

4. Anmelden im Wiki

Browser geben eingebetteten Seiten meist keine Cookies. Deshalb öffnet Anmelden im eingebetteten Tool ein kleines Fenster von pax-tools.de. Dort meldest du dich wie gewohnt an (mit zweitem Faktor) und gibst die Anmeldung mit einem Klick an das Tool weiter. Sie gilt nur für dieses Team, nur für die Tools (nicht für Konto oder Admin Panel), höchstens einen Arbeitstag und endet, wenn du dich bei PAX abmeldest.

Popups erlauben: Blockt der Browser das Anmeldefenster, erlaube Popups für die Wiki-Seite. In Confluence muss das iFrame-Makro Popups zulassen (Standard).

Andere Seiten als die eingetragenen können PAX nicht einbetten: Der Browser blockt das (Content-Security-Policy frame-ancestors). Wird ein Tool ohne die PAX-Hülle eingebettet, läuft es wie ein normales Tool ohne Konto.

schauben-Konto für die Dienste von schauben_

Dein PAX-Konto ist zugleich dein schauben-Konto: Bei quickcopy, cloud-transfair und cloud-traum meldest du dich mit „Mit schauben-Konto anmelden“ an. Beim ersten Mal fragt PAX, welche Angaben der Dienst bekommt (Name, Mail, auf Wunsch die Abos). Abos werden je Dienst getrennt abgerechnet, Pakete über mehrere Dienste sind möglich. Verbundene Dienste siehst und trennst du im Panel › Verbindungen.

Für Entwickler der Dienste

OpenID Connect, Authorization Code mit PKCE (S256 Pflicht). Discovery: https://app.pax-tools.de/api/v1/oidc/.well-known/openid-configuration. Scopes: openid profile email abos offline_access. Clients registriert der Betreiber im Super Admin. Abos melden die Dienste mit ihren Client-Zugangsdaten über PUT /api/v1/schauben/abos/{sub}.