Wenn Sie Website-Inhalte in Intercom hinzufügen und dem Fin AI Agent und Copilot zur Verfügung stellen möchten, können Sie dies tun, indem Sie die öffentliche URL Ihrer Seite synchronisieren. Sie können Fin und Copilot auch mit Inhalten aus Blogbeiträgen, Changelogs, News-Updates oder anderen Webseiten mit Datumsangaben trainieren. So stellen Fin und Copilot sicher, dass sie stets die aktuellsten und relevantesten Informationen aus diesen Quellen verwenden.

Gehen Sie zu Fin AI Agent > Train > Content und wählen Sie dann unter „Add content“ Website sync aus.

Geben Sie nun die URL Ihrer externen Support-Inhalte (Top-Level domain) ein und klicken Sie auf Next:

Dies ruft alle Seiten von der von Ihnen angegebenen Website-URL ab und liest alle Seiten der Subdomain.

Sobald Sie Ihre URL eingegeben haben, prüfen wir, ob sie gültig und zugänglich ist. Danach müssen Sie die Seiten auswählen, die synchronisiert werden sollen. Alle Unterseiten, die in jedem ausgewählten Abschnitt verlinkt sind, werden synchronisiert. Wählen Sie nur relevante und aktuelle Inhalte aus.

Wählen Sie das Dropdown Advanced settings aus, um zusätzliche URLs, auszuschließende URLs, CSS-Selektoren zum Ausschließen und mehr zu konfigurieren.

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 oben als primäre URL eingeben, möchten Sie möglicherweise auch die spezifische URL wie https://myhelpcenter.com/help/index.html hinzufügen.

Um bestimmte Seiten auszuschließen, von denen Sie keine Inhalte synchronisieren möchten, können Sie eine Liste von URL-Globs hinzufügen.

Ein Glob ist eine Zeichenfolge aus Literal- und/oder Platzhalterzeichen, die verwendet wird, um Dateipfade oder URLs abzugleichen. Globbing ist der Vorgang, Dateien in einem Dateisystem mithilfe eines oder mehrerer Globs zu finden. Die Verwendung von URL-Globs hilft auch dabei, eine Reihe von URLs zu erhalten, die größtenteils gleich sind, wobei nur ein kleiner Teil zwischen den Anfragen variiert.

Beispielsweise lässt dieses URL-Glob https://{store,docs}.example.com/** den Crawler alle URLs zugreifen, die mit https://store.example.com/ oder https://docs.example.com/ beginnen, und https://example.com/**/*\?*foo=*

Um bestimmte Seitenelemente auszuschließen, können Sie CSS-Selektoren dieser speziellen 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 document.querySelectorAll()-Funktion akzeptiert wird. Standardmäßig entfernen wir bereits gängige Navigationselemente, Header, Footer, Modale, Skripte und eingebettete Bilder.

Dadurch können DOM-Elemente, die durch den CSS-Selektor identifiziert werden, während des Web-Synchronisierungsprozesses angeklickt werden.

Dies ist nützlich, um zusammengeklappte Abschnitte zu erweitern, um deren Textinhalt zu erfassen. Der Wert muss ein gültiger CSS-Selektor sein, wie er von der document.querySelectorAll() Funktion akzeptiert wird.

Beispiele sind "[aria-expanded=\"false\"]", #expand_section

Komplexe Bedingungen können auch mit einem CSS-Selektor beschrieben werden. In CSS erzeugt das Aneinanderreihen von Selektoren ohne Leerzeichen eine UND-ähnliche Bedingung, zum Beispiel wird .button.blue.small nur Elemente mit allen drei Klassen abgleichen.

Die Verwendung eines Kommas (,) als Trennzeichen funktioniert wie ODER, zum Beispiel zielt .button, .blue, h1 auf alle Elemente mit der Klasse button, oder der Klasse blue, oder Überschriften der ersten Ebene ab.

Um Inhalte anzusprechen, die möglicherweise verzögert auf der Seite erscheinen, können Sie einen CSS-Selektor hinzufügen, der den Web-Scraper vor dem Scrapen warten lässt.

Dies ist nützlich für Seiten, bei denen die standardmäßige Erkennung des Inhaltsladens durch Leerlauf des Netzwerks versagt. Wenn Sie diese Option festlegen, wird das Standardverhalten vollständig deaktiviert und die Seite wird nur verarbeitet, wenn das durch diesen Selektor angegebene Element erscheint.

Aktivieren Sie die XML-Sitemap für eine robustere Web-Synchronisierung auf Websites, die Sitemaps unterstützen, sodass auf Seiten zugegriffen werden kann, die vom initialen URLs aus möglicherweise nicht erreichbar sind.

