Help Scout Kundeneigenschaften: Einrichtung, Grenzen und API

Kira
Geschrieben von

Kira

Katelin Teen
Geprüft von

Katelin Teen

Zuletzt bearbeitet 6. November 2026

Expertengeprüft
Handgezeichnete Support-Teammitglieder neben einer Kundenprofilkarte mit Symbolzeilen, neben dem Help Scout Logo auf einer blauen Form
TL;DR

Eine Help Scout Kundeneigenschaft ist ein benutzerdefiniertes Datenfeld auf dem Kontaktprofil. Sie können bis zu 50 Contact Properties und 50 Company Properties in fünf Typen anlegen, und sie erscheinen in der Unterhaltungs-Seitenleiste jedes Postfachs. Befüllen Sie sie von Hand, mit Zapier, der Inbox API oder Beacon identify, und nutzen Sie sie, um Workflows und gespeicherte Antworten auf Plus oder Pro zu verzweigen. Nutzen Sie Eigenschaften für Fakten über die Person und benutzerdefinierte Felder für Fakten über eine Unterhaltung. Die eesel CLI lässt einen Coding-Agenten eesel mit Help Scout verbinden und Antworten vorab testen, auch wenn ein Help Scout Administrator die Verbindung weiterhin bestätigen muss.

Was sind Help Scout Kundeneigenschaften?

Das sind die "wer ist diese Person" Felder. Help Scouts Artikel zu Eigenschaften nennt das Feature inzwischen Contact and Company Properties und sagt, dass Sie auswählen, welche Details Sie erfassen, sie manuell oder programmatisch hinzufügen, und Ihr Team sie in jeder Unterhaltung sieht. Die URL und die API sagen weiterhin "customer", weshalb beide Namen im Umlauf sind.

Create New Property Dialog mit einem Namen First Order Date, einer Property-ID first-order-date und den Typ-Optionen Text, Number, URL, Date und Dropdown, entnommen aus Help Scouts Leitfaden zu Eigenschaften
Create New Property Dialog mit einem Namen First Order Date, einer Property-ID first-order-date und den Typ-Optionen Text, Number, URL, Date und Dropdown, entnommen aus Help Scouts Leitfaden zu Eigenschaften

Typische Inhalte, nach Help Scouts eigenen Beispielen: eine Nutzer-ID, Zeitzone, Plan-ID, Rechnungsstatus, Kontoname oder das Datum, an dem jemand Kontakt wurde. Der praktische Nutzen ist, dass ein Agent, der eine Unterhaltung öffnet, nicht mehr das Abrechnungstool öffnen muss, um zu erfahren, ob der Absender auf einer kostenlosen Testversion oder einem Jahresplan ist. Wenn Sie sich noch für ein Tool entscheiden, deckt mein Help Scout Review und Help Scout Alternativen das größere Bild ab.

Wie legt man eine Eigenschaft an, und was sind die Grenzen?

Gehen Sie zu Settings, dann Properties, dann wählen Sie Contact oder Company. Nur Account Owners und Administrators können sie anlegen oder bearbeiten, auch wenn alle sie sehen können. Die Regeln, die entscheiden, ob Ihr Setup trägt:

  • Fünfzig pro Typ. Bis zu 50 Contact Properties und 50 Company Properties, global über alle Postfächer.
  • Fünf Typen. Text (bis zu 255 Zeichen), Zahl, URL (als klickbarer Link angezeigt), Datum und Dropdown (bis zu 100 Optionen).
  • Name bis zu 100 Zeichen. Der Name ist das Label, das Agenten sehen.
  • Die ID ist case-sensitive. Sie wird aus dem Namen generiert, Sie können sie überschreiben, und sie erlaubt nur Bindestriche und Unterstriche.
  • Typ und ID sind fest. Sie können den Anzeigenamen später bearbeiten, aber nicht den Typ oder die ID.
  • Löschen ist sofort. Help Scout sagt, es gibt keine Möglichkeit, eine gelöschte Eigenschaft wiederherzustellen, und eine neue Eigenschaft mit derselben ID bringt die Daten nicht zurück.

