> ## Documentation Index
> Fetch the complete documentation index at: https://help.cloudtalk.io/llms.txt
> Use this file to discover all available pages before exploring further.
# VoiceAgent-Fähigkeiten
> Erfahren Sie, wie VoiceAgent-Fähigkeiten festlegen, was Ihr Agent während Anrufen tun kann, und wie Sie sie für Ihren Anwendungsfall konfigurieren.
Fähigkeiten sind die Bausteine, die festlegen, was ein VoiceAgent während eines Anrufs tun kann. Sie steuern, wie der Agent Aufgaben erledigt – etwa das Erfassen von Informationen, das Beantworten von Fragen, das Weiterleiten von Anrufen oder das Auslösen von Folgeaktionen.
In diesem Artikel erfahren Sie, was VoiceAgent-Fähigkeiten sind, wie sie funktionieren, welche Fähigkeiten verfügbar sind und wie Sie sie an Ihren konkreten Anwendungsfall anpassen.
**Benutzerebene:** Admin
***
VoiceAgent-Fähigkeiten verstehen
VoiceAgent-Fähigkeiten legen fest, was ein VoiceAgent während eines Anrufs tun kann. Sie steuern, wie der Agent bestimmte Aufgaben erledigt, welche Informationen er erfasst, wie er auf Anrufer reagiert und wann er einen menschlichen Agenten oder ein anderes System einbeziehen soll.
CloudTalk bietet **vordefinierte Fähigkeiten**, die die häufigsten VoiceAgent-Aktionen abdecken:
* **Nachricht aufnehmen** - ermöglicht es dem VoiceAgent, die Nachricht eines Anrufers entgegenzunehmen und die für die Nachverfolgung nötigen Details zu erfassen
* **Informationen extrahieren** - ermöglicht es dem VoiceAgent, strukturierte Informationen aus dem Gespräch zu erfassen und für Auswertungen, Anrufprotokolle oder die externe Nutzung zu speichern
* **Fragen beantworten** – ermöglicht es dem VoiceAgent, Fragen von Anrufern auf Grundlage der konfigurierten Wissensdatenbank zu beantworten
* **An Mitarbeiter weiterleiten** – ermöglicht es dem VoiceAgent, den Anruf an einen verfügbaren Agenten, eine Gruppe oder einen Anrufablauf weiterzuleiten, wenn bestimmte Bedingungen erfüllt sind
Zusätzlich zu diesen vordefinierten Fähigkeiten können Sie auch **benutzerdefinierte Fähigkeiten** erstellen, um spezifischere oder anspruchsvollere Anwendungsfälle abzudecken. Mit benutzerdefinierten Fähigkeiten legen Sie Verhalten über den Standardumfang hinaus fest und passen den VoiceAgent an Ihre geschäftlichen Anforderungen an.
Nachricht aufnehmen
Die Fähigkeit **Nachricht aufnehmen** teilt dem VoiceAgent mit, dass er während des Gesprächs eine Nachricht des Anrufers entgegennehmen kann.
Wenn diese Fähigkeit aktiviert ist, kann der VoiceAgent die Nachricht eines Anrufers erfassen und als Teil der Anrufdaten weitergeben. Die extrahierte Ausgabe enthält dadurch automatisch die entsprechenden Nachrichtenfelder, zum Beispiel:
* **caller\_name**
* **message\_from\_caller**
In der Konfiguration der Fähigkeit **Nachricht aufnehmen** legen Sie fest, was der VoiceAgent sagen soll, nachdem die Nachricht aufgenommen wurde.
⚠️ Für sich allein sorgt diese Fähigkeit **nicht** automatisch dafür, dass der VoiceAgent in jedem Gespräch anbietet, eine Nachricht aufzunehmen. Der VoiceAgent nutzt sie in der Regel dann, wenn er das Gespräch nicht weiterführen kann, zum Beispiel wenn eine Weiterleitung nicht möglich ist oder sich das Anliegen des Anrufers nicht direkt lösen lässt.
Wenn der VoiceAgent Anrufer ausdrücklich darauf hinweisen soll, dass sie eine Nachricht hinterlassen können, ergänzen Sie diese Anweisung in den **[Szenarien](/de/articles/14073408-voiceagent-scenarios-guardrails)** des Agenten.
*Beispiel:*
Wenn Sie diese Fähigkeit mit einem klaren Szenario kombinieren, wissen Anrufer zuverlässig, dass sie eine Nachricht hinterlassen können.
Informationen extrahieren
Die Fähigkeit **Informationen extrahieren** legt fest, welche Daten aus dem Anruf erfasst und nach dem Gesprächsende gespeichert werden. Diese Daten werden in den **Anrufdetails** angezeigt, nach einer Weiterleitung an Agenten übergeben und an externe Systeme gesendet.
In dieser Fähigkeit definieren Sie eine Reihe von **Eigenschaften**, die die KI aus dem Gespräch extrahieren soll. Für jede Eigenschaft konfigurieren Sie:
* **Eigenschaftsname** - die Bezeichnung für den extrahierten Wert
* **Typ** - das Format, in dem der Wert gespeichert werden soll *(Text/ Zahl/Ja oder Nein/ Liste)*
* **Anweisung für die KI** - Hinweis für die KI, welcher Wert erfasst werden soll
Nach der Konfiguration erscheinen die extrahierten Eigenschaften automatisch in den **Anrufdetails** im CloudTalk Dashboard und werden zusätzlich über **native Integrationen** exportiert.
***Wie funktioniert die Informationsextraktion?***
Sobald ein Anruf mit dem VoiceAgent endet, verarbeitet die KI das vollständige Anruftranskript anhand der Anweisungen, die in der Fähigkeit ***Informationen extrahieren*** konfiguriert sind. Die KI gibt anschließend ein **JSON-Objekt** zurück, das genau die Felder enthält, die in der Konfiguration der Fähigkeit definiert sind.
Bei vorlagenbasierten VoiceAgents (etwa dem KI-Rezeptionisten) können je nach gewähltem Anwendungsfall automatisch weitere Felder hinzukommen.
Bei **ausgehenden Anrufen** enthält das exportierte Objekt zusätzlich die Werte, die in den [Ausgabevariablen](/de/articles/11401649-voiceagents-for-outbound-calls#h_535fa347ba) der Trigger-API-Anfrage übergeben wurden.
Per Webhook senden
In der Konfiguration der Fähigkeit ***Informationen extrahieren*** können Sie die Einstellung *Per Webhook senden* aktivieren. Ist sie aktiviert, sendet das System die extrahierten Daten zusätzlich zum Standard-Datenexport über native Integrationen an einen externen Endpunkt Ihrer Wahl. Dieser Endpunkt ist die Verbindungsstelle zwischen Ihrem VoiceAgent und den Workflows, Integrationen oder internen Systemen, die Sie nutzen möchten.
Aufbau des Webhook-Payloads
Das Payload wird als JSON-Objekt unter dem Schlüssel `data` auf oberster Ebene gesendet. Es enthält immer:
* **`ct_call_context`** — Anruf-Metadaten, die CloudTalk automatisch hinzufügt (siehe unten)
* **Ihre extrahierten Eigenschaften** — die Felder, die Sie in der Fähigkeit Informationen extrahieren konfiguriert haben
* **`message_left_by_caller`** — Nachrichteninhalt, sofern die Fähigkeit Nachricht aufnehmen aktiv ist
* **Ausgabevariablen** — alle Werte, die über `output.variables` in der Trigger-API-Anfrage übergeben werden (nur bei ausgehenden Anrufen)
Das Objekt ct\_call\_context
Jedes Webhook-Payload enthält ein `ct_call_context`-Objekt mit Metadaten auf Anrufebene. Damit ordnen Sie VoiceAgent-Ergebnisse den Anrufdatensätzen in CloudTalk zu oder gleichen Anrufe in Ihrem CRM oder Data Warehouse ab.
| **Feld** | **Typ** | **Beschreibung** |
| - | - | - |
| `uuid` | string | Eindeutige Kennung des Anrufs. Damit finden Sie den Anruf in CloudTalk wieder oder verknüpfen ihn mit Datensätzen in externen Systemen. |
| `status` | string | Anrufergebnis: `Connected` oder `Not Connected`. |
| `datetime` | string (RFC3339 UTC) | Startzeit des Anrufs. Beispiel: `2026-06-17T08:38:31Z` |
| `duration` | integer | Dauer des Anrufs in Sekunden. |
| `caller_number` | string | Die Telefonnummer des Anrufers im E.164-Format. |
| `contact` | object (optional) | Nur bei **eingehenden Anrufen** vorhanden, bei denen die Telefonnummer des Anrufers einem Kontakt in CloudTalk zugeordnet werden konnte. Enthält `id` (integer), `name` (string) und `emails` (Array aus Strings). |
Beispiel-Payload
```json theme={"system"}
{
"data": {
"ct_call_context": {
"uuid": "160f677d-d2f2-419d-822d-b45f33e4fe6c",
"status": "Connected",
"datetime": "2026-06-17T08:38:31Z",
"duration": 23,
"caller_number": "+421903123123",
"contact": {
"id": 1633025875,
"name": "Jane Smith",
"emails": [
"jane.smith@example.com"
]
}
},
"message_left_by_caller": {
"caller_name": null,
"content": null
},
"Summary": "The caller confirmed they want a callback tomorrow morning.",
"Callback_Confirmed": true
}
}
```
In diesem Beispiel sind `Summary` und `Callback_Confirmed` benutzerdefinierte Eigenschaften, die in der Konfiguration der Fähigkeit Informationen extrahieren festgelegt wurden. Das Objekt `contact` ist vorhanden, weil die Telefonnummer des Anrufers einem bestehenden Kontakt in CloudTalk zugeordnet werden konnte. Wird keine Übereinstimmung gefunden, fehlt das Feld `contact` im Payload.
Fragen beantworten
Die Fähigkeit **Fragen beantworten** weist den VoiceAgent an, Kundenfragen anhand der Informationen zu beantworten, die in der **[Wissensdatenbank](/de/articles/11204159-knowledge-base-for-voiceagents)** des VoiceAgents verfügbar sind.
Wenn diese Fähigkeit aktiviert ist, nutzt die KI die konfigurierten Wissensquellen, um während des Anrufs passende Antworten zu geben. Das ist nützlich, um häufige Anfragen ohne einen verfügbaren Agenten zu beantworten.
In der Konfiguration der Fähigkeit legen Sie fest, was der VoiceAgent tun soll, wenn er **nicht** genügend Informationen hat, um die Frage des Kunden zu beantworten. Zur Auswahl stehen:
* **Ehrlich sein** - der VoiceAgent sagt klar, dass er die Information nicht hat
* **Zu anderen Themen leiten** - der VoiceAgent lenkt das Gespräch auf ein anderes relevantes Thema
* **An eine Person übergeben** - der VoiceAgent leitet den Anruf sicher an einen verfügbaren Agenten oder eine Gruppe weiter. Kann die Weiterleitung nicht abgeschlossen werden (z. B. weil niemand abnimmt), bleibt der Anrufer beim VoiceAgent, der Alternativen anbieten kann.
Wenn Sie **An eine Person übergeben** auswählen, müssen Sie festlegen, an welchen **Agenten** oder welche **Gruppe** der Anruf weitergeleitet werden soll. In den meisten Fällen ist das eine allgemeine **Support-Gruppe** oder ein anderes Team, das für unbeantwortete Fragen zuständig ist.
An Mitarbeiter weiterleiten
Mit der Fähigkeit **An Mitarbeiter weiterleiten** kann Ihr VoiceAgent ein Gespräch übergeben, sobald er ein bestimmtes Ziel erreicht hat oder das Anliegen eines Anrufers menschliches Eingreifen erfordert.
Alle Weiterleitungen an Agenten und Gruppen sind **sichere Weiterleitungen**: Der VoiceAgent hält den Anrufer in der Leitung, während er das Weiterleitungsziel kontaktiert, und schließt die Übergabe erst ab, wenn die Verbindung zustande kommt. Schlägt die Weiterleitung fehl, bleibt der Anrufer beim VoiceAgent und der Anruf wird nie getrennt.
Je nach Arbeitsablauf stehen Ihnen drei Hauptmethoden zur Verfügung:
* **Weiterleitung an einen Agenten:** Leitet den Anrufer direkt an ein bestimmtes Teammitglied weiter. Der VoiceAgent verbindet den Anrufer erst, wenn der Agent abnimmt. Ist der Agent offline oder nimmt er nicht ab, bleibt der Anrufer beim VoiceAgent, der eine Nachricht aufnehmen oder ein anderes Team versuchen kann.
* **Weiterleitung an eine Gruppe:** Sendet den Anruf in die Warteschlange einer bestimmten Abteilung. Kann die Warteschlange den Anruf annehmen, wird der Anrufer übergeben und wartet gemäß Ihren üblichen Klingelstrategien für Gruppen (während der Wartezeit werden keine VoiceAgent-Minuten verbraucht). Ist die Warteschlange voll oder nicht verfügbar, bleibt der Anrufer beim VoiceAgent.
* **Weiterleitung an einen Anrufablauf:** (nur bei eingehenden Anrufen) Beendet die VoiceAgent-Sitzung und leitet den Anruf über den Zweig „Angenommen“ Ihres Anrufablaufs weiter. Nutzen Sie das für fortgeschrittene Szenarien, die sichere Weiterleitungen nicht abdecken: Weiterleitungen an externe Nummern, komplexes Routing über mehrere Zweige, CSAT-Umfragen nach dem Anruf oder IVR-Weiterleitungen.
Benutzerdefinierte Fähigkeit
Mit einer **benutzerdefinierten Fähigkeit** legen Sie zusätzliches Verhalten für Ihren VoiceAgent fest, das über die vordefinierten Fähigkeiten hinausgeht. Um eine benutzerdefinierte Fähigkeit hinzuzufügen, wählen Sie **Benutzerdefiniert** aus der Liste der verfügbaren Fähigkeiten aus und klicken Sie auf **Hinzufügen**. Anschließend geben Sie Folgendes an:
* **Kompetenzname** - der Name, unter dem die Fähigkeit in der Liste der angewendeten Fähigkeiten erscheint
* **Prompt der Fähigkeit** - die Anweisung, die der KI sagt, was bei Verwendung dieser Fähigkeit zu tun ist
Der **Prompt der Fähigkeit** sollte klar beschreiben:
* wann die Fähigkeit angewendet werden soll
* was das Ziel der Fähigkeit ist
* wie sich der VoiceAgent dabei verhalten soll
Sie können beliebig viele benutzerdefinierte Fähigkeiten hinzufügen. Diese Fähigkeiten werden während des Anrufs als Teil des VoiceAgent-Verhaltens angewendet.
💡 **Profi-Tipp:** Im Prompt der Fähigkeit können Sie auch dynamische Variablen verwenden, etwa [system\_prompt-Variablen](/de/articles/11401649-voiceagents-for-outbound-calls#h_efc564879a) aus dem Trigger für ausgehende Anrufe oder [Kontaktkontext-Variablen](/de/articles/11399385-voiceagents-for-inbound-calls#h_2e8100737f), die für eingehende Anrufe verfügbar sind.
***
*Brauchen Sie Hilfe oder haben Sie eine Frage?* Melden Sie sich einfach über unser [Support-Portal](https://support.cloudtalk.io/hc/en-us/requests/new?ticket_form_id=26305535257884) — wir sind für Sie da.
## Related topics
- [VoiceAgent-Vorlagen: KI-Rezeptionist außerhalb der Geschäftszeiten](/de/articles/15653481-voiceagent-templates-after-hours-ai-receptionist.md)
- [VoiceAgent-Vorlagen: KI-Empfang während der Geschäftszeiten](/de/articles/15645612-voiceagent-templates-during-hours-ai-receptionist.md)
- [Erste Schritte mit VoiceAgents](/de/articles/11053795-getting-started-with-voiceagents.md)
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.