Andere Programme verbinden: API, Webhooks und Slack- oder Teams-Benachrichtigungen

Unter Integrationen (in den Einstellungen) verbinden Sie Kaam360 mit anderen Programmen. Das ist Teil des Business-Pakets. Nur Administratoren können die Seite öffnen.

Daten mit einem API-Schlüssel lesen

1. Öffnen Sie Einstellungen und wählen Sie Integrationen.
2. Geben Sie unter API-Schlüssel im Feld Name einen Namen ein (zum Beispiel Zapier oder Buchhaltungstabelle) und drücken Sie API-Schlüssel erstellen.
3. Kopieren Sie den angezeigten Schlüssel. Er wird nur einmal angezeigt. Wer den Schlüssel hat, kann alle Daten Ihrer Organisation lesen, halten Sie ihn also geheim.
4. Geben Sie den Schlüssel dem Programm. Es sendet ihn im Header Authorization: Bearer .... Der Bereich Die API verwenden zeigt die Adressen und ein Beispiel.
5. Ein Schlüssel kann nur lesen, außer Sie haken beim Erstellen Diesem Schlüssel erlauben, Leads hinzuzufügen an. Dann kann er auch neue Leads hinzufügen. Sonst kann er nichts ändern oder löschen. Drücken Sie Widerrufen, um einen Schlüssel sofort zu stoppen. Ein Schlüssel funktioniert auch nicht mehr, wenn die Person, die ihn erstellt hat, unter Benutzer abgeschaltet wird; erstellen Sie dann einen neuen über das Konto eines anderen Administrators.

Zapier oder Make verwenden

Zapier und Make verbinden Programme ohne Programmierung. Sie brauchen dafür keine besondere Kaam360-App.

1. Erstellen Sie wie oben einen API-Schlüssel. Haken Sie Diesem Schlüssel erlauben, Leads hinzuzufügen an, wenn Formulare, Anzeigen oder Tabellen Leads in Kaam360 senden sollen.
2. Wählen Sie in Zapier oder Make einen Schritt, der eine Webadresse aufruft (in Zapier: Webhooks by Zapier; in Make: HTTP). Verwenden Sie den Header Authorization: Bearer ... mit Ihrem Schlüssel.
3. Zum Lesen rufen Sie die unter Die API verwenden genannten Adressen auf (zum Beispiel /api/v1/leads oder /api/v1/deals). Um einen Lead hinzuzufügen, senden Sie ein POST an /api/v1/leads mit Nachname oder E-Mail.
4. Die API verwenden verlinkt auch auf /api/v1/openapi.json, die vollständige Beschreibung der API. Das ausführliche Entwicklerhandbuch mit der neueren API (Version 2) finden Sie unter /developers.
5. Um benachrichtigt zu werden, wenn etwas passiert, verwenden Sie bei den Webhooks Ein anderes Programm (signiertes JSON).

Benachrichtigungen in Slack oder Microsoft Teams

1. Erstellen Sie in Slack oder Teams einen eingehenden Webhook für den gewünschten Kanal und kopieren Sie seine Webadresse.
2. Geben Sie unter Integrationen bei Webhooks und Chat-Benachrichtigungen im Feld Name einen Namen ein, wählen Sie Ein Slack-Kanal oder Ein Microsoft-Teams-Kanal und fügen Sie die Webadresse ein.
3. Haken Sie unter Benachrichtigen, wenn an, worüber Sie informiert werden möchten. Haken Sie nichts an, um über alles informiert zu werden.
4. Drücken Sie Adresse hinzufügen und dann Test senden. Im Kanal sollte eine kurze Testnachricht erscheinen.

Ein anderes Programm benachrichtigen

1. Wählen Sie Ein anderes Programm (signiertes JSON) und geben Sie seine Webadresse ein. Sie muss mit https:// beginnen und im öffentlichen Internet liegen.
2. Kopieren Sie das angezeigte Signaturgeheimnis. Es wird nur einmal angezeigt. Das andere Programm prüft damit, dass eine Nachricht wirklich von Kaam360 kommt.
3. Jede Nachricht ist JSON mit einer ID, dem Ereignisnamen, einer kurzen Zusammenfassung und den wichtigsten Angaben. Den vollständigen Datensatz holen Sie über die API.
4. Jede Nachricht ist signiert: Der Header X-Kaam360-Signature enthält einen HMAC-SHA256 aus dem Sendezeitpunkt (X-Kaam360-Timestamp) und der Nachricht. Der Empfänger sollte Nachrichten ablehnen, die älter als fünf Minuten sind, damit eine kopierte Nachricht nicht später erneut gesendet werden kann. Das Entwicklerhandbuch enthält fertigen Code für diese Prüfung.
5. Um eine Adresse, ihre Ereignisse oder ihre Notiz zu ändern, drücken Sie Bearbeiten. Wenn das Geheimnis bekannt geworden sein könnte, drücken Sie Neues Signaturgeheimnis: Das alte funktioniert sofort nicht mehr, geben Sie das neue also gleich an das andere Programm weiter.

Worüber Sie informiert werden können

Ein Kunde oder Lead wurde hinzugefügt, ein Deal wurde gewonnen oder verloren, ein Projekt wurde angelegt oder geändert, eine Aufgabe wurde hinzugefügt, geändert oder abgeschlossen, eine Rechnung wurde geschrieben, ausgestellt (gesendet), bezahlt oder storniert, eine Projektzahlung hat die Stufe gewechselt, ein Vertrag wurde unterschrieben und ein Support-Ticket wurde eröffnet.

Das Zustellprotokoll

Das Zustellprotokoll listet jede Nachricht der letzten zwei Wochen: wann sie gesendet wurde, an welche Adresse, die Antwort des Empfängers (Statuscode und Dauer) und das Ergebnis.

1. Wählen Sie eine Adresse, ein Ergebnis (Zugestellt, Wartet auf erneuten Versuch, Aufgegeben) oder ein Ereignis, um nur diese zu sehen.
2. Drücken Sie Zeigen, was gesendet wurde, um die Nachricht und den Anfang der Antwort des Empfängers zu sehen.
3. Drücken Sie Erneut senden, um eine zugestellte oder aufgegebene Nachricht noch einmal zu senden. Sie behält dieselbe ID, damit der Empfänger die Wiederholung erkennt.

Wenn etwas schiefgeht

• Ist der Empfänger nicht erreichbar, versucht Kaam360 es nach 1 Minute, 5 Minuten, 30 Minuten, 2 Stunden und 12 Stunden erneut und gibt dann auf.
• Eine Adresse, die 15-mal in Folge fehlschlägt, wird ausgeschaltet, und alle, die Integrationen verwalten dürfen, erhalten eine E-Mail. Ein roter Hinweis auf der Seite zeigt, wann es passiert ist. Beheben Sie das Problem, drücken Sie Fortsetzen und senden Sie die verpassten Nachrichten aus dem Zustellprotokoll erneut.
• Adressen in einem privaten Netzwerk (wie localhost, 10.0.0.1 oder 192.168.1.5) sind nicht erlaubt und werden bei jedem Senden erneut geprüft.
• Wenn Sie Integrationen nicht sehen, enthält Ihr Paket es vielleicht nicht, oder Ihre Rolle hat nicht das Recht Integrationen verwalten.