Die fest verankerte ID zählt am meisten. Wenn Zapier oder Ihr App-Code planName sendet und jemand die Eigenschaft als PlanName anlegt, geht der Wert still ins Leere. Kopieren Sie die ID von der Settings-Seite (Klick kopiert sie in die Zwischenablage) und geben Sie genau diesen String an Ihre Entwickler weiter. Zendesk benutzerdefinierte Ticketfelder haben eine ähnliche Bindung an den Feldtyp, ebenso Freshdesk Ticketfelder.

Welche Help Scout Pläne enthalten Kundeneigenschaften?

Die Dokumentation gibt zwei leicht unterschiedliche Antworten, hier also beide. Die Plan-Box des Artikels zu Eigenschaften sagt alle kostenpflichtigen Pläne. Die Beacon JavaScript API-Referenz sagt, Kundeneigenschaften seien auf Standard, Plus und Pro verfügbar, mit Company-Verwaltung auf Plus und Pro. Der Free-Plan wird in keiner der beiden genannt, also würde ich das vor dem Aufbau darauf prüfen.

PlanPreis auf der Pricing-SeiteEigenschaftenNutzung in Workflows, gespeicherten Antworten, Ansichten
Free5 Nutzer, 1 Postfach, 1 Docs-SeiteNicht gelistetNicht gelistet
Standard$25 pro Nutzer pro MonatJaNein, laut Dokumentation
Plus$45 pro Nutzer pro MonatJaJa
Pro$75 pro Nutzer pro MonatJaJa

Die Pricing-Seite beschreibt das Feature als das Sammeln und Anzeigen von bis zu 50 zusätzlichen Kundendatenpunkten und stellt erweiterte Workflows auf Plus. Preise sind Headline-Preise pro Nutzer mit einem Monats- und Jahres-Umschalter. Mein Help Scout Preise Beitrag bepreist ein ganzes Team. Der Unterschied, den man sich merken sollte: Standard-Teams können Eigenschaften speichern und sehen, aber automatisch darauf zu reagieren ist ein Plus-Feature.

Wie werden Eigenschaften befüllt?

Vier Wege, und der erste ist der, mit dem jeder anfängt. Der Artikel zu Eigenschaften geht jeden einzeln durch.

Handgezeichnetes Diagramm von vier Quellen, manuelle Bearbeitung in der Seitenleiste, Zapier, Beacon identify und Inbox API, die in eine Kundeneigenschaften-Karte fließen, die wiederum einen Workflow und eine gespeicherte Antwort füttert
Handgezeichnetes Diagramm von vier Quellen, manuelle Bearbeitung in der Seitenleiste, Zapier, Beacon identify und Inbox API, die in eine Kundeneigenschaften-Karte fließen, die wiederum einen Workflow und eine gespeicherte Antwort füttert
  1. Von Hand. Klicken Sie auf eine Eigenschaft in der Seitenleisten-Karte, um sie direkt zu bearbeiten, oder öffnen Sie Customers, dann Contacts, dann den Properties-Tab auf dem Profil.
  2. Zapier. Die Create Customer Aktion listet Ihre Contact Properties unter den Standard-Profilfeldern. Die Update Customer Properties Aktion braucht die Contact ID, fügen Sie also einen Find Customer Schritt hinzu, falls Ihr Trigger keine liefert. Meine Zapier KI Notizen decken die Automatisierungsseite ab.
  3. Beacon identify. Übergeben Sie die exakte Property-ID als Schlüssel in Beacon('identify', ...). Werte synchronisieren sich aus Ihrem Abrechnungssystem oder Ihrer App, jedes Mal wenn der Besucher Beacon lädt.
  4. Die Inbox API. Für Massenimporte oder eine laufende Synchronisation nimmt der Update Customer Properties Endpunkt ein PATCH an /v2/customers/{id}/properties.
