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
-
Öffnen Sie das Projekt → Integrationen → Neuer Webhook.
-
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. -
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
- Klicken Sie auf Neues Token bei Eingehende Webhook-Token.
- Name (erforderlich, bis zu 160 Zeichen) und Anbieter: Benutzerdefiniert (Standard) oder GitHub.
- 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
-
Klicken Sie auf Neues Token bei Öffentliche API.
-
Name (erforderlich, bis zu 120 Zeichen) und Fähigkeiten (mindestens eine;
projects:read,tasks:readundtime:readsind vorausgewählt):Fähigkeit Erlaubt projects:readDieses Projekt lesen. tasks:read/tasks:writeAufgaben lesen / erstellen und aktualisieren. time:read/time:writeZeiteinträge lesen / erstellen. -
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
- Wählen Sie auf der Anbieterkachel den Kanal (z. B. #projekte für Slack) und klicken Sie auf Verbinden → {Provider} Verbindung gestartet.
- Schließen Sie den Autorisierungsdialog {Provider} Autorisierung mit Rückruf abschließen (oder Später) → Native Integration verbunden.
- 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.
- Neues Token → Name Website-Anfragen, Anbieter Benutzerdefiniert → Erstellen; sie gibt das Token an den Webentwickler weiter.
- Die Website postet
{"title": "Quote request – reception desk", "priority": "high"}. - 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. |