HubSpot統合用のStudioスクリプトを変更します

これは、HubSpotをCXone Agent for Microsoft Teamsと統合する第2ステップです。

HubSpotとCXone Agent for Microsoft Teamsの統合には、でCXone Agent Embeddedをセットアップするために既存のStudioスクリプトへのアクションの追加が必要になります。これらのアクションは、CXoneでセットアップしたCRM設定のバックエンドを実行します。希望するチャネル閉じた コンタクトがエージェントやボットとやり取りする方法。 チャネルには、音声、Eメール、チャット、ソーシャルメディアなどが含まれます。の各スクリプトにそれらを追加します。例えば、デジタルチャット用にHubSpotの統合を設定したい場合、デジタルチャットスクリプトを変更します。スクリプトにアクションを追加したら、それをカスタマイズする必要があります。これには、使用したいワークフローを指定する必要があります。

これらの各タスクを指定された順序で実行します。

テンプレートスクリプトをダウンロード

テンプレートスクリプトのこのフォルダーをダウンロードします。Desktop StudioとCXone Studio用の音声スクリプトとデジタルスクリプトを含みます。

各テンプレートスクリプトはSNIPPETとWORKFLOW EXECUTEのアクションを含みます。このアクションの組は、スクリプトに追加したい各ワークフローごとに必要です。テンプレートスクリプトには、2組のSNIPPETとWORKFLOW EXECUTEのアクションが含まれます。1組は検索ワークフロー用、1組は作成ワークフロー用です。不要なワークフローのタイプ用のアクションは削除することができます。SNIPPETとWORKFLOW EXECUTEのアクションをコピー＆ペーストして、スクリプトにさらに作成ワークフローと検索ワークフローを追加することもできます。

アクションをスクリプトに追加します

作業中のチャネル用の既存のスクリプトを変更します。

アクション キャプション 説明
SNIPPET Snippet for Search Workflow このアクションには、使用したい検索ワークフロー用のコードを保持します。

WORKFLOW EXECUTE

Workflow Execute for Search Workflow

このアクションは、先行するSNIPPETアクションで指定した検索ワークフローを実行します。これはワークフローのペイロードをJSONに変換し、CXone Agent for Microsoft Teamsに渡します。
SNIPPET Snippet for Create Workflow このアクションは、使用したい作成ワークフロー用のコードを保持しています。
WORKFLOW EXECUTE Workflow Execute for Create Workflow このアクションは、先行するSNIPPETアクションで指定した作成ワークフローを実行します。これはワークフローのペイロードをJSONに変換し、CXone Agent for Microsoft Teamsに渡します。
SNIPPET Snippet for Record ID このアクションは、作成ワークフローで作成されたレコード用のレコードIDを保持しています。
SNIPPET Snippet for Send Workflow Response このアクションのペイロードは、WORKFLOW EXECUTEアクションのresultSet (out)プロパティに設定された変数にコンタクトIDを追加します。これはCRMから返されたワークフローの結果をJSONで保持するための変数も作成します。
CUSTOMEVENT Send Workflow Response このアクションは、エージェントワークフローの応答と呼ばれるカスタムイベントをトリガーします。第2レベルの検索を実行して、初期ワークフローの結果に関する詳細情報を取得します。たとえば、ワークフローにコンタクトの名前が表示された場合、このイベントは各コンタクトの詳細を取得します。
AGENT WORKFLOW CONFIGURATION なし このアクションは、エージェントがCXone Agent for Microsoft Teamsで手動でトリガーするときにワークフローを実行します。これはエージェントが使用したワークフローに応じて、スクリプトとCXone Agent for Microsoft Teamsの間で情報を移動します。

