Solavel Dokumente
Deutsch

Integrationen

Zuletzt aktualisiert

Der Projekt-Tab Integrationen verbindet ein Projekt mit anderen Systemen:

  • Ausgehende Webhooks senden Projektevents (Aufgabe erstellt, Sprint gestartet, Dokument erstellt…) an einen HTTPS-Endpunkt, der Ihnen gehört und signiert ist, damit der Empfänger ihnen vertrauen kann.
  • Eingehende Webhook-Token lassen ein externes System (ein Formular-Tool, GitHub, ein Skript) Aufgaben oder Kommentare im Projekt erstellen.
  • Öffentliche API-Token geben einem anderen System begrenzten Lese- oder Schreibzugriff auf die Aufgaben und Zeiten des Projekts über die SolaProjects API.
  • Bereitschaft integrierter Anbieter zeigt vorgefertigte Verbindungen (Slack, Microsoft Teams, GitHub, GitLab, Google Calendar, Google Drive, OneDrive, Zapier / IFTTT) und ob der jeweilige Anbieter verbunden werden kann.

Verwenden Sie dies, wenn ein Projekt mit einem anderen Werkzeug kommunizieren muss, etwa um Aufgabenaktualisierungen an ein Kunden-Dashboard zu senden oder Website-Anfragen in Aufgaben umzuwandeln. Projektleitungen und Administratoren richten es ein, üblicherweise einmal pro Projekt gemeinsam mit Ihrer IT-Ansprechperson.

Es gibt zwei Seiten namens Integrationen. Diese Seite deckt den Tab Projekt ab. Das Element Integrationen im Bereich Arbeitsbereich der Seitenleiste (/projects/settings/integrations) ist die VerbindungSolaCount des Unternehmens — siehe unten Organisation SolaCountVerbindung und Budget und Finanzen.

#Wo es zu finden ist

Seitenleiste Abschnitt Projekt → Integrationen (zwischen Automatisierungen und KI)
URL /projects/{project}/integrations
Befehlspalette Integrationen · {project name} unter Aktuelles Projekt

Wer sieht es:

  • Tarif: Integrationen gehören zum Tarif Premium und auch zu Enterprise. Bei niedrigeren Tarifen ist der Tab ausgeblendet. Läuft ein kostenpflichtiger Tarif aus, verschwindet der Tab, und Webhooks werden bis zur Verlängerung nicht mehr angeboten.
  • Rolle: nur Personen, die das Projekt bearbeiten können, können den Tab laden (siehe Berechtigungen). Andere sehen "Wir konnten die Integrationen nicht laden." mit Wiederholen.

#Bildschirmführung

#Kopfzeilenkarte

Integrationen — Ausgehende Webhooks, eingehende Token und Zustellungsverlauf.

Kachel Bedeutung
Ausgehend Aktive ausgehende Webhooks.
Eingehende Token Aktive, nicht widerrufene Eingangstoken.
Kürzliche Zustellungen Zustellungsversuche aufgelistet in Letzte Zustellungen.
Fehlgeschlagene Zustellungen Fehlgeschlagene Versuche dazwischen (rot, wenn über Null).

#Karte für ausgehende Webhooks

Senden Sie Projekt-Events per POST an einen externen HTTPS-Endpunkt, signiert mit HMAC-SHA256. Neuer Webhook oben rechts.

Jede Webhook-Karte zeigt den Namen, Endpunkt-URL, einen Status-Badge (Aktiv, Deaktiviert oder Archiviert), einen Chip pro abonniertem Ereignis und {n} Zustellungen · {n} fehlgeschlagen. Zeilenaktionen (nicht bei archivierten Webhooks): Bearbeiten, Testen, Geheimnis rotieren, Archivieren.

Leerer Zustand: Keine ausgehenden Webhooks — Erstellen Sie einen, um Ereignisse an ein externes System zu senden.

#Karte für eingehende Webhook-Token

Lassen Sie externe Systeme Aufgaben/Kommentare durch POSTen mit einem geheimen Token erstellen. Neues Token oben rechts.

Jede Token-Karte: Name, Anbieter (Benutzerdefiniert oder GitHub) · zuletzt verwendet {date} oder nie verwendet, Badge Aktiv, Inaktiv oder Widerrufen. Aktionen (nicht bei widerrufenen Token): Rotieren, Widerrufen.

Leerer Zustand: Keine eingehenden Token — Erstellen Sie einen Token, um eingehende Webhooks zu akzeptieren.