JavaScript
Beacon('identify', {
  name: 'Steve Aoki',
  email: 'steve@aoki.com',
  signature: 'YOUR_SERVER_GENERATED_SIGNATURE_HERE',
  Subscription: 'Free Plan',
  'Favorite-Movie': ''   // ein leerer String entfernt diesen Wert
})

Laut der Beacon JavaScript API-Referenz müssen Schlüssel exakt zu bestehenden Property-IDs passen, Groß-/Kleinschreibung eingeschlossen, Werttypen müssen passen, und Eigenschaften, die in einem Aufruf fehlen, werden nicht berührt. Company Properties sind enger gefasst: Die Dokumentation sagt, Sie können sie über die öffentliche API aktualisieren, während Zapier und Beacon identify dafür noch nicht unterstützt werden. Kombinieren Sie identify mit Secure Mode, wenn Sie signierte Profile wollen, wie in meinem Beitrag zu Help Scout Beacon Formularfeldern und dem Leitfaden zu Help Scout Integrationen beschrieben.

Was akzeptiert die API für jeden Typ?

Die API ist strenger als die UI, und genau dort scheitern Massenimporte meist. Alles Folgende stammt aus der Referenz des Update-Endpunkts:

EigenschaftstypAPI-FormatBeispiel
ZahlGanzzahl5
TextString, max. 255 Zeichen"green"
URLGültige URL"google.com"
DatumYYYY-MM-DD"2019-01-02"
DropdownOption id oder label"Tesla"

Operationen sind nur replace und remove, der Pfad ist der Property-Slug mit einem führenden Schrägstrich, und ein Erfolg liefert 204 No Content. Die Eigenschaft muss zuerst angelegt werden, in der Web-App oder über den Create Property Definitions Endpunkt, und GET /v2/customer-properties listet die Definitionen mit ihren Dropdown-Options-IDs. Beim Lesen eines Kunden kommt jede Eigenschaft mit ihrem value, einem text-Label für Dropdowns und einem source-Objekt zurück, das identifiziert, welches Subsystem sie zuletzt aktualisiert hat.

Wie unterscheiden sich Eigenschaften von benutzerdefinierten Feldern der Unterhaltung?

Eigenschaften hängen an der Person, also folgen sie ihr in jede Unterhaltung. Benutzerdefinierte Felder hängen an einer Unterhaltung und sind, wie ich in meinem Beitrag zu Beacon Formularfeldern beschrieben habe, an ein Postfach gebunden, mit bis zu 10 pro Postfach auf Plus und Pro. Help Scouts Rat ist unverblümt: Nutzen Sie Eigenschaften für Details, die zu einem Kontakt gehören, und benutzerdefinierte Felder für situative Details wie die Art der Frage.

Handgezeichneter Vergleich einer Kundeneigenschaften-Karte für Plan, Account ID und Renewal Date, die in jeder Unterhaltung erscheint, und einer Karte für benutzerdefinierte Felder für Request Type und Order Number, die bei dieser einen Unterhaltung bleibt
Handgezeichneter Vergleich einer Kundeneigenschaften-Karte für Plan, Account ID und Renewal Date, die in jeder Unterhaltung erscheint, und einer Karte für benutzerdefinierte Felder für Request Type und Order Number, die bei dieser einen Unterhaltung bleibt

Meine Faustregel: Wenn die Antwort nächsten Monat in einer anderen Unterhaltung noch wahr wäre, ist es eine Eigenschaft. Beschreibt sie die heutige Frage, ist es ein Feld. Eine Unterhaltung, die zwischen Postfächern verschoben wird, behält die Eigenschaften des Kunden, weil sie global sind, ein weiterer Grund, Plan- und Kontodaten dort abzulegen. Andere Tools trennen auf dieselbe Weise, wie in Zendesk User Segmenten und CRM-Tags.

Wo sehen Agenten Eigenschaften, und können sie sie durchsuchen?