Desktop Studioで

  1. Studioにログインします。

  2. ファイル>ファイルからインポートをクリックします。Desktop Studio用の音声またはデジタルテンプレートスクリプトを選択します。

    各ワークフローに1組のスニペットとワークフローの実行アクションを持つスクリプト。これにはレコードIDとカスタムイベント用のスニペットアクションもあります。
    各ワークフローに1組のスニペットとワークフローの実行アクションを持つスクリプト。これにはレコードIDとカスタムイベント用のスニペットアクションもあります。

  3. 変更したいスクリプトを開きます。

  4. テンプレートスクリプトからこれらのアクションをコピーし、既存のスクリプトのそれらが属する場所に貼り付けます：

    アクション キャプション
    SNIPPET Snippet for Search Workflow

    WORKFLOW EXECUTE

    Workflow Execute for Search Workflow

    SNIPPET Snippet for Create Workflow
    WORKFLOW EXECUTE Workflow Execute for Create Workflow
    SNIPPET Snippet for Record ID
    SNIPPET Snippet for Send Workflow Response
    CUSTOMEVENT Send Workflow Response
    AGENT WORKFLOW CONFIGURATION なし

  5. スクリプトを保存します。

CXone Studioで

  1. CXoneで、アプリセレクターをクリックし、選択します：オムニチャネルルーティング>Studio根元でつながっている3本の矢。１本は真上を、１本は右上を、1本は左上を指しています。。

  2. スクリプトの読み込みをクリックします。CXone Studio用の音声またはデジタルテンプレートスクリプトを選択します。

    各ワークフローに1組のスニペットとワークフローの実行アクションを持つスクリプト。これにはレコードIDとカスタムイベント用のスニペットアクションもあります。
    各ワークフローに1組のスニペットとワークフローの実行アクションを持つスクリプト。これにはレコードIDとカスタムイベント用のスニペットアクションもあります。

  3. 変更したいスクリプトを開きます。

  4. これらのアクションをスクリプトに追加します。

    アクション キャプション
    SNIPPET Snippet for Search Workflow

    WORKFLOW EXECUTE

    Workflow Execute for Search Workflow

    SNIPPET Snippet for Create Workflow
    WORKFLOW EXECUTE Workflow Execute for Create Workflow
    SNIPPET Snippet for Record ID
    SNIPPET Snippet for Send Workflow Response
    CUSTOMEVENT Send Workflow Response
    AGENT WORKFLOW CONFIGURATION なし

    CXone Studioでは、スクリプト間のアクションのコピーはまだサポートされていません。

  5. テンプレートスクリプトの各SNIPPETアクションからコードをコピーし、スクリプトに追加した照応するSNIPPETアクションに貼り付けます。

  6. スクリプトを保存します。

Studioアクションをカスタマイズします

次のためのStudioアクションをカスタマイズします：

検索ワークフロー用スニペット

このSNIPPETアクションは、各HubSpot検索ワークフローのコードを含みます。SNIPPETごとに1つだけのワークフローを設定できます。各ワークフローごとに、1つのSNIPPETアクションと1つのWORKFLOW EXECUTEアクションを備えなければなりません。

  1. Desktop Studioを使用している場合は、Snippet for Search Workflowという名のスクリプトでSNIPPETアクションをダブルクリックします。

  2. CXone Studioを使用している場合は、Snippet for Search Workflowという名のスクリプトでSNIPPETアクションを選択し、アクションのプロパティでエディタを開くをクリックします。

  3. このSNIPPETで使用しているのはどのワークフローかを決定し、他のワークフローのコードを削除します。

  4. 使用したいワークフローでは、そのワークフロー用の指示に従ってコードを編集します。

  5. このスクリプトで複数の検索ワークフローを設定するには以下の手順に従います。

    1. このSNIPPETをコピー＆ペーストします。

    2. このSNIPPETに続くWORKFLOW EXECUTEアクションをコピー＆ペーストします。

    Desktop Studioで：
    1組が検索ワークフロー番号1、1組が検索ワークフロー番号2とされる、2組のSNIPPETとWORKFLOW EXECUTEのアクション。
    CXone Studioで：
    1組が検索ワークフロー番号1、1組が検索ワークフロー番号2とされる、2組のSNIPPETとWORKFLOW EXECUTEのアクション。

  6. スクリプトを保存します。

検索ワークフロー用のワークフロー実行

このアクションは、HubSpot検索ワークフロー用のコードでSNIPPETの後に記述しなければなりません。