#Karte für die öffentliche API

Erstellen Sie scoped Bearer-Token für dokumentierte Projekt-, Aufgaben- und Zeiteintrag-Endpunkte. Schaltflächen: Dokumentation (öffnet die OpenAPI-Referenz in einem neuen Tab) und Neuer Token.

Jede Token-Karte: Name, zuletzt verwendet {date} / nie verwendet, Status-Badge, ein Chip pro Fähigkeit. Aktionen: Rotieren, Widerrufen.

Leerer Zustand: Keine API-Token — Erstellen Sie ein Token für die öffentliche API.

#Karte der letzten Zustellungen

Ausgehende Zustellversuche und deren Ergebnis. Badge mit der Anzahl.

Spalte Bedeutung
Wann Datum der Zustellung.
Webhook Webhook-Name oder Archivierter Webhook.
Veranstaltung Ereignistyp, z. B. task.status_changed.
Status Zugestellt (grün), Ausstehend (bernsteinfarben, wartend oder wiederholend), Fehlgeschlagen (rot), Übersprungen.
Versuche Wie oft SolaProjects versucht wurde.
Antwort Der von Ihrem Endpunkt zurückgegebene HTTP-Statuscode, Fehler, wenn keine Antwort empfangen wurde, oder —.
(Schaltfläche) Wiederholen bei jeder Zustellung, die nicht zugestellt wurde.

Leerer Zustand: Noch keine Lieferungen vorhanden — Zustellversuche erscheinen hier, sobald ein Ereignis ausgelöst wird oder Sie einen Test senden.

#Karte zur Bereitschaft nativer Anbieter

Verbindungsstatus und Einrichtungsvoraussetzungen für anbieterspezifische Integrationen. Eine Kachel pro Anbieter:

Anbieter Was es tut
Slack Projektbenachrichtigungen an Slack senden und Aufgabenbefehle von Slack empfangen.
Microsoft Teams Projektbenachrichtigungen an Teams-Kanäle senden und Teams-Aktionen unterstützen.
GitHub Repository-Ereignisse, Issues, Pull-Requests und Commits mit Projektaufgaben verknüpfen.
GitLab GitLab Merge-Requests, Issues und Pipeline-Ereignisse mit Projektaufgaben verknüpfen.
Google Calendar Projektmeilensteine und Aufgabentermine mit Google Calendar synchronisieren.
Google Drive Projektdokumente an Google Drive-Ordner anhängen oder synchronisieren.
OneDrive Projektdokumente an OneDrive-Ordner anhängen oder synchronisieren.
Zapier / IFTTT Stellen Sie SolaProjectsTrigger und Aktionen für No-Code-Plattformen bereit.

Jede Kachel zeigt einen Status (Verfügbar, Ausstehend, Aktiv, Fehlgeschlagen), die Funktion und entweder Konfiguration des Live-Anbieters erkannt. oder Lokaler Simulator verfügbar; Produktionszugangsdaten gehören zu den Aktivierungseinstellungen. (der Anbieter ist für Ihre Organisation noch nicht live). Außerdem können Durch fehlende Einrichtung blockiert: …, Aktivierungshinweise: …, OAuth-Rückruf ausstehend., Letzter Fehler: …, die letzte Nachricht oder das zuletzt empfangene Ereignis angezeigt werden.

#Sendbare Ereignisse

Wählen Sie eines oder mehrere im Webhook-Formular aus:

Veranstaltung Gesendet, wenn
task.created Eine Aufgabe wird erstellt (einschließlich von einem eingehenden Webhook).
task.updated Eine Aufgabe wird bearbeitet.
task.status_changed Der Status einer Aufgabe ändert sich.
task.completed Eine Aufgabe wird als erledigt markiert.
task.blocked Eine Aufgabe wird als blockiert markiert.
comment.created Ein Aufgabenkommentar wird hinzugefügt.
doc.created Ein Projektdokument wird erstellt.
time_entry.created Zeit wird erfasst.
milestone.completed Ein Meilenstein wird abgeschlossen.
sprint.started / sprint.completed Ein Sprint beginnt / endet.
share_link.created Ein Freigabelink für Gäste wird erstellt.
automation.run_failed / automation.rule_failed Eine Automatisierungsausführung schlägt fehl.
ai.suggestion_applied Ein KI-Vorschlag wird angewendet.

