Kontakt in HubSpot suchen

Was ist die Komponente “Kontakt in HubSpot suchen”?

Die Komponente “Kontakt in HubSpot suchen” ermöglicht es Ihnen, Kontakte nach jeder beliebigen HubSpot-Eigenschaft zu finden und zu filtern – auch nach benutzerdefinierten Eigenschaften. In Kombination mit Operator-Optionen sind so Dutzende einzigartige Anwendungsfälle möglich.

Hauptvorteile dieser Komponente

• Flexible Eigenschaftssuche: Filtern Sie Kontakte nach beliebigen HubSpot-Eigenschaften, einschließlich benutzerdefinierter Felder. Das gibt Ihnen die volle Kontrolle über gezielte Datenabfragen.
• Erweiterte Operator-Unterstützung: Verwenden Sie Bedingungen wie Gleich, Größer als, Kleiner als, Zwischen, Enthält und weitere. So sind präzise und individuell anpassbare Abfragen möglich.
• Workflow-Kompatibilität: Nutzen Sie die Komponente in Kombination mit anderen, um vollständige Flows zu bauen. Ideal für Lead-Tracking, Erinnerungen oder zum Datenabgleich über verschiedene Tools hinweg.
• Verbesserte Datenhygiene: Identifizieren Sie einfach unvollständige oder veraltete Kontakte. So bleibt Ihr CRM sauber und aktuell.
• Zeitbasierte Filterung: Suchen Sie nach Erstellungs- oder Änderungsdatum. Perfekt für Jubiläumsangebote, Reaktivierungskampagnen oder die Erkennung inaktiver Leads.
• Individuelle Ausgabemöglichkeiten: Senden Sie Ergebnisse dorthin, wo Sie sie benötigen – Chat, Slack, Google Sheets, E-Mail und mehr. So automatisieren Sie Berichte und Benachrichtigungen ganz einfach.

Komponenteneinstellungen

Operator

Operatoren sind mathematische Funktionen, die die Beziehung zwischen Ihrer Abfrage und dem, wonach Sie suchen, beschreiben. So können Sie zum Beispiel nach einer exakten Übereinstimmung von E-Mails suchen, aber auch nach Kontakten, die nach einem bestimmten Datum erstellt wurden, nach Kontakten ohne bestimmte Eigenschaften und vielem mehr.

Eigenschaftsname

Sie können nach HubSpot-Eigenschaften oder benutzerdefinierten Objekten suchen. In Kombination mit Operator-Optionen sind Dutzende einzigartige Anwendungsfälle möglich. Neben Kontaktinformationen wie Name, E-Mail oder Firma können Sie auch nach Erstellungs- oder Änderungsdatum, Lifecycle-Phase und mehr filtern.

Weitere Einstellungen

• Limitierungen: Legen Sie die Anzahl der abzurufenden Kontakte fest. Der Standardwert ist 1 für exakte Übereinstimmungen, aber Sie können auch einen höheren Wert für Massenaktionen einstellen. Beachten Sie, dass mit der Anzahl der Ergebnisse auch Zeitaufwand und Preis steigen.
• Tool-Beschreibung: Geben Sie zusätzliche Informationen, damit der Agent weiß, wie das Tool zu verwenden ist.
• Tool-Name: Vergeben Sie einen Namen, den der Agent in ausführlichen Ausgaben für diese Komponente verwenden soll. Dieser dient Ihrer Übersicht.
• Verbose: Wählen Sie aus, ob der Agent seinen Denkprozess im FlowHunt-Chat anzeigen soll. Besonders hilfreich für Debugging-Zwecke.

Handles

• Tool: Verbinden Sie die Komponente als Tool mit einem KI-Agenten. Dies ist der Hauptausgang, damit der Agent die Komponente zum Erstellen neuer Kontakte nutzen kann.
• Nach Kontakt hinzufügen: Verbinden Sie Komponenten, um Aktionen festzulegen, die nach der Kontakterstellung erfolgen sollen. Zum Beispiel Slack-Benachrichtigungen, automatisches Aktualisieren von Google Sheets oder weitere Datenverarbeitung.

Wie verwendet man die Komponente “Kontakt in HubSpot suchen”?

Nachdem wir besprochen haben, was die Komponente kann, werfen wir nun einen Blick auf die Anwendung. Hier einige beliebte Anwendungsfälle, die zeigen, welche Probleme sich mit dieser Komponente lösen lassen:

