Une connexion au serveur SFTP (Secure File Transfer Protocol) automatise la génération d'avis en laissant Yext récupérer les données d'invitation depuis un fichier sur votre propre serveur, selon une fréquence que vous déterminez. Cela permet de conserver les informations sensibles des clients sur votre infrastructure tout en envoyant des invitations via Yext.
Exigences
Pour configurer une connexion serveur SFTP, vous avez besoin des autorisations suivantes : Envoyer des invitations, Sélectionner des modèles, Gérer la connexion SFTP et un périmètre d'accès Compte complet.
L'option Fréquence de contact maximale doit également être activée dans Avis > Génération > Paramètres avant que vous puissiez exécuter des connexions SFTP. Cela évite que des invitations en double soient envoyées au même contact lors des exécutions programmées. Si l'option Fréquence de contact maximale est désactivée, vous pouvez créer une connexion, mais elle sera sauvegardée dans un état désactivé et ne pourra pas être exécutée jusqu'à ce que le paramètre soit activé.
Si vous souhaitez désactiver l'option Fréquence de contact maximale tant que des connexions SFTP existent dans votre compte, vous devez d'abord désactiver ou supprimer toutes les connexions SFTP.
Préparer votre fichier
Votre fichier doit être un fichier CSV séparé par des virgules. Seule la première feuille est utilisée, le format multifeuilles n'est pas pris en charge. Le fichier doit inclure toutes les colonnes requises ainsi que des identifiants d'entité et des coordonnées valides.
Colonnes obligatoires :
| Colonne | Description |
|---|---|
entityId |
Identifiant d'entité de l'établissement à évaluer |
Prénom |
Prénom du contact |
Nom |
Nom du contact |
contact |
Adresse e-mail ou numéro de téléphone d'un contact (pas les deux) |
Configurer une connexion
- Accédez à Avis > Génération > Envoyer des invitations.
- Sous Connexion au serveur SFTP, cliquez sur Ajouter une nouvelle connexion.
- Saisissez le nom de la connexion.
- Sélectionner un planning pour déterminer à quelle fréquence Yext doit récupérer le fichier. Si vous sélectionnez Aucun, la connexion doit être exécutée manuellement.
- Entrez les détails de votre serveur :
- Adresse de l'hôte : entrez l'adresse sans le protocole (sftp://)
- Port : saisissez le port auquel vous connecter. Le port par défaut pour SFTP est le 22.
- Sélectionnez une méthode d'authentification :
- Authentification de base : entrez votre nom d'utilisateur et votre mot de passe
- Clé privée SSH : entrez votre nom d'utilisateur et votre clé privée SSH. Seules les clés RSA sont prises en charge, au contraire des clés OpenSSH. Pour les serveurs SFTP AWS, la politique de sécurité doit être définie sur TransferSecurityPolicy-2018-11 ou TransferSecurityPolicy-Restricted-2018-11.
- Sélectionnez une stratégie de recherche pour spécifier le fichier à récupérer :
- Chemin d'accès exact du fichier : saisissez le chemin complet, y compris le nom du fichier et son extension, par exemple root/folder1/myfile.csv. Utilisez cette option lorsque le nom du fichier est stable.
- Recherche par critères : utilisez cette option lorsque le nom du fichier change, par exemple lorsqu'il comporte une date. Indiquez le chemin d'accès au dossier et filtrez par nom de fichier si vous le souhaitez en utilisant commence par, se termine par, contient ou regex. Définissez le paramètre Dernière modification sur Plus récent ou Plus ancien pour déterminer le fichier correspondant à utiliser.
- Cliquez sur Sauvegarder.
Gérer les connexions existantes
Accédez à Avis > Génération > Envoyer des invitations et cliquez sur Gérer les connexions sous Connexion au serveur SFTP pour afficher toutes les connexions existantes. Pour chaque connexion, vous pouvez effectuer les actions suivantes :
- Afficher : consulter les paramètres de configuration et les journaux de connexion
- Modifier : mettre à jour les paramètres de configuration
- Exécuter : déclencher une exécution immédiate
- Activer ou Désactiver : mettre en pause ou reprendre la connexion
- Supprimer : supprimer définitivement la connexion
Afficher les journaux de connexion
Cliquez sur Afficher à côté d'une connexion et sélectionnez l'onglet Journaux pour voir l'historique de toutes les exécutions, incluant la date et l'heure, le statut, le nombre d'invitations envoyées et le nombre d'échecs. Cliquez sur Télécharger les détails sur n'importe quelle entrée du journal pour voir quelles lignes ont réussi et lesquelles ont échoué.
Remarque : pour répondre aux exigences du RGPD, les journaux sont supprimés au bout de 60 jours. Si HIPAA est activé sur votre compte, les détails du journal ne peuvent pas être téléchargés.