Jede Anfrage ist ein JSON-POST mit den Headern X-SolaProjects-Event (Ereignistyp), X-SolaProjects-Delivery (Zustellungs-ID), X-SolaProjects-Signature (HMAC-SHA256 des unveränderten Inhalts mit Ihrem Signaturgeheimnis) und User-Agent: SolaProjects-Webhooks/1.0. Prüfen Sie die Signatur, bevor Sie einer Anfrage vertrauen.

Wiederholungsversuche. Eine fehlgeschlagene Zustellung wird automatisch nach etwa 1, 5, 15 und 60 Minuten erneut versucht; nach dem fünften Versuch verbleibt der Status bei Fehlgeschlagen. Verwenden Sie Wiederholen, um den Versuch manuell zu starten.

#Aufgaben

#Ausgehenden Webhook erstellen

  1. Öffnen Sie das Projekt → Integrationen → Neuer Webhook.

  2. Füllen Sie Neuer ausgehender Webhook aus:

    Feld Erforderlich Regeln / Vorgaben Notizen
    Name Ja Bis zu 160 Zeichen. z. B. Kunden-Dashboard.
    Endpunkt-URL (HTTPS) Ja Gültige URL, bis zu 2.048 Zeichen, öffentliches HTTPS. Platzhalter https://example.com/hooks/solaprojects. Lokale und private Netzwerkadressen werden abgelehnt: "Verwenden Sie einen öffentlichen HTTPS-Endpunkt. Lokale und private Netzwerk-URLs sind gesperrt."
    Ereignisse Ja Mindestens eines. Siehe Tabelle oben.
    Aktiv — Standardmäßig angehakt. Abwählen, um es als Deaktiviert zu speichern.
  3. Klicken Sie auf Erstellen. Sie sehen Ausgehender Webhook wurde erstellt. und das Dialogfeld Signaturgeheimnis: "Speichern Sie dies jetzt – es wird nur einmal angezeigt und kann später nicht mehr abgerufen werden." Klicken Sie auf Kopieren (In die Zwischenablage kopiert.), speichern Sie das Geheimnis im Empfangssystem und klicken Sie dann auf Fertig.

#Webhook bearbeiten, testen, rotieren und archivieren

Aktion Schritte Ergebnis
Bearbeiten Name, URL, Events oder Aktiv → Speichern ändern. Ausgehender Webhook aktualisiert.
Testen Klicken Sie auf Testen. Test-Zustellung in Warteschlange gestellt. Eine Zeile erscheint in Letzte Lieferungen.
Geheimnis rotieren Bestätigen Geheimnis rotieren — "Das aktuelle Geheimnis funktioniert nicht mehr. Aktualisieren Sie verbundene Dienste mit dem neuen Geheimnis." Geheimnis rotiert. und das neue Geheimnis wird einmalig angezeigt.
Archiv Bestätigen Webhook archivieren — "Dieser ausgehende Webhook wird keine Projektereignisse mehr zustellen." Webhook archiviert. Abzeichen Archiviert; keine weiteren Lieferungen; Verlauf bleibt erhalten.

#Eingehenden Webhook-Token erstellen

  1. Klicken Sie auf Neues Token bei Eingehende Webhook-Token.
  2. Name (erforderlich, bis zu 160 Zeichen) und Anbieter: Benutzerdefiniert (Standard) oder GitHub.
  3. Klicken Sie auf Erstellen → Incoming-Token wurde erstellt. Kopieren Sie das Incoming-Webhook-Token, das nur einmal angezeigt wird: "Verwenden Sie dies als Token in Ihrer Incoming-Webhook-URL. Wird nur einmal angezeigt."

Das externe System sendet dann POST /api/projects/webhooks/incoming/{token} mit einem JSON-Body (Limit: 60 Anfragen pro Minute pro Absender):

Anbieter Inhalt Was passiert
Benutzerdefiniert {"title": "...", "description": "...", "priority": "high"} Erstellt eine private Aufgabe in Zu erledigen (Priorität standardmäßig auf medium; Titel wird nach 180 Zeichen gekürzt). Die Antwort enthält das neue task_key.
Benutzerdefiniert {"task_key": "ALN-14", "comment": "..."} Fügt dieser Aufgabe einen internen Kommentar hinzu.
GitHub Issue- oder Issue-Kommentar-Ereignis Ein Issue wird zu einer Aufgabe; ein Kommentar zu einem Issue, dessen Titel einen Aufgaben-Key enthält (z. B. ALN-14), wird zu einem Kommentar für diese Aufgabe.

