データアクション統合による電話番号検索

 メモ:   この記事は、Microsoft Dynamics 365、Salesforce、およびZendeskデータアクションの統合に適用されます。

このコンテンツでは、Microsoft Dynamics 365が電話番号をどのようにフォーマットして保存するか、電話番号がArchitectでどのようにフォーマットされるか、および統合がMicrosoft Dynamics 365で電話番号を検索する方法について説明します。

Microsoft Dynamics 365は、数字以外の数字の有無にかかわらず、任意の形式で数字を格納できます(たとえば、+ 13175550125、+ 1(317)555-0125、または13175550125)。

Architectは、PHONE_NUMBERボックスに渡される電話番号(ANI)をtel:+ {数字のみの文字列}として、たとえばtel:としてフォーマットします。 +13175550125.

統合により、telから数字以外の文字が削除されます。 Architectでフォーマットされた電話番号。 次に統合は、Microsoft Dynamics 365で会社の電話番号、自宅の電話番号、および自宅の電話番号を検索して、次の形式を探します。 

  • 電話番号 フォーマット(tel: +13175550125)。
  • 数字のみの形式(13175550125)

電話番号がどちらの形式でもMicrosoft Dynamics 365に存在しない場合、統合において一致を見つけられず、ANIに基づいてデータを返すことができません。 

一致の電話番号フォーマット(デフォルトの動作)

この表は、Microsoft Dynamics 365で数字のみ形式の電話番号のみが統合によって検出されることを示しています。 (黄色で強調表示されている行を参照してください)。 統合は、Microsoft Dynamics 365の他の電話番号フォーマットに基づいてANIによってレコードを見つけません。

Microsoft Dynamics 365の電話番号の形式 統合によってMicrosoft Dynamics 365の検索に使用される形式 統合がMicrosoft Dynamics 365で見つけるフォーマット

生文字列形式 (Architect でデフォルトを返す)

数字のみのフォーマット
(統合により変換)

13175550125 tel:+13175550125 13175550125 数字のみ
+13175550125 tel:+13175550125 13175550125
(317)555-0125 tel:+13175550125 13175550125
1(317)555-0125 tel:+13175550125 13175550125
+1(317)555-0125 tel:+13175550125 13175550125
tel:+13175550125 tel:+13175550125 13175550125 生の文字列 
ヒント:   統合によってMicrosoft Dynamics 365の電話番号が確実に検出されるようにするには、Microsoft Dynamics 365のすべての電話番号が数字のみの形式(13175550125など)であることを確認してください。

(Architectの換算値) に一致する電話番号の形式

Microsoft Dynamics 365で電話番号を標準化する代わりに、 Architectコールフローでのものに対して返される文字列の値を操作できます。 Microsoft Dynamics 365 で一致を見つけるコネクタにArchitectのリード値変換 (raw 文字列形式) を示します。 (値が一致するリードは、太字で)。

Microsoft Dynamics 365の電話番号の形式 統合によってMicrosoft Dynamics 365の検索に使用される形式 統合がMicrosoft Dynamics 365で見つけるフォーマット

生の文字列フォーマット(Architectから統合に渡される)

数字のみのフォーマット
(統合により変換)

1 317 555 0125 1 317 555 0125 13175550125 生の文字列 
13175550125 1 317 555 0125 13175550125 数字のみ
+1 317 555 0125 1 317 555 0125 13175550125
+1 317 555 0125 +1 317 555 0125 13175550125 生の文字列  
(317)555-0125 (317)555-0125 3175550125 生の文字列 
+1(317)555-0125 +1(317)555-0125 3175550125 生の文字列 
任意のフォーマット *3 * 1 * 7 * 5 * 5 * 5 * 0 * 1 * 2 * 5* 3175550125 生の文字列 
 メモ:   誤ワイルドカード raw 文字列形式 (行は黄色で強調表示されます) を使用して可能性があります。 たとえば、440 の市外局番からの電話番号は市外局番 440 で米国の電話番号と英国の電話番号の両方を返すことができます。

値変換の例