Wenn diese Option aktiviert ist, sucht der Web-Scraper nach Sitemaps in den Domains der angegebenen Quell-URL und reiht passende URLs ähnlich wie die auf gecrawlten Seiten gefundenen Links ein. Sie können auch direkt auf eine sitemap.xml-Datei verweisen, indem Sie sie als weitere Start-URL hinzufügen, z. B. https://www.example.com/sitemap.xml.

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 die folgenden Proxys:

Wählen Sie, wie gründlich der Crawler jede Seite rendert, während diese Website synchronisiert wird.

Wenn aktiviert, ignoriert der Web-Scraper canonical-Link-Tags (rel="canonical") und behandelt jede URL als eigene Seite. Diese Option ist standardmäßig deaktiviert.

Das ist nützlich, wenn eine Site viele Seiten auf eine kanonische URL verweist und Inhalte dadurch übersehen werden.

Unter Advanced settings gibt es zwei weitere Umschalter. Beide sind standardmäßig ausgeschaltet.

Respect robots.txt: lässt den Crawler die Disallow-Regeln in der robots.txt Ihrer Site beachten. Schalten Sie es ein, um die Synchronisierung mit dem, was Sie anderen Crawlern erlauben, konsistent zu halten. Wenn robots.txt Pfade verbietet, die Inhalte enthalten, die Sie in Fin haben möchten, reduziert dies, was synchronisiert wird.

Exclude query parameters: überspringt jede URL mit einer Query-String (?). Schalten Sie es ein, wenn Ihre Site Tracking-, Session- oder Sortierparameter anhängt, die viele nahezu doppelte Seiten erzeugen. Lassen Sie es aus, wenn echter Inhalt hinter einem Query-String steht, wie /docs?page=intro — diese Seiten würden sonst ebenfalls übersprungen.

Der Target-Schritt ermöglicht es Ihnen, eine Standard-Zielgruppe 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 zuerst, 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 Standard festgelegt ist, wird der Inhalt standardmäßig auf Everyone gesetzt), oder Regeln erstellen, um bestimmte Zielgruppen basierend auf URL-Mustern zuzuweisen.

Beispiel: Wenn die URL /uk enthält, weise die UK-Zielgruppe zu. Regeln werden während des Sync ausgewertet, sodass Fin und Copilot stets den richtigen Inhalt an die richtige Zielgruppe liefern.

Jede Regel unterstützt drei URL-Vergleichsoperatoren:

Überprüfen Sie schließlich Ihre Synchronisierungseinstellungen und klicken Sie dann auf Sync website , um mit der Synchronisierung Ihrer Website-Inhalte mit Intercom zu beginnen.

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.

Gehen Sie zu Fin AI Agent > Train > Content, wählen Sie die Website-Quelle und klicken Sie dann auf eine synchronisierte Seite. Auf der rechten Seite finden Sie ein "Details"-Panel mit:

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 von Ihnen synchronisierte(n) Live-Seite(n) und wählen Sie Change AI Agent state > Enable for AI Agent oder Change Copilot state > Enable for Copilot.

Sie können diese Einstellungen auch von einer einzelnen Webseite im "Details" Bereich verwalten. Scrollen Sie zu den Fin Einstellungen und wählen Sie, ob Sie umschalten möchten:

Sie können Zielgruppen synchronisierter Inhalte automatisch mit URL-basierten Regeln während der Erstellung der Web-Synchronisierung zuweisen oder manuell pro Seite. Zuerst müssen Sie die Zielgruppe erstellen und definieren, die Sie ansprechen möchten: create and define the audience.

Um eine Zielgruppe manuell einzelnen Seiten zuzuweisen, gehen Sie zu Fin AI Agent > Train > Content, wählen Sie die Website-Quelle aus, klicken Sie auf die von Ihnen synchronisierte(n) Live-Seite(n) und wählen Sie More actions > Change Fin audience.

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 Einstellungssymbol oben rechts und wählen Sie Open settings. Navigieren Sie zum Schritt Target, um URL-basierte Regeln hinzuzufügen oder zu bearbeiten.

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. Klicken Sie dann auf das Einstellungssymbol oben rechts und wählen Sie Re-sync oder Remove this source.

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. Klicken Sie dann auf das Einstellungssymbol oben rechts und wählen Sie Open settings.

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 und wählen Sie die Website-Quelle aus, klicken Sie dann auf das Einstellungssymbol oben rechts und wählen Sie View sync history.

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:

Wenn eine Synchronisierung fehlgeschlagen ist, können Sie mit der Maus über den Status fahren, um eine detaillierte Erklärung des Grundes zu sehen.

Eine neue Quelle wird in den ersten 90 Tagen planmäßig synchronisiert. Danach wird sie automatisch weiter synchronisiert, wenn eine der folgenden Bedingungen erfüllt ist:

Andernfalls werden geplante Synchronisierungen pausiert.