In der Unterhaltungs-Seitenleiste, eingebettet in die Customer- und Company-Karten. Jede Person kann Eigenschaften über das Drei-Punkte-Menü der Karte ein- oder ausblenden, sodass die aufgeräumte Ansicht eines Teammitglieds die eines anderen nicht verändert. Ein Klick auf den Avatar öffnet ein kombiniertes Panel mit den Profildetails und Eigenschaften, und ein Klick auf eine Eigenschaft bearbeitet sie direkt. Die Profilseite hat einen eigenen Properties-Tab.

Help Scout Kontaktprofil für Ned Trout mit hervorgehobenem Properties-Tab, das Billing Profile, Customer Since, Favorite Orders und Plan Name Eigenschaften zeigt, entnommen aus Help Scouts Leitfaden zu Eigenschaften
Help Scout Kontaktprofil für Ned Trout mit hervorgehobenem Properties-Tab, das Billing Profile, Customer Since, Favorite Orders und Plan Name Eigenschaften zeigt, entnommen aus Help Scouts Leitfaden zu Eigenschaften

Eigenschaften erscheinen auch in der globalen Suche unter der Überschrift Customer Properties. Auf Plus und Pro enthalten Help Scouts Workflow-Bedingungen eine Customer Property Bedingung, sodass ein Workflow nach Unterhaltungen suchen kann, die einen Wert enthalten oder ausschließen, und derselbe Artikel sagt, Eigenschaften lassen sich in gespeicherten Antworten und Postfach-Ansichten nutzen. Das macht aus einem gespeicherten Plannamen ein Routing, und meine Leitfäden zu automatischer Ticketzuweisung, intelligentem Routing und Ticket-Triage decken ab, was als Nächstes zu tun ist. Help Scout gespeicherte Antworten sind der andere Ort, an dem sich ein gespeicherter Planname auszahlt.

Welche Eigenschaften sollte man zuerst anlegen?

Beginnen Sie mit den drei, die ändern, wie Sie antworten, nicht mit denen, die bloß verfügbar sind.

  • Plan oder Stufe. Ein Dropdown (planName) lässt einen Workflow höhere Stufen markieren und Ihrer erfahrensten Warteschlange zuweisen, und es ist die nützlichste einzelne Eigenschaft für SLA Best Practices.
  • Konto- oder Nutzer-ID. Eine Text-Eigenschaft lässt einen Agenten sie direkt in Ihr Admin-Tool einfügen. Nutzen Sie stattdessen eine URL-Eigenschaft, wenn Sie zum Billing-Profil verlinken können, da URLs als klickbare Links dargestellt werden.
  • Verlängerungs- oder Startdatum. Eine Datums-Eigenschaft beantwortet "wie lange sind sie schon Kunde" ohne Nachschlagen.

Verzichten Sie auf alles, was Sie nur für eine Handvoll Leute befüllen würden. Eine Eigenschaft, die bei 90 Prozent der Profile leer ist, ist Unordnung in der Seitenleiste, und Sie haben eine feste Obergrenze von 50. Halten Sie Dropdown-Optionen kurz, denn die API akzeptiert das Options-Label, und eine Umbenennung kann eine Synchronisation brechen, die den alten Text sendet.

Wo passt ein KI-Agent zu Kundeneigenschaften?

eesel ist ein KI-Helpdesk-Teammitglied, das im Help Scout Postfach arbeitet. Seine Help Scout Setup-Dokumentation listet eine Find customer Aktion, die Kunden per E-Mail oder Namen findet und, in Team-Chats, auch Kontaktdetails, die Notizen Ihres Teams und deren Eigenschaftswerte liest, etwa den Plan. Eine List properties Aktion listet die Kunden- und Organisationseigenschaften, die Ihr Konto führt. Die Dokumentation sagt außerdem, Aktionen, die als Team-Chats-only markiert sind, funktionieren nur, wenn ein Teammitglied den Agenten fragt, im Dashboard-Chat oder einem geplanten Lauf, und sind nicht verfügbar, während er einem Kunden antwortet.

