Der CRM-zu-Sprach-KI-Workflow – verständlich erklärt, ohne Fachjargon

Die Anbindung eines CRM an einen KI-Sprachagenten lässt sich auf vier Übergaben reduzieren. Das CRM entscheidet, wer angerufen wird. Die Anrufanfrage enthält alles, was der Agent wissen muss. Der Agent führt das Gespräch. Die Ergebnisse landen wieder im selben CRM-Datensatz. Die meiste Verwirrung bei Integrationen entsteht, wenn diese vier Schritte vermischt werden oder unklar ist, welches System für welchen Schritt zuständig ist.

Dieser Leitfaden erklärt den Ablauf am Beispiel eines HubSpot-Workflows und zeigt anschließend denselben Kreislauf für jedes CRM, das einen webhook senden kann.

Was sind die vier Phasen eines CRM-zu-Sprach-KI-Workflows?

Auslöser, Kontext, Gespräch und Rückschreiben:

1. Auslöser. Ein CRM-Ereignis (ein ausgefülltes Formular, ein Wechsel der Deal-Phase, ein erreichtes Datum) startet einen Workflow, der die Sprachplattform auffordert, einen Anruf zu tätigen.
2. Kontext. Die Anrufanfrage enthält Daten aus dem CRM-Datensatz, sodass der Agent den Anruf bereits mit Kenntnis von Name und Situation des Kontakts beginnt.
3. Gespräch. Der Agent spricht und kann dabei CRM-Datensätze lesen oder aktualisieren.
4. Rückschreiben. Nach dem Anruf werden eine Zusammenfassung, strukturierte Ergebnisfelder, das Transkript und die Aufzeichnung dem CRM-Datensatz hinzugefügt, und der CRM-Workflow entscheidet über die nächsten Schritte.

Was löst den KI-Anruf aus dem CRM tatsächlich aus?

Ein CRM-Workflow löst den Anruf auf eine von zwei Arten aus: über eine native Workflow-Aktion oder über einen webhook, den Ihr eigener Dienst in einen API-Aufruf umwandelt.

Native Aktion (HubSpot). Die App der Retell AI im HubSpot Marketplace fügt HubSpot-Workflows die Aktion Make a Phone Call hinzu. Beginnen Sie mit einem Auslöser, den Sie bereits nutzen: einer Formularübermittlung, einem neuen Datensatz, einem Wechsel der Deal-Phase oder einer Datumseigenschaft wie einem Termindatum. Fügen Sie die Bedingung „Phone number is known“ hinzu, damit Kontakte ohne Nummer gar nicht erst aufgenommen werden. Füllen Sie dann drei Felder der Aktion aus: From (der Retell-Agent und die Telefonnummer), To (das Telefon-token des Kontakts) und optional Dynamic Variables als JSON. Der Workflow pausiert, bis der Anruf beendet ist.

Webhook plus API (jedes CRM). Wenn Ihr CRM aus einem Workflow einen webhook senden kann, leiten Sie ihn an einen kleinen eigenen Dienst weiter. Dieser Dienst ruft die Create Phone Call API von Retell mit vier Angaben auf: from_number, to_number, den Kontextfeldern in retell_llm_dynamic_variables und der CRM-Datensatz-ID in metadata. Retell speichert metadata zusammen mit dem Anruf und gibt es bei späteren webhooks im Anrufobjekt zurück – so findet das Ergebnis den Weg zurück zum richtigen Datensatz.

Listen statt Ereignisse. Für eine Kampagne, die sich an ein Segment statt an ein einzelnes Ereignis richtet, exportieren Sie die Liste und führen sie als Batch-Anruf aus: eine CSV-Datei mit einer Spalte für Telefonnummern, wobei jede zusätzliche Spalte zu einer Variable wird, die der Agent nutzen kann.

Für jeden Weg gelten zwei Voraussetzungen. Der anrufenden Nummer muss ein Outbound-Agent zugewiesen sein, und die gewählten Nummern müssen im gültigen E.164-Format vorliegen (zum Beispiel +14155550123).

Woher weiß der Agent, wen er anruft?

Über dynamische Variablen: benannte Werte wie {{first_name}} oder {{deal_stage}}, die Retell befüllt, bevor der Agent spricht. Sie stammen aus drei Quellen:

