Připojení k serveru SFTP (Secure File Transfer Protocol) umožňuje automatizovat generování recenzí tím, že Yext načítá data pozvánek ze souboru na vašem vlastním serveru podle vámi definovaného harmonogramu. Díky tomu se citlivé kontaktní informace zákazníků uchovávají ve vaší infrastruktuře a zároveň se pozvánky i nadále posílají přes Yext.
Požadavky
Pro nastavení připojení k serveru SFTP potřebujete následující oprávnění: odesílat pozvánky, vybírat šablony, spravovat připojení SFTP a úplný rozsah přístupu k účtu.
V části Reviews > Generování > Nastavení musí být před spuštěním jakéhooliv připojení SFTP povolena Maximální frekvence kontaktu. Tím se zabrání odesílání duplicitních pozvánek stejnému kontaktu napříč naplánovanými spuštěními. Pokud je maximální frekvence kontaktu zakázána, můžete připojení vytvořit. To se ale uloží ve vypnutém stavu a nebude možné jej spustit, dokud nebude nastavení povoleno.
Pokud chcete zakázat Maximální frekvenci kontaktu ve chvíli, kdy je ve vašem účtu připojení SFTP, musíte nejprve zakázat nebo odstranit všechna připojení SFTP.
Příprav souboru
Váš soubor musí být ve formátu CSV odděleném čárkami. Používá se pouze první list, více listů není podporováno. Soubor musí obsahovat všechny požadované sloupce a platná ID subjektu a kontaktní informace.
Povinné sloupce:
| Sloupec | Popis |
|---|---|
entityId |
ID subjektu místa, které má být recenzováno |
firstName |
Křestní jméno kontaktu |
lastName |
Příjmení kontaktu |
Kontakt |
E-mailová adresa nebo telefonní číslo kontaktu (ne obojí) |
Nastavení připojení
- Přejděte na možnosti Reviews > Generování > Odeslat pozvánky.
- V sekci SFTP Server Connection klikněte na Přidat nové připojení.
- Zadejte název připojení.
- Vyberte harmonogram, jak často má Yext soubor načítat. Pokud zvolíte žádný, připojení je nutné spustit ručně.
- Zadejte údaje o svém serveru:
- Adresa hostitele: zadejte adresu bez protokolu (sftp://)
- Port: zadejte port, ke kterému se chcete připojit. Výchozí port pro SFTP je 22.
- Vyberte metodu ověřování:
- Základní ověřování: zadejte své uživatelské jméno a heslo
- Soukromý klíč SSH: zadejte své uživatelské jméno a soukromý klíč SSH Podporovány jsou pouze klíče RSA, nikoli klíče OpenSSH. Pro servery AWS SFTP musí být bezpečnostní zásady nastaveny na TransferSecurityPolicy-2018-11 nebo TransferSecurityPolicy-Restricted-2018-11.
- Vyberte strategii vyhledávání, abyste určili, který soubor se má načíst:
- Přesná cesta k souboru: zadejte úplnou cestu včetně názvu souboru a přípony, například root/folder1/myfile.csv. Tuto možnosti použijte, pokud je název souboru stabilní.
- Hledat podle kritérií: tuto možnost použijte, pokud se název souboru mění, například pokud obsahuje datum. Zadejte cestu ke složce a volitelně filtrujte podle názvu souboru pomocí parametrů začíná na, končí na, obsahuje nebo pomocí regulárního výrazu. Pro určení toho, který soubor se má použít, nastavte pole Naposledy upraveno na nejnovější nebo nejstarší.
- Klikněte na tlačítko Uložit.
Správa existujících připojení
Přejděte do Reviews > Generování > Odeslat pozvánky a kliknutím na možnost Spravovat připojení v části Připojení k serveru SFTP zobrazte všechna existující připojení. U každého připojení můžete provést následující:
- Zobrazení: zobrazení nastavení konfigurace a protokolů připojení
- Úprava: aktualizovat všechna nastavení konfigurace
- Spustit nyní: vyvolá okamžité spuštění
- Povolit nebo Zakázat: pozastavit nebo obnovit připojení
- Smazat: trvale odebrat připojení
Zobrazení protokolů připojení
Klikněte na Zobrazit vedle připojení a vyberte kartu Protokoly. Zobrazí se historie všech spuštění, včetně data a času, stavu, počtu odeslaných pozvánek a počtu selhání. Kliknutím na možnost Stáhnout podrobnosti u libovolného záznamu v protokolu zjistíte, které řádky byly úspěšné a které selhaly.
Poznámka: Pro splnění požadavků směrnice GDPR se protokoly mažou po 60 dnech. Pokud je na Vašem účtu povoleno HIPAA, nelze stáhnout podrobnosti protokolů.