HilfezentrumIntegrationen

Für: Administratoren

Verstehen Sie, was die API leisten kann.

Erfahren Sie, welche Funktionen eine Verwaltungstaste und eine Hub-Taste jeweils haben, warum jede Taste als virtueller Assistent fungiert und wo Sie die vollständige technische Auflistung finden.

In diesem Artikel2 Abschnitte

Die API ermöglicht es Ihrem eigenen Softwareprogramm – beispielsweise einem Fallverwaltungssystem –, mit Ihrem Hub zu kommunizieren, ohne dass jemand die Bildschirme benutzt. Die API wird mit einer API-SchlüsselSchlüssel Ein geheimer Token, der im Rahmen der Integration erstellt wird und es Ihrer eigenen Software ermöglicht, die API des Hubs zu nutzen. bezeichnet. Es gibt zwei Arten von API-Schlüsseln: einen Schlüssel für die Arbeit im Admin-Panel – beispielsweise bei der Verwaltung von Fällen und Personen – und einen Schlüssel für die Arbeit innerhalb der Fälle.

So funktioniert es

Zwei Schlüssel, zwei APIs. Jeder Schlüssel verwendet seine eigene Adresse. Darauf folgt die ID Ihres Zentrums. Diese Adressen werden von dem anderen Teil abgelehnt.

SchlüsselAdresseWas es erreicht
Verwalten der wichtigen Elementehttps://prd-api-manage.caseactive.com/v1/<hub id>/Es geht um Fälle, die Personen betreffen, deren Zugang zu den Daten, ihre Rollen, die verschiedenen Phasen des Prozesses, sowie die Rechnungen, die man sich ansehen kann. Die Importvorgänge sind noch nicht abgeschlossen. https://prd-api-manage.caseactive.com/v1/integration/<hub id>/
Hub-Tastehttps://prd-api-app.caseactive.com/v1/<hub id>/Alles, was sich in jedem Fall befindet: Beiträge und Kommentare, Dateien, Formulare, elektronische Signaturn, Aufgaben, Rechnungen, Ereignisse, Notizen sowie die Details des Falls.

Was für eine Funktion die „Manage Key“ denn haben kann… Nur diese. Alle anderen Anrufe im API-Panel des Administrationspanels ergeben eine Antwort mit der Codezeile 403. BotNotAllowedException.

Jede Taste ist in Wirklichkeit Ihr virtueller Assistent. Hier sind einige wichtige Hinweise bezüglich Ihres Zentrums: Virtuelle Assistentin/Virtueller AssistentVirtueller Assistent Ein automatisiertes Teammitglied, das Begrüßungsnachrichten, Check-ins und Statusmeldungen für das Unternehmen veröffentlicht; seine Beiträge sind mit einem Virtual Assistant-Abzeichen versehen.. Was es postet, wird unter dem Namen und der Marke der virtuellen Assistentin angezeigt. Die Änderungen werden ebenfalls als „von der virtuellen Assistentin vorgenommen“ vermerkt. Die virtuelle Assistentin ist in jedem Fall vorhanden – somit erreicht eine Hub-Schlüssel alle Fälle im Hub. Sie kann alles tun, was die Rolle der virtuellen Assistentin erlaubt. Standardmäßig kann das Personal nur bestimmte Aufgaben durchführen. Ein geschlossener Fall ist für die virtuelle Assistentin nur in leseberechtigter Form zugänglich. Ein Hub-Schlüssel kann keine Fälle erstellen, Personen hinzufügen oder entfernen, Rechnungen bezahlen oder Anfragen beantworten.

Schlüssel verfallen nicht. Es handelt sich dabei um wichtige Daten, die bis zum Zeitpunkt des Ausschalts oder Löschens durch den Administrator aufbewahrt werden müssen. Beschränken Sie die Anzahl dieser Daten auf die öffentliche IPv4-Adresse Ihres Systems. Weitere Informationen finden Sie hier. Eine API-Schlüsselstellung zu beschränken oder zu widerrufen.

Die technischen Seiten. Jede API gibt eine vollständige technische Liste ihrer Anfragen aus – ohne dass dazu ein Account erstellt werden muss.

