Benutzerdefinierter Support-Endpunkt

Übersicht

Dieser Artikel erklärt, wie Sie einen benutzerdefinierten Support-Endpunkt mit Ferndesk verbinden können. Mit dieser Funktion können Sie Ihr eigenes Ticket- oder Support-System integrieren, auch wenn es nicht nativ von Ferndesk unterstützt wird.

Voraussetzungen

• Sie müssen über eine öffentlich zugängliche URL verfügen, die eine JSON-Antwort zurückgibt.

• Sie müssen über die Berechtigungen zur Verwaltung von Integrationen in Ferndesk verfügen.

Schritte

1. Navigieren Sie in Ihren Ferndesk-Einstellungen zur Seite Integrations.

2. Klicken Sie auf die Schaltfläche „Add Integration“. Dies führt Sie zur Seite Connect an integration.

3. Wählen Sie „Support Endpoint“ aus der Liste der verfügbaren Integrationen aus.

4. Im Konfigurationsdialog sehen Sie ein Feld mit der Bezeichnung „Source URL“.

5. Geben Sie die URL Ihres benutzerdefinierten Support-Endpunkts ein. Der Platzhaltertext für dieses Feld lautet https://company.com/support-endpoint.json?startDate=2025-01-01.

6. Klicken Sie auf die Schaltfläche „Save“, um den Endpunkt zu verbinden.

Einrichtung überprüfen

Sobald Sie das Monitoring aktiviert haben, können Sie die korrekte Funktion überprüfen, indem Sie ein Audit erstellen. Wenn die Verbindung erfolgreich ist, sollten Konversationen aus Ihrem benutzerdefinierten Support-System im Audit erscheinen.

JSON-Format

Der benutzerdefinierte Support-Endpunkt muss eine JSON-Antwort in einem spezifischen Format zurückgeben. Das Root-Objekt sollte einen Schlüssel conversations enthalten, der ein Array von Konversationsobjekten hält. Jedes Konversationsobjekt muss eine id, einen lastMessageAt-Zeitstempel und ein Array von messages besitzen. Jedes Nachrichtenobjekt innerhalb des Arrays sollte eine id, eine role (entweder user oder agent), einen content und einen createdAt-Zeitstempel enthalten.

Hier ist ein Beispiel für das erwartete JSON-Format:

{
  "conversations": [
    {
      "id": "conv_12345",
      "url": "https://support.mycompany.com/conversations/12345",
      "lastMessageAt": "2023-10-27T14:30:00Z",
      "messages": [
        {
          "id": "msg_67890",
          "role": "user",
          "content": "Hello, I'm having trouble with...",
          "createdAt": "2023-10-27T14:25:00Z"
        },
        {
          "id": "msg_67891",
          "role": "support_agent",
          "content": "Hi there, I can help with that. Could you please provide...",
          "createdAt": "2023-10-27T14:30:00Z"
        }
      ]
    }
  ]
}

Fehlerbehebung

• Falsches JSON-Format: Stellen Sie sicher, dass die JSON-Antwort Ihres Endpunkts dem in diesem Artikel beschriebenen Format entspricht.

• Ungültige URL: Stellen Sie sicher, dass die angegebene URL ein öffentlich zugänglicher Endpunkt ist.

• Authentifizierung: Diese Funktion unterstützt derzeit keine authentifizierten Endpunkte.