SFTP（Secure File Transfer Protocol）サーバーに接続すると、Yextは定義されたスケジュールで貴社独自のサーバーのファイルから招待データを取得するため、レビュー生成を自動化できます。これにより、顧客の機密連絡先情報をインフラに保存したまま、Yextを通じて招待状を送信することができます。
必要条件
SFTPサーバーの接続を設定するには、以下の権限が必要です：招待を送信、テンプレートを選択、SFTP接続を管理、および完全なアカウントアクセス範囲。
また、SFTP接続を実行する前に、[Reviews > 生成 > 設定] に移動して、[最大連絡頻度] を有効にする必要もあります。これにより、スケジュールされた接続で重複した招待が同じ連絡先に送信されることを防ぐことができます。「最大連絡頻度」が無効になっている場合、接続を作成できますが、無効の状態で保存され、設定が有効になるまで実行できません。
アカウントにSFTP接続が存在する状態で「最大連絡頻度」を無効にする場合は、まずすべてのSFTP接続を無効にするか、削除する必要があります。
ファイルを準備してください
ファイルはカンマ区切りのCSVである必要があります。最初のシートのみが使用され、複数のシートはサポートされません。ファイルには、必要なすべての列、有効なエンティティID、連絡先情報を含める必要があります。
必須の列：
| 列 | 説明 |
|---|---|
entityId |
レビューされる場所のエンティティID |
firstName |
連絡先の名 |
lastName |
連絡先の姓 |
contact |
連絡先のメールアドレスまたは電話番号（いずれかのみ） |
接続を設定する
- [Reviews > 生成 > 招待を送信] の順に移動します。
- [SFTPサーバー接続]で、[接続を新規追加] をクリックします。
- 接続名を入力してください。
- Yextがファイルを受け取る頻度のスケジュールを選択してください。「 なし」を選択する場合は、接続は手動で実行する必要があります。
- サーバー情報を入力します。
- ホストアドレス：プロトコル（sftp：//）を付けずにアドレスを入力します
- ポート：接続するポートを入力します。SFTPのデフォルトポートは22です。
- 認証方法を選択します。
- 基本認証：ユーザー名とパスワードを入力します
- SSHプライベートキー：ユーザー名とSSHプライベートキーを入力します。RSAキーのみがサポートされます。OpenSSHキーはサポートされません。AWS SFTPサーバーの場合、セキュリティポリシーを TransferSecurityPolicy-2018-11 または TransferSecurityPolicy-Restricted-2018-11 に設定する必要があります。
- 検索戦略を選択してピックアップするファイルを指定します。
- 正確なファイルパス：ファイル名と拡張子を含むフルパスを入力します（例：root/folder1/myfile.csv）。ファイル名が安定している場合にこれを使用します。
- 条件で検索：日付が含まれている場合など、ファイル名が変更された場合に使用します。フォルダパスを指定し、オプションで「開始」、「終了」、「含む」、または「正規表現」を使用し、ファイル名で絞り込みます。[最終変更日] を「最新順」または「古い順」に設定して使用する一致ファイルを決定します。
- [保存（Save）]をクリックします。
既存の接続を管理する
[Reviews > 生成 > 招待を送信] の順に移動し、[SFTPサーバー接続] の [接続を管理] をクリックして既存のすべての接続を表示します。各接続では以下を実行できます。
- 表示：構成設定と接続ログを確認します
- 編集：構成設定を更新します
- 今すぐ実行：即座に実行をトリガーします
- 有効または無効：接続を一時停止または再開します
- 削除: 接続を完全に削除します
接続ログを表示
接続の横にある [表示] をクリックし、[ログ] タブを選択すると、日時刻ステータス、送信された招待数、失敗回数など、すべての実行履歴を確認できます。成功した行や失敗した行を確認するには、ログエントリの [詳細をダウンロード] をクリックします。
注：GDPRの要件を満たすために、ログは60日後に削除されます。アカウントでHIPAAが有効になっていると、ログの詳細をダウンロードできません。