Alles andere wird mit "Webhook abgelehnt." abgelehnt; ein widerrufener oder falscher Token erhält dieselbe Antwort. Aufgaben und Kommentare werden von der Person erstellt, die das Token erstellt hat.

Erneuern stellt ein neues Token aus und widerruft das alte sofort (Token erneuert.). Widerrufen fragt Token widerrufen — „Anfragen mit diesem Token haben keinen Zugriff mehr.“ → Token widerrufen.

#Token für die öffentliche API erstellen

  1. Klicken Sie auf Neues Token bei Öffentliche API.

  2. Name (erforderlich, bis zu 120 Zeichen) und Fähigkeiten (mindestens eine; projects:read, tasks:read und time:read sind vorausgewählt):

    Fähigkeit Erlaubt
    projects:read Dieses Projekt lesen.
    tasks:read / tasks:write Aufgaben lesen / erstellen und aktualisieren.
    time:read / time:write Zeiteinträge lesen / erstellen.
  3. Erstellen → API-Token erstellt. Kopieren Sie das Projekt-API-Token: "Verwenden Sie dies als Bearer-Token für /api/v1. Wird nur einmal angezeigt."

Über die API angelegte Aufgaben lösen dieselben Automatisierungen und Webhooks aus wie in der App angelegte Aufgaben. Rotieren → Token erneuern bestätigen, mit „Das aktuelle Token wird ungültig. Aktualisieren Sie verbundene Dienste mit dem neuen Token.“ → API-Token rotiert. Widerrufen → API-Token widerrufen.

#Fehlgeschlagene Zustellung erneut versuchen

Klicken Sie in Letzte Lieferungen auf der Zeile auf Wiederholen → Lieferung wiederholt. Überprüfen Sie nach einem Moment den Status und die Antwort.

