API-Aufruf im Gespräch
Mit dem Tool CRM System ruft dein Agent während des Anrufs dein System auf, um Daten einzutragen oder abzufragen, etwa einen Lead oder einen Bestellstatus.
Mit dem Tool CRM System verbindet sich dein Agent während des Gesprächs mit deinem System. Er fragt die Angaben ab, die du festlegst, und schickt sie per HTTP an deine URL, zum Beispiel um einen Lead anzulegen, ein Ticket zu eröffnen oder einen Bestellstatus abzufragen. Antwortet dein System mit Daten, kann der Agent sie dem Anrufer nennen.
Wann dieses Tool, wann ein anderes
| Ziel | Werkzeug |
|---|---|
| Daten während des Gesprächs eintragen oder abfragen | CRM System im Reiter Tools |
| Kontext beim Klingeln laden | Incoming Webhook |
| Gesprächsdaten nach dem Anruf übergeben | CRM Ticket unter Automation, siehe n8n |
Tool anlegen
Der Assistent führt dich in vier Schritten durch die Einrichtung.
- Vorlage: Öffne Tools › Hinzufügen › CRM System. Wähle eine Branche, etwa Handwerk, Immobilien oder Versicherung, oder starte leer.
- Dynamische Parameter: Lege fest, welche Daten der Agent im Gespräch erfragt. Mit AI-Agent beschreibst du deinen Fall in einem Satz und lässt die Parameter vorschlagen.
- Endpoint konfigurieren: Trag Tool-Name, Wartetext, Beschreibung für die KI und die URL ein. Unter Erweiterte Einstellungen stellst du Timeout und Headers ein.
- Prompt-Vorlage kopieren: bhomy erzeugt einen Abschnitt für deinen Prompt. Kopiere ihn mit Prompt kopieren und füge ihn im Reiter Persönlichkeit in den Prompt ein.
Parameter
Für jeden Parameter legst du fest:
| Angabe | Bedeutung |
|---|---|
| Name | Feldname im gesendeten JSON, etwa vorname |
| Typ | Text, Zahl, E-Mail, Telefon, Datum, Ja/Nein oder Auswahl mit Komma-getrennten Optionen |
| Pflicht | Der Agent ruft das Tool erst auf, wenn alle Pflichtangaben vorliegen |
| Frage | Wie der Agent danach fragt, etwa „Wie ist Ihr vollständiger Name?“ |
| Beschreibung | Was in das Feld gehört |
Endpoint
| Feld | Bedeutung |
|---|---|
| Tool-Name | Name, unter dem der Agent das Tool kennt, etwa „Lead anlegen“ |
| Wartetext | Satz, den der Agent während des Aufrufs spricht, etwa „Ich trage Ihre Daten ein.“ |
| Beschreibung (für KI) | Wann der Agent das Tool aufruft, etwa „Legt einen neuen Lead an. Nur aufrufen, wenn alle Pflichtfelder erfasst sind.“ |
| Webhook Endpoint | Methode POST oder GET und die URL deines Systems |
| Fire-and-Forget | an: nur senden, die Antwort wird nicht ausgewertet. aus: der Agent bekommt die Antwort und kann sie nutzen |
| Timeout (ms) | wie lange der Agent auf die Antwort wartet |
| Headers | etwa Authorization: Bearer … oder X-Api-Key |
Die Request Body Preview zeigt, was gesendet wird. Bei POST gehen die Parameter als JSON im Body, bei GET als Query-Parameter.
{
"vorname": "Anna",
"nachname": "Berger",
"telefon": "+491701234567",
"anliegen": "Angebot für eine Wärmepumpe"
}
Die Antwort deines Systems
Mit ausgeschaltetem Fire-and-Forget gibt bhomy die Antwort deines Systems an den Agenten weiter. Antworte mit einem JSON-Objekt, das sich vorlesen lässt:
{ "status": "versendet", "lieferdatum": "Donnerstag", "paketdienst": "DHL" }
Der Agent formuliert daraus eine Antwort, etwa „Ihre Bestellung ist versendet und kommt am Donnerstag mit DHL.“ Antwortet dein System mit einem Fehler oder zu spät, sagt der Agent dem Anrufer, dass es gerade nicht geklappt hat, und bietet einen anderen Weg an. Statuscodes oder Fehlertexte nennt er nicht.
Sicherheit und Tempo
| Punkt | Empfehlung |
|---|---|
| Anmeldung | Prüfe einen geheimen Header. Feste IP-Adressen gibt es nicht |
| Tempo | Antworte innerhalb weniger Sekunden. Der Anrufer wartet, während dein System arbeitet |
| Daten | Gib nur zurück, was der Agent sagen darf. Alles in der Antwort kann er dem Anrufer nennen |
Was der Agent gesendet und zurückbekommen hat, steht im Anrufverlauf unter Main Logs.
War diese Seite hilfreich?