Una conexión de servidor SFTP (Secure File Transfer Protocol) le permite automatizar la generación de comentarios haciendo que Yext recoja los datos de invitación de un archivo en su propio servidor según una programación que usted defina. Esto mantiene la información sensible de contacto de los clientes en su infraestructura mientras sigue enviando invitaciones a través de Yext.
Requisitos
Para configurar una conexión de servidor SFTP, necesita los siguientes permisos: Enviar invitaciones, Seleccionar plantillas, Gestionar la conexión SFTP y acceso total a la cuenta.
La frecuencia máxima de contacto también debe estar activada en Comentarios > Generación > Configuración antes de poder ejecutar cualquier conexión SFTP. Esto evita que se envíen invitaciones duplicadas al mismo contacto entre las ejecuciones programadas. Si la frecuencia máxima de contacto está desactivada, puede crear una conexión, pero se guardará en un estado desactivado y no podrá ejecutarse hasta que la configuración se active.
Si desea desactivar la frecuencia máxima de contacto mientras existen conexiones SFTP en su cuenta, primero debe desactivar o eliminar todas las conexiones SFTP.
Prepare su archivo
Su archivo debe ser un CSV delimitado por comas. Solo se utiliza la primera hoja — no se admiten múltiples hojas. El archivo debe incluir todas las columnas obligatorias y los ID de entidad válidos e información de contacto válida.
Columnas obligatorias:
| Columna | Descripción |
|---|---|
entityId |
Identificador de la entidad del local que se va a revisar. |
firstName |
Nombre del contacto |
lastName |
Apellido del contacto |
Contacto |
Dirección de correo electrónico o número de teléfono del contacto (no ambos) |
Establecer una conexión
- Vaya a Comentarios > Generación > Enviar invitaciones.
- En Conexión a un servidor SFTP, haga clic en Añadir nueva conexión.
- Introduce un nombre para la conexión.
- Seleccione una programación para indicar con qué frecuencia Yext debe recoger el archivo. Si selecciona Ninguno, la conexión deberá ejecutarse manualmente.
- Introduzca los datos de su servidor:
- Dirección del host: introduzca la dirección sin el protocolo (sftp://)
- Puerto: introduzca el puerto al que conectarse. El puerto predeterminado para SFTP es 22.
- Seleccione un método de autenticación:
- Autenticación básica: introduzca su nombre de usuario y contraseña
- Clave privada SSH: introduzca su nombre de usuario y clave privada SSH. Solo se admiten las claves RSA, no las claves OpenSSH. Para los servidores SFTP de AWS, la política de seguridad debe estar establecida en TransferSecurityPolicy-2018-11 o TransferSecurityPolicy-Restricted-2018-11.
- Seleccione una estrategia de búsqueda para especificar qué archivo elegir:
- Ruta exacta del archivo: introduzca la ruta completa, incluidos el nombre y la extensión del archivo, por ejemplo, root/folder1/myfile.csv. Use esto cuando el nombre de archivo es estable.
- Búsqueda por criterios: úselo cuando el nombre del archivo cambia, por ejemplo cuando incluya una fecha. Especifique la ruta de la carpeta y, opcionalmente, filtre por nombre de archivo usando comienza con, termina con, contiene o regex. Defina la última modificación como la más reciente o la más antigua para determinar qué archivo coincidente utilizar.
- Haz clic en Guardar.
Gestionar conexiones existentes
Vaya a Comentarios > Generación > Enviar invitaciones y haga clic en Gestionar conexiones en Conexión al servidor SFTP para ver todas las conexiones existentes. Para cada conexión puede hacer lo siguiente:
- Ver: consulte los ajustes de configuración y los registros de conexión
- Editar: actualice cualquier ajuste de configuración
- Ejecutar ahora: active una ejecución inmediata
- Activar o desactivar: pause o reanude la conexión
- Eliminar: eliminar permanentemente la conexión
Ver Los Registros De Conexión
Haga clic en Ver junto a una conexión y seleccione la pestaña Registros para ver un historial de todas las ejecuciones, incluyendo la fecha y la hora, el estado, el número de invitaciones enviadas y el número de fallos. Haga clic en Descargar detalles en cualquier entrada de registro para ver qué filas tuvieron éxito y cuáles fallaron.
Nota: Para cumplir con los requisitos del RGPD, los registros se eliminan a los 60 días. Si HIPAA está activada en tu cuenta, no se pueden descargar los datos de registro.