CSV 形式でリストを作成

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

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

    必須の列

    .csvファイルには、少なくとも1列の電話番号を含める必要があります。 たとえば、単一の列は「連絡先なし」リストに適しています。

    電話 
    317-123-4567

    注意: フォーマット文字は無視されます。ただし、E.164 フォーマットの数値の場合は、先頭のプラス記号(+)は無視されます。

    ほとんどの連絡先リストには、連絡先名やアカウントコードなど、さらに多くの列が必要です。 .csv ファイルで必要なすべての列を定義するようにしてください。

    ファイルをアップロードして新しいリストを作成すると、システムはクラウド内に一致する列を持つテーブルを作成します。 その後、異なる列のセットに含まれるデータを追加できません。

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

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

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

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

    一意の識別子列を含める

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

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

    一意の識別子を使用すると、代わりに既存のレコードが置き換えられます。

    一意の識別子に特殊文字を使用しない

    英数字から一意の識別子を構成できます。 スペース、 バックスラッシュこれらの特殊文字はURLでは機能しません。

    - 。 _ ~ : / ? # [ ] @ ! $ & ‘ ( ) * + , ; =

    ゾーン列を使用する

    連絡先リストレコードには、職場、携帯、自宅の番号など、連絡先ごとに複数の電話番号が格納されていることがよくあります。 を使用するには、 コール可能な時間 各電話番号列には、 Tz データベース フォーマット。 例えば、[自宅タイムゾーン] という名前の列には、[自宅の電話] 列の各電話番号に対応するタイムゾーンが含まれています。 連絡先リストでは、ゾーン列は使用しません。

    • ベストプラクティスとして、連絡先リストを作成するときに、各電話番号の列(自宅や職場など)に対応する一意のIDとゾーンの列の両方を指定します。

    • 後でゾーン列を追加することはできませんが、同じ一意のIDを持つレコードを追加(アップロード)することで既存のゾーン列を作成または更新できます。 Genesys Cloudが一致する行を見つけると、追加ファイルのデータを使用して列を更新します。 例えば、.csv ファイルから読み取られたタイムゾーン データを含むレコードのゾーン列が更新されます。 ゾーン列は必須です。

    • 各タイムゾーン列を連絡先番号列に関連付けます。これは通常、リストを作成するときに行います。 関連付けることを忘れても、連絡先リストを後で編集し、ゾーン列ドロップ リストで項目を選択して、タイムゾーン列と電話番号列をマッピングすることができます。

      図は、電話番号列とタイムゾーンを特定する列を関連付ける方法を示しています

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

    連絡先リストを保存すると、連絡先リストの連絡先フィールドから先頭と末尾の空白が削除されます。 連絡先リストから空白を削除したくない場合は、 Trim leading/trailing whitespace toggle をNo に切り替えてください。

    テキストエディタの代わりにスプレッドシートを使用して.csvファイルを編集する

    スプレッドシートエディタから.csvとして保存することをお勧めします。 スプレッドシートで .csv ファイルを保存すると、必要な引用符とコンマが自動的に挿入されます。 スプレッドシートを使用すると、レコードを手動で書式設定するよりもエラーが少なくなります。

    spreadsheet_data

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

    Last Name, First Name,Home Phone, Home Time Zone,Cell Phone,Cell Time Zone,Balance Due,Account Code,HomeAddress
    Doe,"James ""Big John""",317-123-4567,America/Indiana/Indianapolis,317-987-6543,America/Indiana/Indianapolis,175,1003,"123 Anystreet, Indianapolis, IN"
    Downing,Mary,424-999-2334,America/Los_Angeles,,,234,3799,"724 Bel Air Drive, Los Angeles, CA"
    
    
    注意: SMSキャンペーン用のCSVリストを作成する際、スプレッドシートアプリにExcelを使用している場合、電話番号の列はE.164形式である必要があります。 電話番号の列には、Excelカスタム フォーマットを使用し、+# ?/? 数字のフォーマットコードを使用します。 カスタム書式を指定しない場合、Excelのデフォルト書式では、'+'接頭辞が削除されます。