Una connessione al server SFTP (Secure File Transfer Protocol) consente di automatizzare la generazione di recensioni facendo in modo che Yext prelevi i dati degli inviti da un file sul proprio server secondo una pianificazione definita. Questo mantiene le informazioni di contatto sensibili dei clienti sulla propria infrastruttura, inviando comunque gli inviti tramite Yext.

Requisiti

Per configurare una connessione server SFTP, sono necessarie le seguenti autorizzazioni: Invia Inviti, Seleziona Modelli, Gestisci connessione SFTP e l'ambito di accesso Account completo.

Prima di poter avviare qualsiasi connessione SFTP, è necessario abilitare anche la Frequenza massima di contatti in Generazione di recensioni > Impostazioni . Questo impedisce che vengano inviati inviti duplicati allo stesso contatto tra le esecuzioni programmate. Se la Frequenza massima di contatti è disabilitata, è possibile creare una connessione, ma verrà salvata in stato disabilitato e non potrà essere eseguita finché l'impostazione non viene attivata.

Se si desidera disabilitare la Frequenza massima di contatto mentre sono presenti connessioni SFTP nel proprio account, è necessario prima disabilitare o eliminare tutte le connessioni SFTP.

Prepara il tuo file

Il file deve essere un CSV delimitato da virgole. Viene utilizzato solo il primo foglio: i fogli multipli non sono supportati. Il file deve includere tutte le colonne richieste, ID di entità validi e informazioni di contatto.

Colonne obbligatorie:

Configura una connessione

1. Vai su Recensioni > Generazione > Invia inviti.
2. In Connessione Server SFTP, fai clic Aggiungi nuova connessione.
3. Inserisci un nome per la connessione.
4. Seleziona una pianificazione per stabilire con quale frequenza Yext deve prelevare il file. Se selezioni Nessuno, la connessione deve essere eseguita manualmente.
5. Inserisci i dettagli del tuo server:
   • Indirizzo host: inserisci l'indirizzo senza il protocollo (sftp://).
   • Porta: inserisci la porta a cui connetterti. La porta predefinita per SFTP è 22.
6. Seleziona un metodo di autenticazione:
   • Autenticazione di base: inserisci nome utente e password.
   • Chiave privata SSH: inserisci il tuo nome utente e la chiave privata SSH. Sono supportate solo le chiavi RSA, non le chiavi OpenSSH. Per i server SFTP di AWS, la politica di sicurezza deve essere impostata su TransferSecurityPolicy-2018-11 o TransferSecurityPolicy-Restricted-2018-11.
7. Seleziona una strategia di ricerca per specificare il file da prelevare:
   • Percorso esatto del file: inserisci il percorso completo includendo il nome del file e l'estensione, ad esempio root/folder1/myfile.csv. Usalo quando il nome del file è stabile.
   • Cerca per criteri: usa questa opzione quando il nome del file cambia, ad esempio quando include una data. Specifica il percorso della cartella e filtra opzionalmente per nome file usando inizia con, finisce con, contiene o regex. Imposta Ultima modifica su "Più recente" o "Più vecchio" per determinare quale file corrispondente utilizzare.
8. Fai clic su salva.

Gestisci le connessioni esistenti

Accedi a Recensioni > Generazione > Invia inviti e fai clic su Gestisci connessioni sotto Connessione server SFTP per visualizzare tutte le connessioni esistenti. Per ogni connessione puoi eseguire le seguenti operazioni:

• Visualizza: visualizza le impostazioni di configurazione e i registri di connessione.
• Modifica: aggiorna le impostazioni di configurazione.
• Esegui ora: avvia immediatamente.
• Abilita o disabilita: metti in pausa o riprendi la connessione.
• Elimina: rimuovi definitivamente la connessione.

Visualizza i registri delle connessioni

Fai clic su Visualizza accanto a una connessione e seleziona la scheda Registri per vedere la cronologia di tutte le esecuzioni, inclusi data e ora, stato, numero di inviti inviati e numero di errori. Fai clic su Scarica dettagli su qualsiasi voce del registro per visualizzare quali righe sono state elaborate correttamente e quali no.

Nota: per soddisfare i requisiti del GDPR, i log vengono cancellati dopo 60 giorni. Se HIPAA è abilitato sul tuo account, i dettagli del log non possono essere scaricati.