Zum Hauptinhalt springen
Connic

Zendesk Help Center

Von Connic
Automatischer Sync

Halte Artikel aus dem Zendesk Help Center für Agenten synchron

Zendesk Help Center verbindenSprich mit Sales
Publisher
Von Connic
Synchronisiert
Artikel, Übersetzungen, Labels und Abschnitte
Einrichtung
Retrieval → Sources
Dokumentation
Retrieval-Docs

So funktioniert die Zendesk Help Center Source

Support-Teams pflegen ihre besten Antworten im Zendesk Help Center. Die Zendesk-Quelle überträgt diese Artikel in das Connic-Retrieval, damit Support- und Backoffice-Agenten aus dem veröffentlichten Artikel antworten, statt ihn sinngemäß wiederzugeben.

Die Verbindung verwendet die Zendesk-Subdomain und die zu synchronisierenden Sprachen. Artikel werden über die Help Center API gelesen statt über die gerenderte Website. Eigene Domains und ein Bot-Schutz vor dem Help Center stehen der Synchronisierung daher nicht im Weg. Öffentliche Help Center benötigen keine Zugangsdaten; mit der E-Mail eines Agenten und einem API Token kommen Artikel hinzu, die nur angemeldeten Nutzern angezeigt werden. Jeder Artikel wird pro Sprache zu einem eigenen Eintrag und nach dem festgelegten Zeitplan aktualisiert.

Das wird synchronisiert

Artikel
Veröffentlichte Artikelinhalte werden vor dem Chunking in bereinigten Text umgewandelt. Entwürfe werden übersprungen.
Übersetzungen
Jede konfigurierte Sprache wird separat synchronisiert, damit Agenten in der Sprache des Kunden antworten können.
Labels und Abschnitte
Labels, Abschnitt und Sprache eines Artikels bleiben in den Metadaten des Eintrags erhalten, damit das Retrieval gefiltert werden kann.
Zendesk Help CenterActiveHelp center
Configuration
Sync behavior
Target namespacesources.zendesk
Sync intervalDaily
When content is deleted at the sourceRemove it from the retrieval
Recent syncsSync now
  • CompletedOct 13, 09:00 AM
    4 new · 11 updated · 1 removed
  • CompletedManualOct 12, 09:00 PM
    0 new · 2 updated · 0 removed
  • CompletedOct 12, 09:00 AM
    0 new · 6 updated · 0 removed

Zendesk Help Center Source einrichten

Füge die Source unter Retrieval → Sources im Environment hinzu, in dem deine Agenten laufen. Jedes Environment hat eigene Sources.

  1. Gib die Zendesk-Subdomain ein, z. B. example für example.zendesk.com. Help Center mit eigener Domain verwenden ebenfalls diese Subdomain.

  2. Gib die zu synchronisierenden Sprachen des Help Centers an, z. B. en-us, de.

  3. Lass E-Mail und API Token bei einem öffentlichen Help Center leer.

  4. Für Artikel, die nur angemeldeten Nutzern angezeigt werden, erstelle im Admin Center unter Apps und Integrationen → APIs ein API Token und gib es zusammen mit der E-Mail eines Agenten ein, der diese Artikel sehen kann.

  5. Optional lässt sich die Synchronisierung auf Kategorie- oder Abschnitts-IDs begrenzen. Die IDs stehen in der URL der jeweiligen Kategorie- oder Abschnittsseite.

Konfiguration im Detail

Alle Einstellungen zum Verbinden von Zendesk Help Center mit einem Projekt.

Verbindung

Subdomain*
Die Zendesk-Subdomain oder ihre zendesk.com URL.
Agenten-E-Mail
Optional. E-Mail des Agenten, zu dem das API Token gehört. Bei einem öffentlichen Help Center leer lassen.
API Token
Optional. Zendesk API Token. Die Synchronisierung liest nur Artikel, die dieser Agent sehen kann.

Inhaltsumfang

Sprachen*
Durch Kommas getrennte Sprachen des Help Centers, die synchronisiert werden.
Kategorie-IDs
Synchronisiere nur Artikel in diesen Kategorien, durch Kommas getrennt. Lass das Feld leer, um das gesamte Help Center zu synchronisieren.
Abschnitts-IDs
Synchronisiere nur Artikel in diesen Abschnitten, durch Kommas getrennt. Wird mit den Kategorie-IDs kombiniert.

Synchronisierungsverhalten

Wo synchronisierte Inhalte abgelegt werden und wie häufig sie aktualisiert werden.

Ziel-Namespace
Der Retrieval-Namespace legt fest, unter welchem Namen die synchronisierten Einträge abgelegt werden. Verwende Punkte für Verschachtelungen, z. B. sources.zendesk.
Synchronisierungsintervall
Wie häufig die Quelle auf Änderungen geprüft wird. Bei jedem Lauf werden nur geänderte Inhalte erneut verarbeitet.
Wenn Inhalte an der Quelle gelöscht werden
In Zendesk gelöschte, zurückgezogene oder aus dem Umfang entfernte Artikel können bei der nächsten Synchronisierung aus dem Retrieval entfernt oder in der zuletzt synchronisierten Version beibehalten werden.

Aus einem Agenten durchsuchen

Agenten durchsuchen synchronisierte Inhalte mit dem Tool retrieval_query. Ein kleines Tool, das den Namespace festlegt, beschränkt einen Agenten auf diese Source.

tools/knowledge.py
from connic.tools import retrieval_query


async def search_zendesk(question: str) -> dict:
    return await retrieval_query(
        question, namespace="sources.zendesk"
    )
agents/support-agent.yaml
version: "1.0"

name: support-agent
type: llm
model: connic/gemini-3.7-flash
system_prompt: |
  Answer only from what search_zendesk returns.
tools:
  - knowledge.search_zendesk

Zendesk Help Center Retrieval Source FAQ

Nein. Sie liest Artikel über die Zendesk Help Center API. Die Synchronisierung funktioniert daher auch für Help Center mit eigener Domain oder hinter einem Bot-Schutz, der Crawler blockiert.

Nicht für ein öffentliches Help Center. Für Artikel, die nur angemeldeten Nutzern oder bestimmten Nutzersegmenten angezeigt werden, sind die E-Mail und das API Token eines Agenten nötig, der sie sehen kann. Die Synchronisierung liest nur und schreibt nie nach Zendesk zurück.

Ja. Mit Kategorie- oder Abschnitts-IDs werden nur diese Artikel synchronisiert, und es lassen sich nur die Sprachen angeben, die Agenten benötigen.

Jede konfigurierte Sprache wird pro Artikel als eigener Eintrag synchronisiert. Die Sprache steht in den Metadaten, sodass sich eine Abfrage auf eine Sprache filtern lässt.

Weitere Retrieval Sources

Zum Marketplace