Hier also die ehrliche Zusammenfassung. Ein Teammitglied kann eesel fragen "auf welchem Plan ist dieser Kunde?" und eine Antwort aus dem Profil bekommen. Während eesel einem Kunden eine Antwort entwirft, ist das dokumentierte Lesen von Eigenschaften nicht Teil dieses Ablaufs, und ich habe keine dokumentierte Aktion gefunden, die Eigenschaften schreibt. Das Muster, das ich nutzen würde, ist, einen Help Scout Workflow die Eigenschaft in ein Tag auf Plus oder Pro verwandeln zu lassen und dann den Agenten auf dem Tag handeln zu lassen, wie ich es in KI-Ticket-Triage beschreibe. Meine Beiträge zu Help Scout KI-Agent und Help Scout KI vertiefen das Setup.

Mein nächstliegendes echtes Beispiel ist auf einem anderen Helpdesk. MentorShow, eine französische Online-Lernplattform, betreibt eesel auf HubSpot Service Hub. Ihre Instruktionen sagen dem Agenten, den Thread und den HubSpot-Datensatz des Mitglieds zu lesen, einschließlich Abonnementstatus, nächstem Verlängerungsdatum und vergangenen Tickets, denn ein Login-Problem von jemandem ohne aktives Abonnement ist kein Login-Problem. Zwischen dem 8. August und dem 8. September 2026 las eesel rund 1.200 HubSpot-Unterhaltungen und -Tickets und schrieb 432 Entwürfe für das Team, jeder als interne Notiz belassen, damit eine Person sie sendet. Das ist der Job, den eine Plan-Eigenschaft in Help Scout macht: wer auch immer antwortet, den Kontokontext geben, bevor das erste Wort geschrieben ist. Siehe auch die HubSpot Integration.

Für einen Coding-Agenten kann die eesel CLI npx @eesel/cli integrations connect helpscout_v2 ausführen, um die Verbindungsoptionen zu zeigen, und eesel chat lässt Sie vorab Testfragen stellen. Das Verbinden des Postfachs braucht weiterhin einen Help Scout Administrator oder Account Owner, der es im Browser bestätigt.

Welche Fehler sollte man bei Eigenschaften vermeiden?

  1. Eine nicht passende ID. planName ist nicht PlanName. Kopieren Sie die ID von der Settings-Seite.
  2. Eine Eigenschaft löschen, um aufzuräumen. Die Daten sind bei jedem Kontakt weg und können nicht wiederhergestellt werden.
  3. Eine Unterhaltungstatsache als Eigenschaft speichern. "Anfrageart" überschreibt sich mit jeder neuen Unterhaltung. Nutzen Sie ein benutzerdefiniertes Feld.
  4. Falsche Werttypen. Ein Datum muss über die API YYYY-MM-DD sein, und eine Zahl muss eine Ganzzahl sein.
  5. Routing auf Standard aufbauen. Die Workflow-Bedingung braucht Plus oder Pro.
  6. Company Properties über jeden Weg erwarten. Zapier und Beacon identify unterstützen sie noch nicht.

Testen Sie einen Kontakt komplett durch, bevor Sie einen Massenimport machen. Setzen Sie den Wert, finden Sie ihn in der Seitenleiste, lösen Sie den Workflow aus und prüfen Sie das Ergebnis. Wenn Sie später einen Agenten hinzufügen, starten Sie mit Leave draft reply und lassen Sie Send reply aus, bis die Antworten verlässlich sind, wie ich in Freigabe-Workflows für Kundensupport und KI-Agenten-Übergabe erkläre. Für verwandtes Help Scout Setup siehe geschobene Unterhaltungen, Kollisionserkennung und Ticket-Abwehr. First Contact Resolution erklärt, warum sich Kontext auf dem Profil auszahlt.

eesel mit Ihrem Help Scout Postfach testen

