--- title: "Virtual Front Desk API: Überblick und erste Schritte" url: "https://help.virtualfrontdesk.com/de/article/virtual-front-desk-api-ueberblick-und-erste-schritte" language: "de" last_updated: "2026-10-14T14:31:31.562Z" --- # Virtual Front Desk API: Überblick und erste Schritte ## Was ist die Virtual Front Desk API? Mit der Virtual Front Desk API verbinden Sie Virtual Front Desk mit der anderen Software, die Ihre Organisation bereits verwendet. Statt Informationen von Hand von einem System in ein anderes zu übertragen, können Ihre Systeme automatisch Informationen mit Virtual Front Desk austauschen. Die API ist für IT-Administratoren, Entwickler und Integrationspartner gedacht, aber Sie müssen kein Entwickler sein, um zu verstehen, was sie für Sie tun kann. Dieser Artikel gibt einen allgemeinen Überblick über die Möglichkeiten und erklärt, wie Sie beginnen. Die API ist in den Tarifen **Professional** und **Enterprise** verfügbar. ## So funktioniert es Es gibt drei Möglichkeiten, sich mit Virtual Front Desk zu verbinden: - **Die API:** Ihr System fragt Informationen bei Virtual Front Desk ab, etwa Ihre Besucheranmeldungen oder Ihren Anrufverlauf, und erhält sie sofort. - **Webhooks:** Virtual Front Desk benachrichtigt Ihr System automatisch, sobald etwas passiert, zum Beispiel wenn sich ein Besucher anmeldet oder ein Anruf unbeantwortet bleibt. - **KI-Assistenten:** Sie verbinden einen KI-Assistenten mit Ihren Virtual Front Desk-Daten und stellen Fragen in natürlicher Sprache, ohne Code zu schreiben. ## Was Sie damit tun können Jede Organisation ist anders, daher hängt die beste Integration von Ihren Anforderungen und den Systemen ab, die Sie bereits verwenden. Hier einige allgemeine Ideen: - **Ihre anderen Systeme auf dem Laufenden halten:** Teilen Sie Ihrer eigenen Software mit, wann Besucher ankommen oder gehen, damit die richtigen Personen und Systeme immer auf dem neuesten Stand sind. - **Ihre Daten in Ihre eigenen Tools übernehmen:** Nutzen Sie Ihre Besucher- und Anrufinformationen in den Reporting- oder Business-Intelligence-Tools, die Sie bereits verwenden. - **Problemen zuvorkommen:** Lassen Sie sich benachrichtigen, wenn eine Station offline geht oder Anrufe verpasst werden. - **Fragen zu Ihrer Aktivität stellen:** Verwenden Sie einen KI-Assistenten, um schnelle Antworten zu Ihren Besuchern, Anrufen und Stationen zu erhalten. Wir empfehlen, Ihr Projekt mit Ihrer IT-Abteilung oder Ihrem Integrationspartner zu besprechen. Unser Support kann Ihnen auch helfen einzuschätzen, was für Ihre Organisation möglich ist. ## Bevor Sie beginnen - Ihre Organisation muss den Tarif **Professional** oder **Enterprise** nutzen. - Nur Benutzer mit der Rolle **Inhaber** (Owner), **Administrator** (Admin) oder **Manager** können im Virtual Front Desk-Dashboard auf die API-Einstellungen zugreifen. ## Die API-Seite öffnen Klicken Sie auf das Symbol **Einstellungen** (Settings) (das Zahnrad) neben Ihrem Namen und wählen Sie dann unter **Organisation** (Organization) den Eintrag **API**. Die Seite ist in fünf Abschnitte unterteilt, die unten erklärt werden. ![Die API-Seite unter Einstellungen > Organisation](https://cdn-assets.productfruits.com/ba2a202a-465d-4f32-a043-bc46026da3cd) *Die API-Seite unter Einstellungen > Organisation* ## 1\. API Dieser Abschnitt zeigt die **Basis-URL** (Base URL), die Adresse, über die sich Ihre Systeme mit Virtual Front Desk verbinden. Klicken Sie auf **Kopieren** (Copy), um sie zu kopieren. Die Schaltfläche **API-Referenz** (API reference) öffnet die vollständige technische Dokumentation, die Ihr Entwickler oder Integrationspartner zum Erstellen der Integration verwendet. ## 2\. API-Schlüssel Ein API-Schlüssel ist die Zugangsberechtigung, mit der sich Ihr System bei Virtual Front Desk anmeldet. Jeder Schlüssel hat eigene Berechtigungen, sogenannte **Scopes**, sodass jede Integration nur auf das zugreifen kann, was sie benötigt. Für jeden Schlüssel zeigt die Liste den Namen, den Anfang des Schlüssels, seine Scopes sowie den Zeitpunkt der letzten Verwendung und der Erstellung. Zwei Schaltflächen stehen zur Verfügung: - **Secret ersetzen** (Replace secret): Gibt dem Schlüssel ein neues Secret, zum Beispiel wenn Sie vermuten, dass er offengelegt wurde. Das alte Secret funktioniert sofort nicht mehr, aktualisieren Sie Ihre Integration also umgehend. Der Schlüssel behält seinen Namen, seine Scopes und seinen Nutzungsverlauf. - **Widerrufen** (Revoke): Deaktiviert den Schlüssel dauerhaft. Jede Integration, die ihn verwendet, funktioniert sofort nicht mehr. Widerrufene und abgelaufene Schlüssel werden unten in der Liste unter **Inaktive Schlüssel** (Inactive keys) angezeigt. **So erstellen Sie einen Schlüssel:** 1. Klicken Sie auf **Schlüssel erstellen** (Create key). 2. Geben Sie einen **Schlüsselnamen** (Key name) ein, der die Integration beschreibt. 3. Wählen Sie die **Scopes**. Sie können **Vollzugriff** (Full access), **Nur Lesen** (Read only) oder **Nur Schreiben** (Write only) auswählen oder für jeden Bereich einzelne Berechtigungen festlegen. Gewähren Sie nur, was die Integration benötigt. 4. Legen Sie optional ein **Ablaufdatum** (Expiry date) fest. Der Schlüssel funktioniert ab dem Ende dieses Tages nicht mehr. Lassen Sie das Feld leer, läuft der Schlüssel nie ab. 5. Klicken Sie auf **Schlüssel erstellen**, kopieren Sie dann den Schlüssel und bewahren Sie ihn an einem sicheren Ort auf. ![Einen API-Schlüssel erstellen](https://cdn-assets.productfruits.com/176fa09d-1e3e-48ba-ac49-e2b5420dbef9) *Einen API-Schlüssel erstellen* Der vollständige Schlüssel wird nur einmal angezeigt. Wenn er verloren geht, erstellen Sie einen neuen Schlüssel und widerrufen Sie den alten. ## 3\. KI-Assistenten (MCP) In diesem Abschnitt verbinden Sie einen KI-Assistenten wie Claude Code, Cursor oder VS Code mit Ihren Virtual Front Desk-Daten, damit Sie Fragen in natürlicher Sprache stellen können. - **Nur Lesen** (Read-only): die Adresse, die Sie verwenden, wenn der Assistent Ihre Informationen nur lesen soll. Dies ist die empfohlene Option. - **Mit Schreibzugriff** (With writes): die Adresse, die Sie verwenden, wenn der Assistent auch Änderungen vornehmen können soll, sofern sein API-Schlüssel die entsprechenden Berechtigungen hat. - Die Registerkarten darunter zeigen für jedes KI-Tool einen Einrichtungsbefehl zum Kopieren. Ersetzen Sie das Ende des Befehls durch einen API-Schlüssel, den Sie im vorherigen Abschnitt erstellt haben. ![Der Abschnitt KI-Assistenten (MCP)](https://cdn-assets.productfruits.com/1f2c699d-5406-4c83-8526-4f989b6f334a) *Der Abschnitt KI-Assistenten (MCP)* Informationen, die der Assistent liest, einschließlich Besucherdaten, werden an Ihren KI-Anbieter gesendet. Wir empfehlen, für Ihren Assistenten einen eigenen Schlüssel mit Ablaufdatum zu erstellen. ## 4\. Webhooks Mit Webhooks benachrichtigt Virtual Front Desk Ihre Systeme automatisch, wenn etwas passiert. Klicken Sie auf **Endpunkt hinzufügen** (Add endpoint), um die Adresse des Systems einzugeben, das die Benachrichtigungen empfangen soll. Jede Benachrichtigung ist signiert, sodass Ihr System prüfen kann, ob sie wirklich von Virtual Front Desk stammt. ## 5\. Nutzung Für jeden der letzten 14 Tage zeigt dieser Abschnitt die Anzahl der API-Anfragen, die mit all Ihren Schlüsseln gestellt wurden, und die Anzahl der Fehler, aufgeschlüsselt nach Endpunkt. Er wird einmal täglich mit den Summen des Vortags aktualisiert. ![Die Abschnitte Webhooks und Nutzung](https://cdn-assets.productfruits.com/38e3257f-714b-45ce-bfb4-731826bb0591) *Die Abschnitte Webhooks und Nutzung* ## Ihre Integration absichern - Erstellen Sie für jede Integration einen eigenen Schlüssel, damit Sie einen widerrufen können, ohne die anderen zu beeinträchtigen. - Geben Sie jedem Schlüssel nur die Berechtigungen, die er benötigt. - Bewahren Sie Ihre Schlüssel an einem sicheren Ort auf und teilen Sie sie niemals per E-Mail oder Chat. - Wenn ein Schlüssel offengelegt worden sein könnte, klicken Sie sofort unter **Einstellungen > Organisation > API** auf **Secret ersetzen** oder **Widerrufen**. ## Weitere Informationen Die vollständige technische Dokumentation finden Sie in der [**Virtual Front Desk API-Referenz**](https://api.virtualfrontdesk.com/v1/docs) (auf Englisch). Sie können sie auch über die Schaltfläche **API-Referenz** unter **Einstellungen > Organisation > API** öffnen. Benötigen Sie Hilfe bei der Planung einer Integration? Kontaktieren Sie unseren Support, wir helfen Ihnen gerne.