Wenn pausiert: Seiten bleiben in Ihrem Knowledge Hub und bleiben Fin und Copilot verfügbar (nichts wird gelöscht). Nur das erneute Crawlen stoppt, sodass Änderungen auf Ihrer Website nicht übernommen werden.

Zum Wiederherstellen: Die Sync now-Schaltfläche aktualisiert den Inhalt einmal, startet den Zeitplan jedoch nicht neu. Die automatische Synchronisierung wird von selbst fortgesetzt, sobald Fin die Quelle wieder verwendet.

Sehr große Sites und Sites, die vollständiges JavaScript-Rendering benötigen, kosten beim Crawlen deutlich mehr. Wenn sich eine Quelle als ressourcenintensiv herausstellt, verschieben wir sie von einem wöchentlichen auf einen alle 14 Tage Zeitplan.

Dies geschieht automatisch pro Quelle. Um eine große Site in einem schnelleren Zeitplan zu halten, begrenzen Sie den Crawl, indem Sie URL-Ausschlüsse verwenden oder fügen Sie bestimmte Unterseiten hinzu, anstatt eine ganze domain.

Beim Importieren von Website-Inhalten, um Fin zu aktivieren, müssen Sie die public URL eingeben. Dadurch werden alle Seiten durchsucht, die unter dieser URL verschachtelt sind, und für Fin AI Agent synchronisiert.

Wenn der Importer nicht die erwartete Anzahl von Seiten zurückgegeben hat, gibt es mehrere Gründe...

Die Website-Synchronisierung funktioniert, indem die von Ihnen angegebene URL aufgerufen und dann alle darunter verschachtelten Seiten durchsucht werden. Diese Seiten müssen dasselbe URL-Muster wie die von Ihnen angegebene URL haben.

Zum Beispiel, wenn die oberste 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 grundlegendsten URL-Stamm, z. B. https://myhelpcenter.com, und versuchen Sie den Import erneut.

Wenn der Inhalt, den Sie verwenden möchten, hinter einer Anmeldung liegt, kann Fin nicht darauf zugreifen oder ihn importieren.

Die Website-Synchronisierung hat zwei Beschränkungen:

Eine Synchronisierung kann auch fehlschlagen, wenn eine einzelne Seite eine sehr große Menge an Inhalten enthält. Sie werden per E-Mail benachrichtigt, wenn eine Synchronisierung fehlschlägt.

Intercom’s Website-Synchronisierung (verwendet, um öffentliche URLs für Fin AI Agent und Copilot hinzuzufügen) verwendet derzeit keinen dedizierten, kundenspezifischen User-Agent-String.

Um diese Anfragen zu identifizieren oder zuzulassen:

Wenn Ihre Sitemap URLs mit nicht-ASCII-Zeichen enthält (wie Akzentbuchstaben oder Schriften wie Chinesisch oder Arabisch), werden einige dieser Seiten möglicherweise nicht wie erwartet synchronisiert. Die Sitemap-Erkennung unterstützt diese URLs jetzt, aber sie können in anderen Teilen des Synchronisierungsprozesses weiterhin Probleme verursachen. Versuchen Sie, die Synchronisierung manuell erneut auszuführen, um das Problem zu beheben. Wenn Seiten weiterhin fehlen, kontaktieren Sie den Support.

Wenn Sie Inhalte synchronisieren, können verschiedene Status angezeigt werden, die zeigen, was während des Vorgangs passiert ist. Um den Status Ihrer Website-Synchronisierung zu sehen, gehen Sie zu Fin AI Agent > Train > Content und wählen Sie die Website-Quelle aus. Verwenden Sie dann das Status -Dropdown, um zu filtern nach:

Das bedeutet jeder Status und was Sie als Nächstes tun können:

Die Seitensynchronisierung ist noch im Gange. Eine erste Synchronisierung kann je nach Inhalt wenige Minuten bis über eine Stunde dauern.

Die Seite wurde erfolgreich synchronisiert und kann für Fin und Copilot aktiviert werden.
​

Diese Seiten werden absichtlich nicht synchronisiert, weil Sie sie in Ihren Sync-Einstellungen ausgeschlossen haben. Sie sind nicht erneut versuchbar und können nicht aufgenommen werden, sofern nicht anders angegeben.

Diese Fehler bedeuten, dass die Synchronisierung nicht abgeschlossen wurde und vor einem erneuten Versuch Änderungen auf Ihrer Seite erforderlich sein können:

1. Unbekannter Fehler

2. Sitzung blockiert / Rate limiting

3. Netzwerk-, Timeout- oder ähnliche Fehler

4. Duplikat

5. Keyword-Filterung

6. Statuscode 400

7. Blockierte URL

​Sie können einen fehlgeschlagenen Seiten-Sync erneut versuchen, indem Sie über die Seite hovern, das Drei-Punkte-Menü wählen und dann Resync. auswählen.