Eine SFTP-Serververbindung (Secure File Transfer Protocol) ermöglicht die Automatisierung der Bewertungsgenerierung, indem Yext die Einladungsdaten nach einem von Ihnen festgelegten Zeitplan aus einer Datei auf Ihrem eigenen Server abruft. So bleiben sensible Kundenkontaktdaten in Ihrer Infrastruktur, während Einladungen weiterhin über Yext versendet werden.

Anforderungen

Um eine SFTP-Serververbindung einzurichten, benötigen Sie folgende Berechtigungen: Einladungen senden, Vorlagen auswählen, SFTP-Verbindung verwalten und den Zugriffsbereich Vollständiges Konto.

Maximale Kontaktfrequenz muss ebenfalls in Bewertungen > Generierung > Einstellungen aktiviert sein, bevor Sie SFTP-Verbindungen ausführen können. Dadurch wird verhindert, dass bei geplanten Versandreihen doppelte Einladungen an denselben Kontakt gesendet werden. Wenn die maximale Kontaktfrequenz deaktiviert ist, können Sie eine Verbindung erstellen, diese wird jedoch in einem deaktivierten Zustand gespeichert und kann nicht ausgeführt werden, bis die Einstellung aktiviert ist.

Wenn Sie die maximale Kontaktfrequenz deaktivieren möchten, während in Ihrem Konto SFTP-Verbindungen bestehen, müssen Sie zuerst alle SFTP-Verbindungen deaktivieren oder löschen.

Vorbereiten Ihrer Datei

Ihre Datei muss eine durch Kommas getrennte CSV-Datei sein. Es wird nur das erste Tabellenblatt verwendet – mehrere Tabellenblätter werden nicht unterstützt. Die Datei muss alle erforderlichen Spalten sowie gültige Entitäts-IDs und Kontaktinformationen enthalten.

Erforderliche Spalten:

Eine Verbindung einrichten

1. Navigieren Sie zu Bewertungen > Generierung > Einladungen verschicken.
2. Unter SFTP-Serververbindung klicken Sie auf Neue Verbindung.
3. Geben Sie einen Namen für die Verbindung ein.
4. Wählen Sie einen Zeitplan aus, wie oft Yext die Datei abholen soll. Wenn Sie Keine auswählen, muss die Verbindung manuell ausgeführt werden.
5. Geben Sie Ihre Serverdetails ein:
   • Host-Adresse: Geben Sie die Adresse ohne das Protokoll ein (sftp://)
   • Port: Geben Sie den Port ein, mit dem eine Verbindung hergestellt werden soll. Der Standardport für SFTP ist 22.
6. Wählen Sie eine Authentifizierungsmethode aus:
   • Basisauthentifizierung: Geben Sie Ihren Benutzernamen und Ihr Passwort ein.
   • SSH-Privatschlüssel: Geben Sie Ihren Benutzernamen und Ihren SSH-Privatschlüssel ein. Es werden nur RSA-Schlüssel unterstützt, keine OpenSSH-Schlüssel. Für AWS SFTP-Server muss die Sicherheitsrichtlinie auf TransferSecurityPolicy-2018-11 oder TransferSecurityPolicy-Restricted-2018-11 eingestellt sein.
7. Wählen Sie eine Suchstrategie, um anzugeben, welche Datei ausgewählt werden soll:
   • Exakter Dateipfad: Geben Sie den vollständigen Pfad einschließlich Dateiname und Dateierweiterung ein, z. B. root/folder1/myfile.csv. Verwenden Sie dies, wenn der Dateiname unverändert bleibt.
   • Suche nach Kriterien: Verwenden Sie diese Option, wenn sich der Dateiname ändert, zum Beispiel wenn ein Datum enthalten ist. Geben Sie den Ordnerpfad an und filtern Sie optional nach Dateinamen mit „beginnt mit“, „endet mit“, „enthält“ oder „Regex“. Legen Sie Letzte Änderung auf Neueste oder Älteste fest, um zu bestimmen, welche passende Datei verwendet werden soll.
8. Klicken Sie auf Speichern.

Bestehende Verbindungen verwalten

Navigieren Sie zu Bewertungen > Generierung > Einladungen senden und klicken Sie unter SFTP-Serververbindung auf Verbindungen verwalten, um alle bestehenden Verbindungen anzuzeigen. Für jede Verbindung können Sie Folgendes tun:

• Anzeigen: Konfigurationseinstellungen und Verbindungsprotokolle einsehen
• Bearbeiten: Konfigurationseinstellungen aktualisieren
• Jetzt ausführen: Sofortige Ausführung auslösen
• Aktivieren oder Deaktivieren: Verbindung pausieren oder fortsetzen
• Löschen: Verbindung dauerhaft entfernen

Verbindungsprotokolle anzeigen

Klicken Sie auf Anzeigen neben einer Verbindung und wählen Sie den Tab Protokolle, um einen Historie aller Durchläufe anzuzeigen, einschließlich Datum und Uhrzeit, Status, Anzahl der gesendeten Einladungen und Anzahl der Fehlschläge. Klicken Sie bei einem beliebigen Protokolleintrag auf Details herunterladen, um zu sehen, welche Zeilen erfolgreich waren und welche fehlgeschlagen sind.

Hinweis: Um die DSGVO-Anforderungen zu erfüllen, werden Protokolle nach 60 Tagen gelöscht. Wenn HIPAA auf Ihrem Konto aktiviert ist, können die Logdaten nicht heruntergeladen werden.