この例のコールフローでは、コールデータアクションはArchitect(tel:+13175550125)によって返されたデフォルトの電話番号フォーマットを特定のMicrosoft Dynamics 365組織で使用される電話番号フォーマット(+1(317)555-0125)に変換します。 PHONE_NUMBERボックスで使用される値は次の式です。

「+1 ("+ 部分文字列 (Call.Ani, 6, 3) +")"+ 部分文字列 (Call.Ani、9,3) +"-"+ 部分文字列 (Call.Ani, 12, 4)  

画像をクリックして拡大します。
Architectで電話番号を変換するためのコールフローの例

詳細については、 データアクションを使用するをご参照ください。

統合について詳しくは、以下を参照してください。 Microsoft Dynamics 365データアクション統合について

このコンテンツでは、Salesforceが電話番号をどのようにフォーマットして保存するか、および統合がSalesforceで電話番号を検索する方法について説明します。

Salesforceデータアクション統合に関連付けられたデータアクションは、電話番号を使用して情報を取得できます。

call.Ani は、データ アクションで使用するために電話番号を自動的に取得する一般的な方法です。call.Ani は、Genesys Cloud 全体で使用されるシステム レベルの変数で、電話番号は、+13175550123 など、E.164 形式で表示されます。

call.Aniが必要な情報を返さない場合は、Salesforceでのデータのフォーマット方法に基づいてSalesforceで情報を検索する変数を使用します。 Salesforceで検索し、返された結果が期待どおりであることを確認することで、検索フォーマットがSalesforceデータのフォーマットと一致することをテストできます。

Salesforceが電話番号をどのようにフォーマットして格納するか、およびデータアクション統合がSalesforceで電話番号を検索する方法を確認します。

Salesforceでの電話番号の形式と保管

Salesforce の 11 桁の電話番号入力の形式に応じて Salesforce 形式し、電話番号は別に保存します。  

  • 11桁の数字が先頭の1で始まる場合、Salesforceは先頭の1を削除し、電話番号を10桁の数字として格納します。
    番号入力 Salesforceに格納された番号
    12135551234 2135551234

    この場合、Salesforceで12135551234を直接検索すると、Salesforceは結果を返しません。

  • ただし、先頭に1が付く11桁の数字の前に+が付いている場合、Salesforceは+とともに11桁すべてを保持します。
    番号入力 Salesforceに格納された番号
    +12135551234 +12135551234

    この場合、12135551234でSalesforceを直接検索すると、Salesforceは結果を返します。

統合による電話番号検索

Salesforceデータ・アクション統合は、ArchitectのPHONE_NUMBERボックス内の正確な数についてSalesforceを検索します。 数値の形式は関係ありません。 統合はSalesforceで任意の形式で番号を見つけることができます。

ただし、Salesforceの数字に国コードが含まれていると、問題が発生する可能性があります。 ArchitectのSalesforceとPHONE_NUMBERボックスの番号は、番号とフォーマットの両方が同じでなければなりません。 そうでなければ、統合はSalesforceで番号を見つけることができません。

詳細については、 データアクションを使用するをご参照ください。

統合について詳しくは、以下を参照してください。 Salesforceデータアクション統合について

このコンテンツでは、Zendeskデータアクション統合のためにZendeskが電話番号をフォーマットおよび保存する方法について説明します。

Zendeskでは、フォーマット設定の有無にかかわらず、任意の文字を電話番号として入力できます。

Zendesk検索APIでは、電話フィールドのすべての数字が検索値と一致する必要があります。 たとえば、電話番号を13175550100としてZendeskに保存し、3175550100を検索した場合、Zendeskは一致を返しません。 Zendeskが確実に一致を返すようにするには、電話番号に使用できるすべての形式を検索します。 たとえば、13175550100、3175550100、および5550100を検索します。 

 メモ:   電話番号の形式は検索結果に影響しません。 Zendeskは、ハイフンや括弧の有無にかかわらず、任意の形式で電話番号を検索します。

詳細については、 データアクションを使用するをご参照ください。

統合について詳しくは、以下を参照してください。 Zendeskデータアクション統合について