ワークフロー実行ウィザードでは、CRM統合、1つ以上のアクションを選択し、それらをワークフローにマッピングすることができます。

  1. Desktop Studioを使用している場合は、Workflow Execute for Search Workflowという名のスクリプト内のWorkflow Executeアクションをダブルクリックして、ワークフロー実行ウィザードを起動します。

  2. CXone Studioを使用している場合は、Workflow Execute for Search Workflowという名のスクリプトでWorkflow Executeアクションを選択し、アクションのプロパティでエディタを開くをクリックします。これでワークフロー実行ウィザードが起動します。

  3. Configuration Nameフィールドで、このWorkflow Executeアクションで使用するHubSpotを選択します。ドロップダウンには、CXoneシステム内のすべての構成済み統合の名前が表示されます。

  4. Actionsのフィールドで、Searchを選択します。

  5. Workflow Mappingの下で、このスクリプトに実行させる検索ワークフローマッピングを選択します。選択できるマッピングは1Workflow Executeアクションあたり1つだけです。

  6. Nextをクリックします。
  7. ポップアップウィンドウで選択内容を検証します。選択を変更する必要がある場合、Noをクリックして変更します。
  8. 選択した内容をWorkflow Executeプロパティに適用するには、ポップアップウィンドウのYesをクリックします。
  9. スクリプトを保存します。

作成ワークフロー用スニペット

このSNIPPETアクションは、各HubSpot作成ワークフロー用のコードを含みます。SNIPPETごとに1つだけのワークフローを設定できます。各ワークフローごとに、1つのSNIPPETアクションと1つのWORKFLOW EXECUTEアクションを備えなければなりません。

  1. Desktop Studioを使用している場合は、Snippet for Create Workflowという名のスクリプトでSNIPPETアクションをダブルクリックします。

  2. CXone Studioを使用している場合は、Snippet for Create Workflowという名のスクリプトでSNIPPETアクションを選択し、アクションのプロパティでエディタを開くをクリックします。

  3. このSNIPPETで使用しているのはどのワークフローかを決定し、他のワークフローのコードを削除します。

  4. 使用したいワークフローでは、そのワークフロー用の指示に従ってコードを編集します。

  5. このスクリプトで複数の作成ワークフローを設定するには、以下の手順に従います。

    1. このSNIPPETをコピー＆ペーストします。

    2. このSNIPPETに続くWORKFLOW EXECUTEアクションをコピー＆ペーストします。

    Desktop Studioで：

    1組が作成ワークフロー番号1、1組が作成ワークフロー番号2とされる、2組のSNIPPETとWORKFLOW EXECUTEのアクション。

    CXone Studioで：

    1組が作成ワークフロー番号1、1組が作成ワークフロー番号2とされる、2組のSNIPPETとWORKFLOW EXECUTEのアクション。

  6. スクリプトを保存します。

作成ワークフロー用のワークフロー実行

このアクションは、HubSpot作成ワークフロー用のコードでSNIPPETの後に記述しなければなりません。

CRM統合、1つ以上のアクションを選択し、それらをワークフローにマッピングすることができる、ワークフロー実行ウィザード。

  1. Desktop Studioを使用している場合は、Workflow Execute for Create Workflowという名のスクリプト内のWorkflow Executeアクションをダブルクリックして、ワークフロー実行ウィザードを起動します。

  2. CXone Studioを使用している場合は、Workflow Execute for Create Workflowという名のスクリプトでWorkflow Executeアクションを選択し、アクションのプロパティでエディタを開くをクリックします。これでワークフロー実行ウィザードが起動します。

  3. Configuration Nameフィールドで、このWorkflow Executeアクションで使用するHubSpotを選択します。ドロップダウンには、CXoneシステム内のすべての構成済み統合の名前が表示されます。

  4. Actionsのフィールドで、Createを選択します。

  5. Workflow Mappingの下で、このスクリプトに実行させる作成ワークフローのマッピングを選択します。選択できるマッピングは1Workflow Executeアクションあたり1つだけです。

  6. Nextをクリックします。
  7. ポップアップウィンドウで選択内容を検証します。選択を変更する必要がある場合、Noをクリックして変更します。
  8. 選択した内容をWorkflow Executeプロパティに適用するには、ポップアップウィンドウのYesをクリックします。
  9. スクリプトを保存します。

レコードID用のスニペット