• Die Anrufanfrage. Alles, was das JSON der HubSpot-Aktion oder Ihr API-Aufruf in retell_llm_dynamic_variables übergibt.
• Synchronisierte Kontaktfelder. Wenn Sie die native CRM-Kontaktsynchronisierung von Retell nutzen, erhält ein Anruf, dessen Nummer mit einem synchronisierten Kontakt übereinstimmt, automatisch die zugeordneten Felder dieses Kontakts als Variablen.
• Eine Abfrage vor dem Anruf. Eine Pre-Call-Funktion auf der Workflow-Seite des Agenten kann das CRM nach der Nummer durchsuchen und Felder aus der Antwort Variablen zuordnen. Bei ausgehenden Anrufen läuft sie, bevor Retell wählt, sodass der Kontakt von der Abfrage nichts mitbekommt.

Kommt derselbe Name aus mehreren Quellen, hat der Wert aus der Anfrage Vorrang vor dem synchronisierten Kontaktfeld, und alles, was der Agent während des Anrufs erfasst, hat Vorrang vor beiden.

Drei Regeln verhindern die meisten Fälle, in denen ein Agent einen Platzhalter laut vorliest:

• Senden Sie jeden Wert als String, also "42" und "true", nicht 42 und true.
• Verflachen Sie Objekte. {{client.name}} wird nicht aufgelöst; senden Sie stattdessen client_name.
• Legen Sie Standardwerte auf Agentenebene fest. Eine Variable ohne Wert bleibt im prompt in ihrer Rohform mit {{braces}} stehen.

Was passiert während des Anrufs?

Der Agent führt das Gespräch auf Basis seines prompts und seiner Variablen und kann während des Anrufs im CRM handeln, wenn Sie ihm Tools zur Verfügung stellen.

Ist HubSpot über die native Integration von Retell angebunden, kann der Agent während des Gesprächs Tools wie Search Contact, List Contact Deals, Update Deal, Update Contact und Create Task nutzen. Er kann eine E-Mail-Adresse korrigieren, die der Kontakt gerade genannt hat, oder die vereinbarte Folgeaufgabe anlegen. Bei einem CRM ohne native Integration erfüllt eine benutzerdefinierte Funktion dieselbe Aufgabe, indem sie während des Anrufs Ihre eigene API aufruft.

Planen Sie zwei Verhaltensweisen ein. Schlägt ein CRM-Tool-Aufruf fehl oder läuft in ein Timeout, wird das Gespräch fortgesetzt – der prompt sollte dem Agenten also sagen, was er sagen soll, wenn eine Abfrage leer zurückkommt. Und wenn ein ausgehender Anruf statt einer Person die Mailbox erreicht, kann der Agent je nach Konfiguration auflegen oder eine Nachricht hinterlassen, und der Anruf wird mit in_voicemail markiert. Diese Markierung ist beim Rückschreiben wichtig.

Wie gelangen die Anrufergebnisse zurück in den CRM-Datensatz?

Nach Ende des Anrufs führt Retell eine Post-Call-Analyse des Transkripts durch (im Produkt heißt sie Post Call Extraction). Die Ergebnisse erreichen das CRM dann über einen von drei Wegen – je nachdem, was Ihr CRM unterstützt und wer für die Zuordnungslogik zuständig sein soll.

Was erzeugt wird. Jeder Anruf erhält call_summary, user_sentiment, call_successful und in_voicemail. Für Ihre eigenen Ergebnisse fügen Sie benutzerdefinierte Felder hinzu, jeweils vom Typ Boolean, Text, Zahl oder Auswahl: qualified, budget_range, callback_requested. Der Anrufdatensatz enthält außerdem das vollständige Transkript und eine Aufzeichnungs-URL. Wie Felder definiert werden, erfahren Sie unter Post-Call-Analyse.

Weg 1: die HubSpot-Marketplace-App. Wenn der Anruf abgeschlossen ist, schreibt die App die Zusammenfassung und die Analyse in die Aktivitätschronik des Kontakts, legt Aufzeichnung und Transkript im Anrufprotokoll ab und zeigt das Protokoll in der Chronik des zugehörigen Unternehmens an. Der pausierte Workflow wird dann fortgesetzt und kann anhand von Ausgaben wie Call Success, User Sentiment oder Call Outcome verzweigen: eine Follow-up-E-Mail bei Erfolg, ein erneuter Versuch oder eine SMS, wenn niemand abnimmt.

Weg 2: native CRM-Integration. Die Integrationen von Retell mit HubSpot, Salesforce, Microsoft Dynamics 365, GoHighLevel und Zoho CRM ordnen Felder der Post-Call-Analyse Kontaktfeldern zu und übertragen sie in den CRM-Datensatz. Jede Zuordnung hat einen Aktualisierungsmodus: Overwrite für Statusfelder, Fill only if empty für stabile Fakten wie die E-Mail-Adresse oder Accumulate & summarize, um Notizen über mehrere Anrufe hinweg zusammenzuführen. Aktivieren Sie Log activities automatically, und jeder Anruf wird zusätzlich beim Kontakt protokolliert, zum Beispiel als Call Engagement in HubSpot oder als Task in Salesforce. Post-Call-Funktionen ergänzen gezielte Schreibvorgänge, etwa ein HubSpot Create Task, das nur ausgeführt wird, wenn ein Feld followup_needed true ist.

