Wenn Sie Website-Inhalte zu Intercom hinzufügen und für den Fin AI Agent und Copilot verfügbar machen möchten, können Sie dies tun, indem Sie die öffentliche URL Ihrer Website synchronisieren. Sie können Fin und Copilot auch mit Inhalten aus Blogbeiträgen, Changelogs, Nachrichten-Updates oder anderen Webseiten mit Datumsangaben trainieren. So stellen Sie sicher, dass Fin und Copilot stets die aktuellsten und relevantesten Informationen aus diesen Quellen verwenden.
Hinweis: Diese Funktion funktioniert nur mit öffentlichen URLs. Wenn der Inhalt, den Sie verwenden möchten, hinter einer Anmeldung liegt, kann Fin nicht darauf zugreifen oder ihn importieren.
Website-Inhalte mit Fin und Copilot synchronisieren
Gehen Sie zu Fin AI Agent > Train > Content und wählen Sie dann unter „Inhalt hinzufügen“ Website-Synchronisierung aus.
Geben Sie nun die URL Ihres externen Support-Inhalts (Top-Level domain) ein und klicken Sie auf Weiter:
Dies ruft alle Seiten der von Ihnen angegebenen Website-URL ab und liest alle Subdomain-Seiten aus.
Tipp: Top-Level domains liefern die besten Ergebnisse (z. B. verwenden Sie die Startseite Ihres externen help center unter https://myhelpcenter.com anstelle von Unterseiten wie https://myhelpcenter.com/articles).
Hinweis: Die Website-Synchronisierung ist auf maximal 100 Websites begrenzt.
Seiten zur Synchronisierung überprüfen
Nachdem Sie Ihre URL eingegeben haben, prüfen wir, ob sie gültig und zugänglich ist. Anschließend müssen Sie die Seiten zur Synchronisierung überprüfen. Alle Unterseiten, die in jedem ausgewählten Abschnitt verlinkt sind, werden synchronisiert. Wählen Sie nur relevante und aktuelle Inhalte aus.
Tipps:
Wählen Sie Seiten und Abschnitte aus, die Support-Inhalte wie Hilfeartikel, Anleitungen oder FAQs enthalten.
Vermeiden Sie die Auswahl von Marketingseiten, Produktlisten oder Seiten mit komplexen Layouts.
Alle verlinkten Unterseiten innerhalb der ausgewählten Abschnitte werden automatisch einbezogen.
Sie können Ihre Auswahl später jederzeit in den erweiterten Einstellungen aktualisieren.
Erweiterte Einstellungen [optional]
Wählen Sie das Dropdown-Menü Erweiterte Einstellungen, um zusätzliche URLs zu konfigurieren, URLs auszuschließen, CSS-Selektoren zum Ausschluss usw.
Zusätzliche URLs
Website-Strukturen können variieren. Um sicherzustellen, dass wir Ihre relevantesten Inhalte synchronisieren, empfehlen wir, zusätzliche URLs für bestimmte Unterseiten hinzuzufügen.
Wenn Sie beispielsweise https://myhelpcenter.com/help als primäre URL oben eingeben, möchten Sie möglicherweise auch die spezifische URL wie https://myhelpcenter.com/help/index.html hinzufügen.
URLs zum Ausschließen
Um bestimmte Seiten auszuschließen, von denen Sie keine Inhalte synchronisieren möchten, können Sie eine Liste von URL-Globs hinzufügen.
Was ist ein URL-Glob?
Ein Glob ist eine Zeichenkette aus Literal- und/oder Platzhalterzeichen, die verwendet wird, um Dateipfade oder URLs abzugleichen. Globbing ist der Vorgang, Dateien in einem Dateisystem mit einem oder mehreren Globs zu finden. Die Verwendung von URL-Globs hilft auch dabei, eine Reihe von URLs zu erfassen, die größtenteils gleich sind, wobei sich nur ein kleiner Teil zwischen den Anfragen ändert.
Beispielsweise erlaubt dieser URL-Glob https://{store,docs}.example.com/** dem Crawler den Zugriff auf alle URLs, die mit https://store.example.com/ oder https://docs.example.com/ beginnen, sowie https://example.com/**/*\?*foo=*.
Tipp: Sie sind sich nicht sicher, ob Ihr Glob-Muster mit den URLs übereinstimmt, die Sie ausschließen möchten? Sie können DigitalOcean's Glob Tool verwenden, um Muster gegen Beispiel-URLs zu testen, bevor Sie sie anwenden. (Dies ist ein Drittanbieter-Tool, das nicht von Intercom gewartet wird.)
Zu berücksichtigende Seitenelemente
Als Nächstes können Sie auswählen, ob nur der Hauptseiteninhalt einbezogen werden soll oder ob Sie bestimmte Elemente auf der Seite durch Auswahl von Benutzerdefiniert ein- oder ausschließen möchten.
Zu ausschließende Seitenelemente
Um bestimmte Seitenelemente auszuschließen, können Sie CSS-Selektoren für die spezifischen Abschnitte oder Elemente verwenden, die Sie ausschließen möchten.
Dies ist nützlich, um irrelevante Seiteninhalte zu überspringen. Der Wert muss ein gültiger CSS-Selektor sein, wie er von der Funktion document.querySelectorAll() akzeptiert wird. Standardmäßig entfernen wir bereits häufige Navigationselemente, Kopf- und Fußzeilen, Modale, Skripte und Inline-Bilder.
Klickbare Seitenelemente
Dies ermöglicht es, dass DOM-Elemente, die durch den CSS-Selektor identifiziert werden, während des Web-Synchronisierungsprozesses angeklickt werden können.
Dies ist nützlich, um eingeklappte Abschnitte zu erweitern, um deren Textinhalt zu erfassen. Der Wert muss ein gültiger CSS-Selektor sein, wie er von der Funktion document.querySelectorAll() akzeptiert wird.
Beispiele sind "[aria-expanded=\"false\"]", #expand_section
Komplexe Bedingungen können auch mit einem CSS-Selektor beschrieben werden. Im CSS erzeugt das Aneinanderreihen von Selektoren ohne Leerzeichen eine UND-ähnliche Bedingung, z. B. .button.blue.small passt nur zu Elementen mit allen drei Klassen.
Die Verwendung von Komma (,) als Trennzeichen funktioniert wie ODER, z. B. .button, .blue, h1 zielt auf alle Elemente mit der Klasse button, oder der Klasse blue oder Überschriften der ersten Ebene ab.
Auf das Laden des Seitenelements warten
Um Inhalte anzusprechen, die möglicherweise verzögert auf der Seite erscheinen, können Sie einen CSS-Selektor hinzufügen, der den Web-Scraper dazu bringt, vor dem Abrufen der Inhalte zu warten.
Dies ist nützlich für Seiten, bei denen die standardmäßige Erkennung des Inhaltsladezustands durch das Leerlaufnetzwerk fehlschlägt. Das Festlegen dieser Option deaktiviert das Standardverhalten vollständig, und die Seite wird nur verarbeitet, wenn das durch diesen Selektor angegebene Element erscheint.
Hinweis: Der Wert muss ein gültiger CSS-Selektor sein, wie er von der Funktion document.querySelectorAll() akzeptiert wird.
Proxy-Region
Sie können einen Proxy auswählen, den der Crawler verwenden soll, wenn Ihre Website mit einem Proxy aus einer bestimmten Region oder einem bestimmten Land gecrawlt werden soll.
Wir unterstützen derzeit folgende Proxys:
Rotierend: Vereinigte Staaten, Deutschland, Frankreich, Vereinigtes Königreich, Tschechien, Ungarn
Statisch:
Vereinigte Staaten - 119.13.211.225, 161.123.167.215, 94.176.49.232, 185.223.56.90, 154.17.143.135
Europa - 178.171.116.231, 206.232.77.243, 206.232.90.11, 209.20.175.180, 45.94.247.149
Australien - 154.220.151.84, 173.254.193.121, 160.224.101.213, 160.224.100.176, 212.70.22.41
Zielgruppen
Der Ziel-Schritt ermöglicht es Ihnen, eine Standardzielgruppe für alle synchronisierten Seiten festzulegen und URL-basierte Regeln zu erstellen, um automatisch bestimmte Zielgruppen basierend auf URL-Mustern zuzuweisen – keine manuelle Kennzeichnung erforderlich.
Entscheiden Sie zunächst, ob Inhalte aus dieser Quelle für Fin AI Agent und/oder Copilot aktiviert sind.
Dann können Sie entweder eine Standard-Fin-Zielgruppe festlegen, die auf alle von dieser Quelle synchronisierten Seiten angewendet wird (wenn keine Standardzielgruppe festgelegt ist, gilt der Inhalt standardmäßig für Jeden), oder Regeln erstellen, um bestimmte Zielgruppen basierend auf URL-Mustern zuzuweisen.
Zum Beispiel: Wenn die URL /uk enthält, weise die UK-Zielgruppe zu. Regeln werden während der Synchronisierung ausgewertet, sodass Fin und Copilot immer die richtigen Inhalte für die richtige Zielgruppe bereitstellen.
Jede Regel unterstützt drei URL-Vergleicher:
Beginnt mit — entspricht URLs, die mit einem bestimmten Präfix beginnen.
Endet mit — entspricht URLs, die mit einem bestimmten Suffix enden.
Enthält — entspricht URLs, die eine bestimmte Teilzeichenfolge enthalten.
Hinweis:
Eine Live-Vorschau zeigt, wie viele Seiten jeder Regel entsprechen, und hilft Ihnen, Regeln vor dem Speichern zu validieren. Dies erfordert eine Sitemap für Ihre Web-Synchronisierungsquelle. Ohne Sitemap gelten die Regeln weiterhin, aber Sie können keine Übereinstimmungen in der Vorschau sehen.
Regeln werden bei der Erstellung automatisch benannt, können aber umbenannt werden. Es gilt eine maximale Anzahl von 10 Regeln pro Web-Synchronisierungsquelle.
Zielgruppenregeln sind nur additiv: Sie fügen Zielgruppen zu Inhalten hinzu, entfernen aber niemals bestehende Zuordnungen. Das Entfernen einer Regel macht ihre früheren Zielgruppenzuordnungen nicht rückgängig.
Synchronisierungseinstellungen überprüfen
Überprüfen Sie abschließend Ihre Synchronisierungseinstellungen und klicken Sie dann auf Website synchronisieren, um mit der Synchronisierung Ihrer Website-Inhalte mit Intercom zu beginnen.
Website-Synchronisierungen verwalten
Sobald die Synchronisierung abgeschlossen ist, erhalten Sie eine E-Mail-Benachrichtigung und die Website wird als synchronisierte Quelle unter Fin AI Agent > Train > Content angezeigt.
Einstellungen für bestimmte Seiten konfigurieren
Gehen Sie zu Fin AI Agent > Train > Content, wählen Sie die Website-Quelle aus und klicken Sie dann auf eine Seite, die Sie synchronisiert haben. Auf der rechten Seite finden Sie ein "Details"-Panel, das Folgendes enthält:
Daten: Anzeigen des Inhaltstyps, der Sprache, des Erstellungsdatums und der letzten Aktualisierung (wann zuletzt mit der Quelle synchronisiert).
Fin-Einstellungen: Zum Aktivieren/Deaktivieren für Fin AI Agent und Copilot. Wenn aktiviert, wird der Inhalt Kunden über Fin AI Agent und Teammitgliedern über Copilot jeweils verfügbar gemacht.
Link: Die öffentliche URL für diese Website-Quelle.
Berichte: Die Fin-Konversationen, an denen diese Website-Quelle beteiligt war oder die gelöst wurden.
Tags: Zum Anwenden eigener benutzerdefinierter Tags zur Gruppierung und Organisation von Inhalten in Intercom.
Ordner: Der Ordner, in dem sich diese öffentliche URL im Knowledge Hub befindet. Sie können den Ordner synchronisierter Inhalte nicht ändern.
Hinweis: Website-Quellen sind schreibgeschützt und können nicht innerhalb von Intercom bearbeitet werden, sie müssen an der Quelle bearbeitet werden.
Für Fin und Copilot verfügbar machen
Um eine Website-Quelle für Fin AI Agent und/oder Copilot verfügbar zu machen, gehen Sie zu Fin AI Agent > Train > Content, wählen Sie die Website-Quelle aus, klicken Sie dann auf die synchronisierte(n) Live-Seite(n) und wählen Sie AI-Agent-Status ändern > Für AI Agent aktivieren oder Copilot-Status ändern > Für Copilot aktivieren.
Sie können diese Einstellungen auch von einer einzelnen Webseite im "Details" Panel aus verwalten, scrollen Sie nach unten zu den Fin-Einstellungen und wählen Sie, ob Sie Folgendes aktivieren möchten:
Fin AI Agent - Diese Einstellung macht die öffentliche URL für Fin verfügbar, wenn Kundenanfragen beantwortet werden.
Copilot - Diese Einstellung macht die öffentliche URL für Copilot verfügbar, wenn Teammitglieder Fragen im inbox über das Copilot-Panel beantworten.
Erfahren Sie, wie Sie Fin AI Agent einrichten für Ihre Kunden oder wie Sie Ihr Team bei der Nutzung von Copilot im inbox aktivieren.
Für eine bestimmte Zielgruppe verfügbar machen
Sie können Zielgruppen für synchronisierte Inhalte automatisch mit URL-basierten Regeln während der Web-Synchronisierung erstellen oder manuell pro Seite zuweisen. Zuerst müssen Sie die Zielgruppe erstellen und definieren, die Sie ansprechen möchten.
Um eine Zielgruppe manuell einzelnen Seiten zuzuweisen, gehen Sie zu Fin AI Agent > Train > Content, wählen Sie die Website-Quelle aus, klicken Sie dann auf die synchronisierte(n) Live-Seite(n) und wählen Sie Weitere Aktionen > Fin-Zielgruppe ändern.
Hinweis:
Die Standardzielgruppe für öffentliche URLs ist „Jeder“.
Fin respektiert jede Zielgruppe, die Sie einer öffentlichen URL zuweisen, und verwendet diesen Artikel nur zur Beantwortung von Kundenfragen, wenn sie den Zielgruppenregeln entsprechen.
Zielgruppenregeln bei bestehenden Synchronisierungen hinzufügen oder bearbeiten
Sie müssen eine Synchronisierung nicht neu erstellen, um Zielgruppen-Targeting hinzuzufügen. Gehen Sie zu Fin AI Agent > Train > Content, wählen Sie die Quelle aus, klicken Sie auf das Einstellungs-Dropdown oben rechts und wählen Sie Einstellungen öffnen. Navigieren Sie zum Ziel-Schritt, um URL-basierte Regeln hinzuzufügen oder zu bearbeiten.
Hinweis: Wenn Zielgruppenregeln zu einer bestehenden Web-Synchronisierung hinzugefügt werden, gelten sie rückwirkend für alle bereits aus dieser Quelle aufgenommenen Inhalte – nicht nur für neue Inhalte.
Website als Quelle erneut synchronisieren oder entfernen
Wenn Sie eine öffentliche URL als Quelle erneut synchronisieren oder entfernen möchten, gehen Sie zu Fin AI Agent > Train > Content und wählen Sie die Quelle aus. Klicken Sie dann auf das Einstellungs-Dropdown oben rechts und wählen Sie Erneut synchronisieren oder Diese Quelle entfernen.
Tipp: Website-Erneut-Synchronisierungen finden in der Regel wöchentlich statt (abhängig von der Größe der Quelle) und können jederzeit manuell erneut synchronisiert werden.
Website-Synchronisierungseinstellungen verwalten
Wenn Sie die erweiterten Einstellungen für eine Website-Synchronisierung anpassen möchten, gehen Sie zu Fin AI Agent > Train > Content und wählen Sie die Quelle aus. Klicken Sie dann auf das Einstellungs-Dropdown oben rechts und wählen Sie Einstellungen öffnen.
Website-Synchronisierungsverlauf anzeigen
Sie können eine Liste vergangener Website-Synchronisierungen einsehen, um zu sehen, wann sie zuletzt ausgeführt wurden, welche Seiten gefunden wurden und welche Seiten fehlgeschlagen sind. Gehen Sie zu Fin AI Agent > Train > Content, wählen Sie die Website-Quelle aus, klicken Sie dann auf das Einstellungs-Dropdown oben rechts und wählen Sie Synchronisierungsverlauf anzeigen.
Jede Zeile in der Tabelle stellt einen vergangenen oder aktiven Lauf dar, und Sie können die Läufe nach Status filtern. Sie enthält folgende Informationen:
Synchronisierungsdatum
Status
Synchronisierte Seiten
Ausgeschlossene Seiten
Fehlgeschlagene Seiten
Dauer
Synchronisierung gestartet von
Wenn eine Synchronisierung fehlgeschlagen ist, können Sie mit der Maus über den Status fahren, um eine detaillierte Erklärung zu sehen, warum.
Fehlerbehebung bei der Website-Synchronisierung
Häufige Probleme
Beim Importieren von Website-Inhalten zur Aktivierung von Fin müssen Sie die öffentliche URL eingeben. Dies sucht alle Seiten, die unter dieser URL verschachtelt sind, und synchronisiert sie für den Fin AI Agent zur Nutzung.
Wenn der Importeur nicht die erwartete Anzahl an Seiten zurückgegeben hat, gibt es einige Gründe dafür...
Die angegebene URL ist nicht die Top-Level-domain
Die Website-Synchronisierung funktioniert, indem die von Ihnen angegebene URL aufgerufen wird und dann alle Seiten gesucht werden, die unter dieser URL verschachtelt sind. Diese Seiten müssen dasselbe URL-Muster wie die von Ihnen angegebene URL haben.
Zum Beispiel, wenn die Top-Level-domain https://myhelpcenter.com/home ist, müssen alle Seiten, die Sie importieren möchten, das Präfix /home in der URL enthalten, z. B. https://myhelpcenter.com/home/article. Wenn dies nicht der Fall ist, entfernen Sie das Präfix und verwenden Sie den einfachsten URL-Stamm, z. B. https://myhelpcenter.com, und versuchen Sie den Import erneut.
Die URL ist privat
Wenn der Inhalt, den Sie verwenden möchten, hinter einer Anmeldung liegt, kann Fin nicht darauf zugreifen oder ihn importieren.
Seitenbegrenzungen
Sie können bis zu 100 verschiedene Top-Level-domains synchronisieren, und Fin synchronisiert maximal 30.000 Seiten von jeder Quelle. Die Synchronisierung kann manchmal fehlschlagen, wenn eine einzelne Seite sehr viel Inhalt hat (Sie werden benachrichtigt, wenn eine Synchronisierung fehlschlägt).
Hinweis:
Wenn Ihre Website diese Größenbeschränkung überschreitet, können Sie folgenden Workaround versuchen:
Teilen Sie die Website in kleinere Abschnitte auf.
Synchronisieren Sie verschiedene URL-Pfade separat.
Dies reduziert die Seitengröße pro Synchronisierung und hilft, Synchronisierungsfehler zu vermeiden.
Websites, die auf bestimmte regionale IPs beschränkt sind
Die Website-Synchronisierung von Intercom (verwendet, um öffentliche URLs für Fin AI Agent und Copilot hinzuzufügen) verwendet derzeit keinen dedizierten, benutzerdefinierten User-Agent-String.
Um diese Anfragen zu identifizieren oder zuzulassen:
Nach IP-Adresse: Unser Crawler verwendet normalerweise dynamische IPs. Wenn Ihre Website eine Zulassungsliste benötigt, kontaktieren Sie uns, und wir können statische, regionsspezifische IPs für Ihren Workspace aktivieren.
Diese Anfragen werden nur für die Website-Synchronisierung verwendet. Sie beeinflussen nicht Ihren Messenger-Verkehr oder das Endbenutzer-Tracking.
Fehler bei der Website-Synchronisierung
Wenn Sie Inhalte synchronisieren, können Sie verschiedene Status sehen, die anzeigen, was während des Prozesses passiert ist. Um Ihren Website-Synchronisierungsstatus zu sehen, gehen Sie zu Fin AI Agent > Train > Content und wählen Sie die Website-Quelle aus, dann verwenden Sie das Dropdown-Menü Status , um zu filtern nach:
Synchronisierung läuft
Live
Fehlgeschlagen
Ausgeschlossen
Das bedeutet jeder Status und was Sie als Nächstes tun können:
Synchronisierung läuft
Die Seitensynchronisierung ist noch im Gange. Eine erste Synchronisierung kann je nach Inhalt von wenigen Minuten bis über eine Stunde dauern.
Live
Die Seite wurde erfolgreich synchronisiert und kann für Fin und Copilot aktiviert werden.
Hinweis: Eine erfolgreiche Synchronisierung bedeutet nicht immer, dass wir alle Inhalte der Seite erfassen konnten. Wenn Sie die vollständige Abdeckung bestätigen möchten, empfehlen wir, Fin mit den erwarteten Antworten von dieser Seite vorzuschauen.
Ausgeschlossen
Diese Seiten werden absichtlich nicht synchronisiert, weil Sie sie in Ihren Synchronisierungseinstellungen ausgeschlossen haben. Sie können nicht erneut versucht oder eingeschlossen werden, sofern nicht anders angegeben.
Fehlgeschlagen
Diese Fehler bedeuten, dass die Synchronisierung nicht abgeschlossen wurde und möglicherweise Änderungen auf Ihrer Seite erfordern, bevor Sie es erneut versuchen:
1. Unbekannter Fehler
Nachricht: „Auf diese Seite konnte nicht zugegriffen werden. Sie ist möglicherweise langsam oder blockiert. Versuchen Sie es erneut zu synchronisieren oder kontaktieren Sie den Support, wenn es fehlschlägt.“
Bedeutung: Etwas hat uns daran gehindert, auf die Seite zuzugreifen, aber die Ursache ist unklar.
2. Sitzung blockiert / Rate begrenzt
Nachricht: „Die Website verhindert, dass wir auf ihre Inhalte zugreifen. Prüfen Sie, ob sie durch eine Anti-Crawler-Einstellung oder Firewall blockiert wird. Überprüfen Sie Ihre Website-Konfiguration und versuchen Sie es erneut. Wenn das Problem weiterhin besteht, kontaktieren Sie den Support.“
Bedeutung: Ihre Website blockiert oder begrenzt unseren Crawler aktiv.
3. Netzwerk-, Zeitüberschreitungs- oder ähnliche Fehler
Nachricht: „Diese Seite konnte nicht aufgerufen werden. Sie lädt möglicherweise langsam oder wird durch Anti-Crawler-Einstellungen oder eine Firewall blockiert. Überprüfen Sie Ihre Site-Konfiguration und versuchen Sie erneut zu synchronisieren. Wenn das Problem weiterhin besteht, kontaktieren Sie den Support.“
Was es bedeutet: Die Seite wurde nicht rechtzeitig geladen oder konnte aufgrund von Netzwerkproblemen oder Blockierungen nicht erreicht werden.
4. Duplikat
Nachricht: „Diese Seite hat denselben Inhalt wie eine andere, die bereits synchronisiert wurde. Es wird nur eine Version aufgenommen.“
Was es bedeutet: Wir haben identischen Inhalt an anderer Stelle erkannt, daher wird nur eine Kopie behalten.
5. Schlüsselwortfilterung
Nachricht: „Seiten mit Schlüsselwörtern wie category, collection oder tag in der URL werden standardmäßig ausgeschlossen, da sie normalerweise keinen einzigartigen Inhalt enthalten. Wenn diese Seite eingeschlossen werden soll, kontaktieren Sie den Support.“
Was es bedeutet: Diese URLs stellen oft Listen dar, keine eigenständigen Inhaltsseiten.
6. Statuscode 400
Nachricht: „Seiteninhalt kann nicht gefunden werden. Überprüfen Sie, ob die URL gültig ist und die Seite ohne Probleme lädt.“
Was es bedeutet: Die URL ist möglicherweise defekt oder gibt auf Ihrer Website einen Fehler zurück.
7. Blockierte URL
Nachricht: „Diese Website domain ist vom Synchronisieren ausgeschlossen. Wenn Sie dies benötigen, kontaktieren Sie den Support.“
Was es bedeutet: Die domain ist absichtlich vom Synchronisieren ausgeschlossen.
Sie können eine fehlgeschlagene Seiten-Synchronisierung erneut versuchen, indem Sie mit der Maus über die Seite fahren, das Drei-Punkte-Menü auswählen und dann Resync wählen.
Hinweis: Website Sync unterstützt nicht das Importieren von rohen Markdown-Dateien. Für eine korrekte Formatierung und Titelerkennung müssen Sie Inhalte als gerendertes HTML bereitstellen oder als Snippet/Datei hochladen. Die Markdown-Struktur (z. B. # Überschriften) wird nicht erkannt, es sei denn, sie wird in HTML umgewandelt.