• Compliance und Datenhygiene: Mit Operatoren wie „nicht enthalten“, „hat Eigenschaft nicht“ oder „enthält Token“ finden Sie Test-Leads, fehlende Kontaktdaten oder unvollständige Datensätze zum Unterdrücken oder Bereinigen.
• Erkennung inaktiver Leads: Automatische Benachrichtigungen für Kontakte mit lifecycle=lead, die seit einer bestimmten Zeit nicht mehr aktualisiert wurden.
• Geo-basierte Kampagnen: Suche nach Kontakten aus bestimmten Ländern, Städten oder Postleitzahlen zur Generierung und Versendung von standortbasierten Kampagnen, Eventeinladungen und mehr.
• Zeitbasierte Kampagnen: Suche nach Kontakten mit einem bestimmten Erstellungsdatum zur Generierung und Versendung von Jubiläumsangeboten.
• Erinnerungen zur automatischen Verlängerung: Mit dem Operator „kleiner oder gleich“ für das letzte Änderungsdatum finden Sie Kunden, deren Verlängerung ansteht, und können ein Check-In oder spezielle Angebote auslösen.
• Neuer Kontakt aus Zielunternehmen: Erkennung von neu angelegten Kontakten aus Zielunternehmen, um sofort interne Benachrichtigungen auszulösen oder an den passenden Vertrieb weiterzuleiten.
• Postleitzahlbasierte Vertriebszuordnung: Mit dem Operator „in“ werden Kontakte einer vordefinierten Liste von Postleitzahlen zugeordnet und an einen regionalen Vertreter oder eine lokale Kampagne übergeben.
• Interessenbasiertes Routing: Mit benutzerdefinierten Eigenschaften wie „Interesse = Produkt A“ leiten Sie Kontakte sofort an relevante Vertriebsfolgen oder Content-Journeys weiter.

Aufbau eines Flows zur Erkennung inaktiver Leads

Testen wir die Komponente anhand eines einfachen Flows zur Erkennung inaktiver Leads. Wir suchen also nach Kontakten mit lifecycle stage = lead UND letztes Änderungsdatum vor X Tagen.

Zu diesem Zweck testen wir die Komponente als Chatflow. Dieser Prozess kann jedoch auch vollständig automatisiert als Cronjob ablaufen und die Ausgabe dorthin senden, wo sie benötigt wird – etwa Slack- oder Gmail-Benachrichtigungen für den schnellen Zugriff oder ein Spreadsheet für automatische Berichte.

Schritte:

1. Da es sich um einen Chatflow handelt, fügen Sie Chat Input, Output und History hinzu.
2. Fügen Sie einen KI-Agenten hinzu, der die HubSpot-Komponente als Tool verwendet.
3. Da wir zwei Suchbedingungen benötigen, benötigen wir zwei Komponenten “Kontakt in HubSpot suchen”.
4. Verbinden Sie die Komponenten wie im folgenden Diagramm dargestellt:

5. Richten Sie nun den Such-Operator und den Eigenschaftsnamen ein.
6. Die erste Suchkomponente sucht nach lastmodifieddate, das größer oder gleich X Tage ist. Sie sucht somit nach veralteten Datensätzen:

7. Die zweite Suchkomponente sucht nach lifecyclestage, das gleich lead ist. Damit werden keine bestehenden Kunden oder andere Datensatztypen berücksichtigt:

8. Das ist alles, was Sie für einen Chatflow benötigen, in dem Sie Anweisungen im Chat geben und die Ergebnisse im Chat erhalten. Sie können diesen Flow weiter ausbauen und ihn automatisch ausführen lassen, damit die Ergebnisse an Drittanbieter-Apps statt an den Chat gesendet werden.

Testen wir es. Wir geben im Chat folgende Anweisung ein:

Gib Kontakte zurück, bei denen die Lifecycle-Phase ’lead’ ist UND das letzte Änderungsdatum größer oder gleich 5 Tage ist.

In einem vollautomatisierten Workflow würden Sie diese Anweisungen dauerhaft in die KI-Agenten- und Komponenteneinstellungen eintragen. Da wir einen Chatflow testen, können wir die Anweisung einfach im Chat senden.

Nach kurzer Verarbeitung liefert der Flow einen Kontakt zurück:

Überprüfen wir das Ergebnis. In unserer HubSpot-Kontaktliste sehen wir vier Datensätze. Einer davon ist jedoch ein Kunde. Die beiden anderen wurden heute (10. April) aktualisiert. Das bedeutet, dass der zurückgegebene Kontakt tatsächlich als einziger die gewünschten Kriterien erfüllt:

In unserem Beispiel geben wir die Anweisung manuell im Chat ein und erhalten das Suchergebnis ebenfalls im Chat. Sie können das jedoch auch zu einer vollautomatischen Lösung ausbauen, indem Sie den Flow als Cronjob laufen lassen und die Chat-Ausgabe gegen jede andere gewünschte Ausgabekomponente austauschen – etwa das Google Sheet-Erstellen-Tool für Berichte oder das Slack-Nachricht versenden- oder E-Mail-Benachrichtigungstool für Benachrichtigungen.