Schlüssel verwaltenHub-Schlüssel
Interaktiv (Swagger UI)https://prd-api-manage.caseactive.com/https://prd-api-app.caseactive.com/
Referenz (ReDoc)https://prd-api-manage.caseactive.com/redochttps://prd-api-app.caseactive.com/redoc
OpenAPI-Dokumentationhttps://prd-api-manage.caseactive.com/openapi.jsonhttps://prd-api-app.caseactive.com/openapi.json

Die Apps listen alle Anrufe auf, die sie selbst durchführen – darunter auch viele Anrufe, die mit der „Manage Key“-Funktion nicht abgewickelt werden können. Die Liste zeigt außerdem an, welche Funktionen mit der „Manage Key“-Funktion genutzt werden können. Um einen Anruf auf der interaktiven Seite auszuführen, wählen Sie Authorize aus und fügen anschließend Ihre Schlüsselwerte ein.

Ein abgeschlossenes Hubgerät. Während das Administrationspanel Ihres Servers nach einem fehlgeschlagenen Zahlungsvorgang gesperrt ist, wird der Zugriff auf die Managementfunktionen abgelehnt – mit dem Fehlercode 403. ManageBillingInactiveException. Ein Hub-Key funktioniert weiterhin, solange der Portalzugriff nur noch als Lesebereich möglich ist: 14 Tage nach dem fehlgeschlagenen Zahlungsversuch, wenn die Zahlung immer noch nicht bezahlt wurde – oder der Tag, an dem die abgebrochene Abonnementverbindung endet. Ab diesem Zeitpunkt kann der Hub-Key zwar weiterhin Daten lesen, aber jede Änderung wird abgelehnt, daher wird eine Fehlermeldung mit dem Code 403 ausgegeben. BillingReadOnlyException, Bis der Administrator die Abonnementfunktion erneut startet.

Wann man es verwendet

Verwenden Sie einen „Manage-Key“, um Ihr System in Einklang mit einem anderen System zu halten: Erstellen Sie Fälle, fügen Sie Kunden hinzu und legen Sie diese Kunden in die entsprechenden Fälle ein. Nehmen Sie außerdem den Zugang zu bestimmten Personen weg, wenn sie das System verlassen, oder laden Sie mehrere Datenzeilen auf einmal aus einem Datei-Format herunter. Nutzen Sie außerdem einen „Hub-Key“, um innerhalb der Fälle mit Ihrem eigenen Softwareprogramm zu arbeiten – beispielsweise um eine Notiz zu erstellen, wenn sich etwas in Ihrem System ändert.

Um über die Veränderungen in Ihrem Hub zu erfahren, sobald diese stattfinden – anstatt sie einzeln zu erwarten – sollten Sie einen Webhook verwenden. Weitere Informationen dazu finden Sie unter Webhook einrichten. Um eine Schlüsselwörter zu erstellen, siehe API-Schlüssel erstellen.

Verwandte Artikel

Erstellen Sie einen API-SchlüsselErstellen Sie einen Verwaltungsschlüssel für die API des Admin-Panels oder einen Hub-Schlüssel für die API des Portals, beschränken Sie ihn auf Ihre IP-Adressen und kopieren Sie ihn einmal.Integrationen · 5 minAuthentifizieren Sie API-Anfragen mit einem SchlüsselSenden Sie Ihren Schlüssel als Bearer-Token an die API des Admin-Panels für einen Verwaltungsschlüssel oder an die API des Portals für einen Hub-Schlüssel und beschränken Sie ihn auf Ihre IP-Adressen.IntegrationenRichten Sie einen Webhook für die Feed-Aktivität ein.Sende deinem eigenen System eine Nachricht, sobald ein Feed-Beitrag, ein Kommentar oder ein Anhang hinzugefügt, geändert oder gelöscht wird.Integrationen · 10 minAPI-Fehler und Statuscodes behandelnLesen Sie den Fehlertext, was 400, 401, 403, 404, 500 und 503 bedeuten und warum ein Element, dessen Schlüssel nicht angezeigt werden kann, 404.Integrationen