このSNIPPETアクションは、作成ワークフローで作成されたレコード用のレコードIDを保持します。スクリプトに作成ワークフローがない場合は、このアクションを削除できます。複数の作成ワークフローがある場合、このアクションはそれぞれ用のレコードIDを保持することができます。

  1. Desktop Studioを使用している場合は：

    1. Workflow Execute for Create Workflowという名のスクリプトでWORKFLOW EXECUTEアクションを右クリックします。

    2. resultSet (out)プロパティの値をコピーします。

    3. Snippet for Record IDという名のスクリプトでSNIPPETアクションをダブルクリックします。

    4. resultSet (out)プロパティの値を、単語のarrayと置換してコードの中括弧の間に貼り付けます。

    5. [RecordType]を作成ワークフローで作成されたレコードのタイプに変更します。

  2. CXone Studioを使用している場合は：

    1. Workflow Execute for Create Workflowという名のスクリプトでWORKFLOW EXECUTEアクションを選択します。

    2. 右側のプロパティパネルから、Result Setプロパティの値をコピーします。

    3. Snippet for Record IDという名のスクリプトでSNIPPETアクションを選択し、アクション プロパティのエディタを開くをクリックします。

    4. Result Setプロパティの値を、単語のarrayと置換してコードの中括弧の間に貼り付けます。

    5. RecordTypeを作成ワークフローで作成されたレコードのタイプに変更します。

  3. スクリプト内に複数の作成ワークフローがある場合は、作成ワークフローごとに上記のステップを繰り返します。

  4. スクリプトを保存します。

エージェントワークフロー設定

このアクションは、エージェントがCXone Agent for Microsoft Teamsで手動でトリガーするときにワークフローを実行します。これはエージェントが使用したワークフローに応じて、スクリプトとCXone Agent for Microsoft Teamsの間で情報を移動します。

CRM統合、1つ以上のアクションを選択し、ワークフローにマッピングすることができる、エージェントワークフロー設定ウィザード。

  1. Desktop Studioを使用している場合は、スクリプトでAgent Workflow Configurationアクションをダブルクリックします。これでカスタムCRM設定ウィザードが起動します。

  2. CXone Studioを使用している場合は、スクリプトでAgent Workflow Configurationアクションを選択し、アクションのプロパティでエディタを開くをクリックします。これでカスタムCRM設定ウィザードが起動します。

  3. このAgent Workflow Configurationアクションに使用させたいCustom CRM Configurationを選択します。ドロップダウンには、CXone環境内のすべての構成済み統合の名前が表示されます。

  4. このスクリプトの実行時にエージェントが実行できるようにする、1つ以上のActionsを選択します。

    フィールド値 詳細
    Select All サポートされているすべてのアクションを選択します。
    Create Timeline

    これはHubSpotではサポートされていません。

    Data Memorialization

    エージェントは、顧客カードのアクティビティセクションで選択したレコードのデータを、現在のコンタクトのレコードに追加できます。CXoneのAgent IntegrationsのページのHubSpot用にそれをマッピングすることにより追加することのできるデータを決定します
    Search エージェントは第2レベルの検索を実行できます。最初の検索を実行した後、その結果をさらに検索して詳細な情報を調べることができます。

  5. Workflow Mappingセクションで、選択したActionsに割り当てるワークフローを選択します。選択できるワークフローは1アクションあたり1つだけです。ワークフローマッピングを変更する場合、新しいワークフローを選択する前に最初の選択をクリアしてください。Action列は、各ワークフローオプションがどのアクションに対応するかを示しています。

    ワークフローマッピングセクションでは、HubSpotおよびデータのメモリアル化検索エンティティが選択されています。
  6. Nextをクリックします。
  7. Custom CRM Configurations Updatedウィンドウで選択内容を確認します。選択を変更する必要がある場合、ウィンドウを閉じて、変更を行います。
  8. 選択した内容をAgent Workflow Configurationプロパティに適用するには、Custom CRM Configurations UpdatedウィンドウのSaveをクリックします。
  9. スクリプトを保存します。

スクリプトのテスト

Desktop StudioまたはCXone Studioでインタラクションをシミュレートしてスクリプトをテストしてください。

CXone Agent for Microsoft TeamsとHubSpotを統合する次のステップは、ワークフローを設定することです。