CSV 形式でリストを作成

レコードをコンマ区切り値 (.csv) 形式でアップロードしてリストを作成します。アップロードまたはリストに追加する前に、準拠するデータを UTF-8 でエンコードされた .csv 構文にフォーマットします。

• 各レコードは、改行 (LF) または復帰改行 (CRLF) のペアで終了する 1 行です。
• 列名には、バックスラッシュ (\) などの特殊文字を含めることはできません。
• フィールドと呼ばれるデータ項目を区切るには、コンマを使用します。
• 最初の行は、コンマで区切られたフィールド名のヘッダー行でなければなりません。
• スペースまたはカンマを含むフィールドは二重引用符で囲みます。
• 先頭または末尾にスペースを含む文字列は二重引用符で囲みます。
• フィールドが空の場合は、レコード内のその位置にコンマを挿入します。
• コンマを含むフィールドは、二重引用符で囲んでください。 たとえば、「名、姓」、「電話番号」、「住所」などです。
• フィールドに二重引用符が含まれる場合は、フィールド全体を二重引用符で囲み、各二重引用符を2つの二重引用符に変換します。
• 重要な注意:.csv ファイルには、データの最後に空白行を含めることはできません。空白行があると、インポートが失敗する可能性があります。

必須の列

少なくとも、.csv ファイルは、電話番号の 1 つの列を含める必要があります。たとえば、「連絡禁止」リストの 1 つの列は次のようになります。

連絡先名やアカウント コードなど、.csv ファイルに必要なすべての列を定義します。.csv ファイルをアップロードして新しいリストを作成すると、システムはクラウド内に一致する列を含むテーブルを作成します。このテーブルを作成した後は、異なる列セットを含むデータを追加することはできません。 

50列を超えないでください

連絡先リストで許可される列の最大数は 50 です。この新しい連絡先リストがその制限を超えるとエラー メッセージが表示されますが、イベント ビューアーにはエントリが表示されません。

列名は一意である必要があります

1 行目のすべての列名は一意でなければなりません。列名が重複すると、ファイルはインポートされません。

一意の識別子列を含める

各行を一意に識別する列を .csv ファイルに含めます。これにより、将来的に新しいデータや更新されたデータを正確に追加できるようになります。一般的な固有 ID はカスタマー ID やアカウント番号などです。後で、あなたが レコードを追加する 連絡先リストで、[一意の識別子]列を選択します。その列を使用すると、追加プロセスで受信データを既存の連絡先と最も正確に照合できます。

一意の識別子がない場合、行全体が主キーになります。変更されたレコードを追加すると、次のアップロードでそのレコードが新しい行として追加されます。既存の行に同じ ID が付いている場合でも同様です。この動作は、リストをエクスポートして変更し、データを追加してアップロードするときにユーザーが期待する動作ではありません。一意の識別子を使用すると、システムは既存のレコードを置き換えます。

ゾーン列を使用する

Contact list records often store multiple phone numbers per contact, such as work, cell, and home numbers. To use the callable times feature, each phone number column must have a corresponding time zone name column which contains the name you previously configured for callable time entries in the contactable time set in Genesys Cloud. For example, a column named Home Time Zone to contain the time zone name corresponding to each number in the Home Phone column. Note that zone columns are not used in Do Not Contact lists.

• ベスト プラクティスとして、連絡先リストを作成するときに、各電話番号列に対応する一意の ID とタイム ゾーン名列 (自宅や職場など) の両方を指定します。
• タイム ゾーン名の列を後から追加することはできませんが、同じ一意の ID を持つレコードを追加 (アップロード) することで、既存のゾーン名の列にデータを入力または更新することができます。Genesys Cloudが一致する行を見つけると、追加ファイルのデータを使用して列を更新します。たとえば、システムは、.csv ファイルから読み取ったタイム ゾーン データを使用して、レコード内のすべてのゾーン名列を更新します。ゾーン名列が存在する必要があります。
• Associate each time zone name column with a contact number column when you create a list. You can also edit the contact list later, and map its time zone columns to phone number columns by selecting from the time zone column dropdown list.

先頭と末尾の空白を削除しない

連絡先リストを保存すると、連絡先リストの連絡先フィールドから先頭と末尾の空白が削除されます。連絡先リストから空白を削除したくない場合は、「先頭/末尾の空白を削除」トグルをいいえ。

スプレッドシートプログラムを使用して.csvファイルを編集する

テキスト エディターではなく、スプレッドシート プログラムから CSV 形式で保存することをお勧めします。スプレッドシートで .csv ファイルを保存すると、必要な引用符とコンマが自動的に挿入されます。スプレッドシートを使用すると、レコードを手動でフォーマットするよりもエラーが発生しにくくなります。

たとえば、 ファイル > 名前を付けて保存 > CSV（カンマ区切り） Microsoft Excelのコマンドは、次の.csvレコードを生成します。