#Nativen Anbieter verbinden

  1. Wählen Sie auf der Anbieterkachel den Kanal (z. B. #projekte für Slack) und klicken Sie auf Verbinden → {Provider} Verbindung gestartet.
  2. Schließen Sie den Autorisierungsdialog {Provider} Autorisierung mit Rückruf abschließen (oder Später) → Native Integration verbunden.
  3. Sobald verbunden, verwenden Sie Test senden ({Provider} Testnachricht gesendet.), Aktualisieren ({Provider} aktualisiert.) oder Trennen ({Provider} getrennt.).

Kacheln im Simulatormodus zeigen auch Ereignis simulieren und Fehler zum Überprüfen der Einrichtung, bevor der Anbieter live geht; sie kontaktieren nicht den echten Dienst.

#Status

Objekt Status
Ausgehender Webhook Aktiv, Deaktiviert (gespeichert, wenn Aktiv nicht markiert), Archiviert
Lieferung Ausstehend, Geliefert, Fehlgeschlagen, Übersprungen
Eingehender Token / API-Token Aktiv, Inaktiv, Widerrufen
Nativer Anbieter Verfügbar, Ausstehend, Aktiv, Fehlgeschlagen

#Berechtigungen

Rolle Öffnen Sie die Registerkarte Webhooks, Token, Anbieter erstellen / ändern
Eigentümer der Organisation Ja Ja
Projektadministrator Ja Ja
Projektmanager, der hier ein Projekt Manager ist Ja Ja
Projektmitglieder, Projekt-Betrachter, Gäste Nein Nein

Sind Integrationsänderungen für Ihre Organisation deaktiviert, ist der Reiter schreibgeschützt (kein Neu, keine Zeilenaktionen und kein Erneut versuchen). Eine abgelehnte Änderung zeigt „Integrationsänderungen sind deaktiviert oder nicht erlaubt.“; eine veraltete Seite „Bitte laden Sie die Seite neu und versuchen Sie es erneut.“ Geheimnisse und Token werden nach dem einmaligen Dialog nie wieder angezeigt — auch nicht für Eigentümer.

#SolaCount-Verbindung der Organisation

Der Eintrag Integrationen (/projects/settings/integrations) in der Seitenleiste des Arbeitsbereichs führt zu einer anderen Seite. Sie zeigt, ob SolaProjects mit SolaCount verbunden ist (Verbunden, Bereit zum Verbinden, Integration pausiert, Getrennt — Verlauf bleibt erhalten, …). Organisationsinhaber oder Finanzadministratoren können dort die Verbindung herstellen, pausieren, trennen oder prüfen. Ein einzelnes Projekt lässt sich auf der Registerkarte Einstellungen ausschließen (Karte Integrationen → Internes Projekt / Finanzen deaktiviert). Siehe Budget und Finanzen und die SolaProjects-Übersicht.

#Praxisbeispiele

#Beispiel 1 — Anfragen werden zu Aufgaben (Alltag)

{User 1 name} möchte, dass Website-Anfragen für {Showroom project name} (DEMO-FIT) als Aufgaben landen.

  1. Neues Token → Name Website-Anfragen, Anbieter Benutzerdefiniert → Erstellen; sie gibt das Token an den Webentwickler weiter.
  2. Die Website postet {"title": "Quote request – reception desk", "priority": "high"}.
  3. Aufgabe ALN-31 Angebotsanfrage – Empfang erscheint in To-do, privat, Priorität Hoch. Die Token-Karte zeigt zuletzt verwendet am 6. Okt..

#Beispiel 2 — Kunden-Dashboard-Feed mit einem Fehlschlag (vollständiges Szenario)

{User 2 name} verbindet das Site-Dashboard von {Organization name}.

Schritt Aktion Ergebnis
1 Neuer Webhook: Site-Dashboard, https://hooks.company.example.com/projects, Ereignisse task.status_changed, task.completed, milestone.completed. Ausgehender Webhook erstellt.; Signatur-Geheimnis wurde an das Dashboard kopiert.
2 Prüfung. Testzustellung in Warteschlange.; Zeile Zugestellt, Antwort 200.
3 {User 1 name} verschiebt ALN-12 nach Erledigt. Zwei Zustellungen: task.status_changed und task.completed, beide Zugestellt.
4 Das Dashboard ist wegen Wartungsarbeiten nicht verfügbar. Die nächste Zustellung zeigt Ausstehend, dann Fehlgeschlagen mit Antwort 503; Kopfzeile Fehlgeschlagene Zustellungen 1 in Rot; es wird nach ca. 1, 5, 15, 60 Minuten erneut versucht.
5 Dashboard wieder online; {User 2 name} klickt auf Wiederholen. Zustellung wiederholt. → Zugestellt.
6 Die IT vermutet, dass das Geheimnis durchgesickert ist. {User 2 name} klickt auf Geheimnis rotieren und bestätigt. Geheimnis rotiert.; neues Geheimnis einmalig angezeigt; IT aktualisiert das Dashboard.

#Wie es sich verbindet

Wo Link
Aufgaben Eingehende Token und die API erstellen Aufgaben und Kommentare; Aufgabenänderungen senden Ereignisse.
Planung Meilensteinabschluss und Sprint-Start/Abschluss senden Ereignisse.
Automatisierungen Agieren Sie innerhalb SolaProjects; fehlgeschlagene Ausführungen können als Ereignisse versendet werden.
Freigabelinks für Gäste share_link.created Ereignis.
KI ai.suggestion_applied Ereignis.
Zeiterfassung time_entry.createdEreignis; Zeit-API-Funktionen.
Einstellungen Projektbezogener SolaCountFinanz-Umschalter.

#Tipps und häufige Probleme

Problem Ursache Lösung
Tab fehlt. Plan unter Premium oder abgelaufen. Höherstufen oder verlängern.
Verwenden Sie einen öffentlichen HTTPS-Endpunkt… Die URL ist http, localhost oder eine private Adresse. Eine öffentliche HTTPS-URL verwenden.
Geheimschlüssel oder Token verloren. Wird nur einmal angezeigt. Rotieren und das andere System aktualisieren.
Zustellungen Fehlgeschlagen mit einem 4xx-Code. Ihr Endpunkt lehnt die Anfrage ab (oft bei der Signaturprüfung). Prüfen Sie, ob der Endpunkt das aktuelle Geheimnis verwendet.
Webhook abgelehnt. bei eingehenden Aufrufen. Widerrufenes/falsches Token, oder der Body hat kein title oder task_key + comment. Token und Anfrageinhalt prüfen.
Kommentar aus GitHub nicht hinzugefügt. Issue-Titel enthält keinen Aufgabenschlüssel. Setzen Sie den Schlüssel (z. B. ALN-14) in den Vorgangstitel.
API verweigert den Zugriff. Dem Token fehlt die Fähigkeit oder es ist widerrufen. Erstellen Sie ein Token mit den richtigen Fähigkeiten.
Anbieter sagt Lokaler Simulator ist verfügbar… Für Ihre Organisation noch nicht verfügbar. Fragen Sie Solavel Support bezüglich der Aktivierung.