Unterhaltungen aus jedem Tool senden
Wenn dein Support-Tool keines der Tools ist, mit denen Ferndesk verbunden ist, veröffentliche deine Unterhaltungen als JSON unter einer URL und verbinde sie als Support-Endpunkt. Fern liest sie wie jedes andere Support-Tool aus, um Fragen zu finden, die in deiner Dokumentation fehlen. Deine Support-Tools als Quelle verwenden erklärt, was Fern damit macht.
Ferndesk ruft Daten von deiner URL ab: Es sendet eine GET-Anfrage und schreibt niemals Daten zurück. Ein Inhaber oder Admin verbindet das Tool unter Integrationen im Bereich Helpdesks, indem er die Adresse als Quell-URL einfügt. Zum Verbinden ist ein aktives Abonnement oder ein Testzeitraum erforderlich.
Die Anfrage
GET https://example.com/support-endpoint.json?token=YOUR_SECRET&startDate=2026-11-20T02:00:00.000Z&limit=500Ferndesk übernimmt alle Abfrageparameter, die bereits in deiner URL enthalten sind, und fügt Folgendes hinzu:
Parameter | Bedeutung |
|---|---|
| Unterhaltungen mit Aktivitäten ab diesem Zeitpunkt zurückgeben. Ein UTC-Zeitstempel im ISO-8601-Format. Ferndesk filtert die Datumsangaben nicht selbst, daher muss dein Endpunkt das übernehmen. |
| Die maximale Anzahl an Unterhaltungen, die zurückgegeben werden. Bei täglichen Synchronisierungen werden 500 gesendet. Wenn Ferndesk die URL beim Verbinden prüft, wird 1 gesendet. |
Ferndesk sendet keine Zugangsdaten. Um den Endpunkt zu schützen, füge ein langes Geheimnis in die Abfrageparameter der URL ein und überprüfe es auf deiner Seite.
Die URL muss zu einer öffentlichen Adresse aufgelöst werden. Weiterleitungen werden bis zu fünfmal verfolgt.
Es gibt keine Seiten: Jede Synchronisierung besteht aus einer Anfrage. Gib die neuesten Unterhaltungen zuerst zurück, da Ferndesk nur die ersten
limitUnterhaltungen übernimmt.Die Antwort darf bis zu 25 MB groß sein.
Die Antwort
{
"conversations": [
{
"id": "conv_1042",
"url": "https://support.example.com/conversations/1042",
"lastMessageAt": "2026-11-20T14:32:00Z",
"messages": [
{
"id": 1,
"role": "user",
"content": "How do I export my invoices?",
"createdAt": "2026-11-20T14:05:00Z"
},
{
"id": 2,
"role": "support_agent",
"content": "<p>Go to Billing and choose Export.</p>",
"createdAt": "2026-11-20T14:32:00Z"
}
]
}
]
}Feld | Regeln |
|---|---|
| Erforderlich. Eine nicht leere Zeichenfolge, die bei allen Synchronisierungen gleich bleibt. |
| Optional. Eine absolute URL zur Unterhaltung in deinem Tool. |
| Erforderlich. ISO 8601 mit Zeitzone, z. B. |
| Erforderlich. Eine nicht leere Zeichenfolge oder eine ganze Zahl ab 1. |
|
|
| Erforderlich. Einfacher Text oder einfaches HTML. Andere Tags werden entfernt. |
| Erforderlich. ISO 8601 mit Zeitzone. |
Wenn eine Unterhaltung gegen diese Regeln verstößt, schlägt die gesamte Antwort fehl. Überprüfe sie daher, bevor du sie zurückgibst. Um ein Problem auf deiner Seite zu melden, gib eine Zeichenfolge auf oberster Ebene mit dem Schlüssel "error" zurück: Ferndesk behandelt die Synchronisierung dann als fehlgeschlagen.
Wenn Ferndesk synchronisiert
Direkt nach dem Verbinden prüft Ferndesk die URL mit
limit=1und einem Timeout von 10 Sekunden. Wenn die Anfrage fehlschlägt oder das JSON nicht dem erwarteten Format entspricht, wird die Verbindung nicht gespeichert.Bei der ersten Synchronisierung werden die letzten 90 Tage abgefragt. Danach synchronisiert Ferndesk einmal täglich und fragt Unterhaltungen seit der letzten erfolgreichen Synchronisierung ab.
Eine fehlgeschlagene Synchronisierung wird einmal wiederholt.
Importierte Unterhaltungen werden unter Berichte > Themen nach Thema gruppiert angezeigt. Dokumentationslücken erkennen und jeden Monat schließen erklärt, was du damit tun kannst.