Wenn Ihre Eigenschaften Ihnen schon sagen, wer auf welchem Plan ist, ist eesel für Help Scout die nächste Schicht, die ich hinzufügen würde. Es arbeitet im Postfach, liest Ihre Docs-Seite und vergangenen Unterhaltungen und lässt ein Teammitglied es nach dem Plan eines Kunden aus dem Profil fragen. Sie können eesel testen mit 100 kostenlosen Credits für 7 Tage, danach starten kostenpflichtige Pläne bei $299 im Monat für 500 Credits, wobei ein Ticket oder Chat ein Credit ist (eesel Preise). Sie vergleichen Optionen? Siehe meine Übersicht beste KI für Help Scout, oder Help Scout vs Front.

Häufig gestellte Fragen

Was sind Kundeneigenschaften in Help Scout?
Das sind benutzerdefinierte Datenfelder auf dem Kontaktprofil, etwa Planname, Konto-ID oder Verlängerungsdatum. Help Scouts Dokumentation nennt sie inzwischen Contact Properties, und sie erscheinen in der Seitenleiste der Unterhaltung. Mein Help Scout Features Leitfaden deckt den Rest des Produkts ab.
Wie viele Kundeneigenschaften kann man in Help Scout anlegen?
Bis zu 50 Contact Properties und 50 Company Properties pro Konto, gültig über alle Postfächer hinweg. Jede hat einen von fünf Typen: Text, Zahl, URL, Datum oder Dropdown. Siehe Help Scout Preise für die Kosten je Plan.
Welche Help Scout Pläne enthalten Kundeneigenschaften?
Help Scouts Artikel zu Eigenschaften listet alle kostenpflichtigen Pläne, und die Beacon API-Referenz nennt Standard, Plus und Pro. Sie in Workflows, gespeicherten Antworten und Ansichten zu nutzen, braucht laut demselben Artikel Plus oder Pro. Mein Help Scout Preise Beitrag bepreist ein ganzes Team.
Wie aktualisiert man Help Scout Kundeneigenschaften über die API?
Senden Sie ein PATCH an /v2/customers/{id}/properties mit replace oder remove Operationen, wobei der Pfad der Property-Slug ist. Die Eigenschaft muss vorher existieren. Mein Help Scout API Leitfaden deckt die breitere API ab.
Was ist der Unterschied zwischen Kundeneigenschaften und benutzerdefinierten Feldern in Help Scout?
Eigenschaften beschreiben die Person und erscheinen in jeder Unterhaltung, die sie führt. Benutzerdefinierte Felder beschreiben eine Unterhaltung, etwa den Anfragetyp, und brauchen Plus oder Pro. Help Scout empfiehlt Eigenschaften für Fakten auf Kontaktebene. Vergleichen Sie mit Freshdesk Ticketfeldern.
Kann Beacon identify Help Scout Kundeneigenschaften befüllen?
Ja. Übergeben Sie die exakte Property-ID als Schlüssel in Beacon('identify', ...), und der Wert wird bei jedem Laden von Beacon mit dem Kontakt synchronisiert. Ein leerer String als Wert entfernt ihn. Siehe meinen Beitrag zu Beacon Formularfeldern.
Kann eesel Help Scout Kundeneigenschaften lesen?
eesels Dokumentation sagt, dass die Aktion Find customer Eigenschaftswerte wie den Plan liest, aber nur in Team-Chats, nicht während es einem Kunden antwortet. Sie listet keine Aktion, die Eigenschaften schreibt. Siehe die Help Scout Integration und die beste KI für Help Scout Übersicht.
Kann man eine Help Scout Kundeneigenschaft löschen und wiederherstellen?
Nein. Das Löschen ist sofort, entfernt die Daten von jedem Kontakt, und eine neu angelegte Eigenschaft mit derselben ID stellt die Daten nicht wieder her. Behandeln Sie den Löschen-Link wie eine Einbahnstraße. Mein Help Scout KI Überblick deckt sicherere Wege zur Automatisierung ab.

Share this article