一括インポート用に電話番号をフォーマットする

Genesys Cloudは、 E.164仕様システム内で使用される電話番号用。.csv ファイルを使用して外部連絡先と外部組織を一括インポートする場合、.csv ファイルの入力電話番号は E.164 標準に準拠している必要があります。この記事では、電話番号を Genesys Cloud にインポートする前にフォーマットする方法について説明します。

注記:一括インポート機能は、有効な形式の電話番号を受け入れ、問題を修正するのに役立つ警告メッセージを生成します。インポートはブロックされませんが、Genesys では、インポートを完了する前に検証ログで警告を確認することをお勧めします。

許容できる電話番号の形式

一括インポート機能とエンリッチ API は、次の電話番号形式を認識し、連絡先の照合の ID 解決アルゴリズムに合わせて内部的に処理します。

  • +441213315xxx
  • +1 232xxx4316
  • +29234xxx32432
  • +1 xxx 555 5554
  • +591 743392xxx3
  • +1 321 yyy 9872 x 123
  • (+44)121.xxx.5251
  • +1 415-xxx-2629

許容される国コードの形式

一括インポート機能とエンリッチ API は、.csv テンプレートの電話番号列に指定された次の国コード形式を認識して処理します。

+記号で始まる電話番号

  • 米国: +1
  • イギリス: +44
  • HU: +36

00で始まる電話番号

  • 私たち:001
  • イギリス:0044
  • 胡:0036

その他の電話番号の形式

  • この形式を使用するには、.csv テンプレートの国コード列に国コード (例: US、GB) を指定する必要があります。
    • 私たち:1
    • イギリス:44
    • 胡:36
  • その他の国固有の形式の場合は、.csv テンプレートの国コード列に国コード (例: US、GB) を指定する必要があります。 
    • 胡:06

E.164以外の形式の例

通常、一括インポート機能では、準拠していない E.164 電話番号は処理されず、適切な警告とエラー メッセージが表示されます。

E.164 以外の形式には次のものがあります: 

  • 予想より少ない数字
  • 予想以上の数字
  • 数字以外の文字

エラーと警告

これらのサンプル シナリオでは、電話番号関連のエラーと警告メッセージについて説明します。 

例のシナリオ1

このシナリオでは、電話番号はE.164形式に従っていますが、北米形式。一括インポート機能は、必要なダッシュを挿入して北米の書式を適用します。

.csvで電話番号を入力してください .csv 形式の正規化国コード Genesys Cloudに保存されている電話番号 Genesys Cloudに保存されている電話正規化国コード 警告メッセージ
+13216549870 +1 321-654-9870
+1 3216549871 +1 321-654-9871

例のシナリオ2

このシナリオでは、電話番号は E.164 形式に従いますが、英国の形式と一致しません。一括インポート機能は、ダッシュを削除し、必要なスペースを追加することで書式を調整します。

.csvで電話番号を入力してください .csv 形式の正規化国コード Genesys Cloudに保存されている電話番号 Genesys Cloudに保存されている電話正規化国コード 警告メッセージ
+44 1213315014 +44 121 331 5014
+44 121-231-5416 +44 121 231 5416

例のシナリオ3

このシナリオでは、入力に余分な数字または文字が含まれているため電話番号は E.164 に準拠しておらず、正規化国コードが指定されていません。インポートを続行すると、一括インポート機能によって番号がそのままシステムに保存され、インポート プロセスの最後に警告メッセージが表示されます。

.csvで電話番号を入力してください .csv 形式の正規化国コード Genesys Cloudに保存されている電話番号 Genesys Cloudに保存されている電話正規化国コード 警告メッセージ
(+44)121 231 54023 (+44)121 231 54023

contact.cellPhone[(+44)121 231 54023]{あなたの電話番号はE164標準と互換性がありません};

contact.cellPhone.normalizationCountryCode[null]{正規化国コードを入力する必要があります}

(44)1213315082 (44)1213315082

contact.cellPhone[(44)1213315082]{あなたの電話番号はE164標準と互換性がありません};

contact.cellPhone.normalizationCountryCode[null]{正規化国コードを入力する必要があります}

(44) 121.331.5290 (44) 121.331.5290

contact.cellPhone[(44) 121.331.5290]{あなたの電話番号はE164標準と互換性がありません};

contact.cellPhone.normalizationCountryCode[null]{正規化国コードを入力する必要があります}

  • 電話番号 (+44)121 231 54023 の入力には余分な数字が含まれています。 
  • 電話番号 (44)1213315082 および (44) 121.331.5290 には括弧 (44) 内に無効な国コードが指定されています。詳細については、「有効な国コードの形式」セクションを参照してください。

例のシナリオ4

このシナリオでは、入力フィールドまたは正規化フィールドに国コードがないため、電話番号は E.164 に準拠していません。インポートを続行すると、一括インポート機能によって米国の国コードがデフォルトで追加されます。

.csvで電話番号を入力してください .csv 形式の正規化国コード Genesys Cloudに保存されている電話番号 Genesys Cloudに保存されている電話正規化国コード 警告メッセージ
321.654.9881 +1 321-654-9881

contact.cellPhone[321.654.9881]{お使いの電話番号はE164標準と互換性がありません};

contact.cellPhone.normalizationCountryCode[null]{正規化国コードを入力する必要があります}

321 654 9879

+1 321-654-9879

contact.cellPhone[321 654 9879]{お使いの電話番号はE164規格と互換性がありません};

contact.cellPhone.normalizationCountryCode[null]{正規化国コードを入力する必要があります}

例のシナリオ5

このシナリオでは、電話番号は E.164 形式であり、入力電話番号には国コードがありませんが、インポート ファイルの正規化フィールドには正規化国コードがあります。警告は生成されず、一括インポート機能により、必要に応じて追加の地域書式が適用されます。

.csvで電話番号を入力してください .csv 形式の正規化国コード Genesys Cloudに保存されている電話番号 Genesys Cloudに保存されている電話正規化国コード 警告メッセージ

3216549891

US

+1 321-654-9891

US

(44)1213315095

GB

+44 121 331 5095

GB

例のシナリオ6

このシナリオでは、電話番号は E.164 形式であり、正規化国コードは入力番号と正規化フィールドの両方で正しく指定されています。警告は生成されず、一括インポート機能により、必要に応じて追加の地域書式が適用されます。

.csvで電話番号を入力してください .csv 内の正規化国コード Genesys Cloudに保存されている電話番号 Genesys Cloudに保存されている電話正規化国コード 警告メッセージ

(+1)321.654.9838

US

+1 321-654-9838

US

+441213315039

GB

+44 121 331 5039

GB

例のシナリオ7

このシナリオでは、電話番号は E.164 形式ですが、入力番号と正規化フィールドには 2 つの異なる正規化国コードがあります。警告メッセージは、一括インポート機能では入力電話番号の国コードのみが使用され、正規化フィールドの値は無視されることを示します。

.csvで電話番号を入力してください .csv 形式の正規化国コード Genesys Cloudに保存されている電話番号 Genesys Cloudに保存されている電話正規化国コード 警告メッセージ

+13216549852

GB

+1 321-654-9852

GB

contact.cellPhone.normalizationCountryCode[GB]{あなたの電話番号は米国のものですが、国コードは英国のものです。お客様の電話番号を米国の国番号で解決しています。

(+44)1213315074

US

+44 121 331 5074

US

contact.cellPhone.normalizationCountryCode[US]{あなたの電話番号は英国のものですが、国コードは米国のものです。お客様の電話番号を英国の国番号で解決しています。