Ein Haken bei Weg 2: Er schreibt nur in Kontakte, die über die aktive CRM-Verbindung importiert wurden. Eine Nummer, die keinem synchronisierten Kontakt entspricht, erzeugt keinen Aktivitätseintrag, und Retell aktualisiert bestehende CRM-Datensätze, statt neue anzulegen – es sei denn, Sie aktivieren Create new contacts in CRM.

Weg 3: ein webhook in Ihr CRM. Retell sendet ein call_analyzed-Ereignis mit dem vollständigen Anrufobjekt an Ihren endpoint: Transkript, Aufzeichnungs-URL, Analyseergebnisse und die metadata, die Sie beim Auslösen gesendet haben. Ihr Dienst liest die Datensatz-ID aus metadata und schreibt über die API des CRM. Prüfen Sie den Header x-retell-signature und antworten Sie innerhalb von 10 Sekunden mit einem 2xx, da Retell es andernfalls bis zu 3-mal erneut versucht. Deduplizieren Sie anhand von call_id, damit ein erneuter Versuch denselben Anruf nie doppelt schreibt. Hören Sie auf call_analyzed, nicht auf call_ended: Der call_ended-Payload wird gesendet, bevor die Analyse läuft, und enthält daher keine Analyseergebnisse.

Wie sieht die vollständige Zuordnung vom Auslöser bis zum Rückschreiben aus?

Die Tabelle ordnet gängige HubSpot-Auslöser dem Verhalten des Agenten und den in den Datensatz zurückgeschriebenen Daten zu. Der webhook-Weg folgt denselben drei Spalten.

Benutzerdefinierte Analysefelder werden bei Anrufen, die nie zustande kamen, nicht befüllt. Bauen Sie den Zweig für „niemand nimmt ab“ daher auf den integrierten Feldern und dem Anrufergebnis auf, nicht auf Ihren benutzerdefinierten Feldern.

Was sollten Sie vor dem Livegang prüfen?

• Jeder aufgenommene Kontakt hat eine gültige Telefonnummer im E.164-Format, und der Workflow filtert alle anderen heraus.
• Die CRM-Zugangsdaten haben Schreibzugriff auf jedes Objekt, in das Sie zurückschreiben. In HubSpot wird die Verbindung bei einem fehlenden Scope nicht markiert; der betroffene Schreibvorgang funktioniert einfach nicht mehr.
• Jedes benutzerdefinierte Analysefeld hat eine präzise Beschreibung, anhand derer das LLM extrahieren kann, und eine passende CRM-Eigenschaft existiert.
• Schreibvorgänge nach dem Anruf sind an Bedingungen geknüpft, sodass ein nie zustande gekommener Anruf nichts Irreführendes schreibt.
• Ein einziges System ist für den Chronikeintrag zuständig. Die Marketplace-App und die native Integration sind unabhängig voneinander und können parallel laufen – legen Sie also fest, welche den Anruf protokolliert.
• Do-not-call wird dort durchgesetzt, wo Sie es erwarten. Das Kontaktfeld do_not_call von Retell blockiert Anrufe nicht von selbst; übergeben Sie bei API-Aufrufen honor_internal_dnc: true, damit Retell sie ablehnt, und behalten Sie die eigenen Sperrregeln Ihres CRM im Auslöser bei.
• Sie testen mit einem Sandbox-Datensatz. Das Testen eines Create- oder Update-Tools schreibt einen echten Datensatz.

Wo Sie anfangen sollten

Wenn HubSpot Ihr führendes System ist, deckt die HubSpot-Integration von Retell beide Hälften dieses Kreislaufs ab: die native Verbindung, die dem Agenten Kontext liefert und Ergebnisse zurückschreibt, und die Marketplace-App, mit der ein HubSpot-Workflow den Anruf auslöst. Für die Einrichtung Schritt für Schritt, einschließlich der Scopes der privaten App, folgen Sie dem Leitfaden zur HubSpot-Einrichtung. Sie nutzen Salesforce, Dynamics 365, Zoho oder ein anderes System? Beginnen Sie mit dem Integrationsverzeichnis, und nutzen Sie den webhook-Weg für jedes CRM, das dort nicht aufgeführt ist.

Weiterführende Artikel: Die Checkliste für ausgehende Telefonnummern, Den ersten Partner-Deal abstecken sowie weitere Leitfäden im Retell Learn Hub.