---
sourceDocument: オーストラリアのカスタマーサービス管理 (CSM)
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/customer-service-management

 Release :

    - australia

ft:locale :

    - ja-JP

ft:publication_title :

    - オーストラリアのカスタマーサービス管理 (CSM)

ft:clusterId :

    - csm

bundleId :

    - csm

workflow :

    - Customer and Industry


---

# カスタムコードを使用して機能を起動する

# エンゲージメントメッセンジャー でのカスタムコードを使用した機能の起動 {#ariaid-title1}

* リリースバージョン: Australia
* 
* 更新日 2026年03月12日
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：5分

カスタムコードを使用してディープリンクを有効にし、Web サイトと統合された機能を起動 エンゲージメントメッセンジャー 。

## 始める前に

[エンゲージメントメッセンジャー の構成](https://servicenow-prod.fluidtopics.net/Ar6~EgJTf46j4BMyc2KBMA "エンゲージメントメッセンジャー モジュールを作成し、その動作、外観、スタイルを構成します。メッセンジャーモジュールを作成することで、組織のブランディングに従い、顧客のニーズに合わせて外観と動作をカスタマイズできます。")。

[Web アプリケーションへのエンゲージメントメッセンジャー の埋め込み](https://servicenow-prod.fluidtopics.net/9IDRpy0hnPZA41aglkemvg "Web サイトで構成した Messenger モジュールのソースコードを埋め込み、顧客が Web サイトで エンゲージメントメッセンジャー の使用を開始できるようにします。")。

必要なロール：ec_admin および Web サイトアドミニストレーター

## このタスクについて

注:  
既存のコードを使用している場合は、`v=3.1` を表示するようスクリプトを更新していることを確認してください。たとえば、次のようになります：  

    <script src="https://example.service-now.com/scripts/sn_csm_ec.js?v=3.1"></script>
    <script>
    SN_CSM_EC.init({
          moduleID: "https://example.service-now.com/#aeff0547dd393010f87734cef087e2ba",
          loadFeature: SN_CSM_EC.loadEMFeature()
    });
    </script>

## 手順

1. 移動先 エンゲージメントメッセンジャーモジュール.
2. \[Engagement Messenger モジュールを構成\] で \[実装\] タブを開きます。
3. \[埋め込みコード\] セクションからコードをコピーします。
4. テキストエディターで、エンゲージメントメッセンジャー を統合する Web サイトの Web ページの HTML ファイルを開きます。
5. コピーしたコードを本文終了タグの前に貼り付けます。
6. 機能コンテキストを定義し、機能の変数を指定します。  
   機能コンテキストを定義するには、次の形式を使用します。

       { 
       	feature: "<var class="keyword varname">&lt;feature_name&gt;</var>", 
       	openOnLoad: <var class="keyword varname">&lt;true/false&gt;</var>, 
       	params: { 
       		"<var class="keyword varname">&lt;param_name&gt;</var>": "<var class="keyword varname">&lt;param_value&gt;</var>",
       		"<var class="keyword varname">&lt;param_name&gt;</var>": "<var class="keyword varname">&lt;param_value&gt;</var> 
       	} 
       }

   この形式で、機能変数を指定します。

   機能
   :   機能名。詳細については、「[エンゲージメントメッセンジャー でサポートされている機能コンテキストパラメーター](https://servicenow-prod.fluidtopics.net/jAu5eX5tGQTtOR52wVsn0g "コンテキスト起動機能を使用すると、エンゲージメントメッセンジャー のデフォルトの起動画面を設定できます。") 」を参照してください。

   openOnLoad
   :   エンゲージメントメッセンジャー を自動的に開く場合のみ、このオプションを含めて \[true\] に設定します。このオプションのデフォルト設定では、エンゲージメントメッセンジャー は自動的に開きません。

   \<param_name\>": "\<param_value\>
   :   機能に関連付けられたパラメーターの名前と値。詳細については、「[エンゲージメントメッセンジャー でサポートされている機能コンテキストパラメーター](https://servicenow-prod.fluidtopics.net/jAu5eX5tGQTtOR52wVsn0g "コンテキスト起動機能を使用すると、エンゲージメントメッセンジャー のデフォルトの起動画面を設定できます。")」を参照してください。
7. 埋め込みコードの `SN_CSM_EC.init` 関数に機能コンテキストを渡すためのカスタムラッパー関数を作成します。  
   たとえば、次のコードでは、チャット機能コンテキストの `chatFeatureContext()` カスタムラッパー関数を使用しています。


       function chatFeatureContext(){ 
       	return { 
       			feature: "CHAT",
       			openOnLoad: false,
       			params: { 
       				"topic_id": "8708db281bd5b81080df6247b04bcb79",
       				"language": "fr"		
       				} 
       		  } 
       }

   {#contextual-launch-using-script-engagement-messenger__wrapper-creation}
{#contextual-launch-using-script-engagement-messenger__wrapper-creation}
8. `SN_CSM_EC.loadEMFeature()` 関数を[ステップ 7](https://servicenow-prod.fluidtopics.net/luH_5HktkSMi_c_cjN~4IA "カスタムコードを使用してディープリンクを有効にし、Web サイトと統合された機能を起動 エンゲージメントメッセンジャー 。") で作成したカスタムラッパー関数に置き換えます。  
   たとえば、次のコードでは、`chatFeatureContext()` ラッパー関数が `loadFeature` 属性の値として渡されます。

       SN_CSM_EC.init({ 
       		moduleID: "https://example.service-now.com/#<module_id>", 
       		loadFeature: <var class="keyword varname">chatFeatureContext</var>()
       }); 

9. ファイルを保存します。
10. **オプション:** 指定された機能が起動することを確認します。
    1. エンゲージメントメッセンジャー を埋め込んだ Web サイトを開きます。
    2. ランチャーアイコンを選択します。
    3. 埋め込みコードで構成した機能が エンゲージメントメッセンジャー で起動されることを確認します。
    {#contextual-launch-using-script-engagement-messenger__substeps_gjt_cts_4qb}

## タスクの結果

埋め込みコードで指定した機能は、埋め込み先の Web サイトでエンゲージメントメッセンジャーを開くとデフォルトで起動されます。

## 例

次のコードは、デフォルトでチャット機能を開始します。また、トピックのシステム識別子 (sys_id) を渡してチャットがロードされたときに、デフォルトで 仮想エージェント トピックをトリガーする方法も示しています。言語を指定して、その言語でチャットを開始することもできます。

    <script src="https://example.servicenow.com/scripts/sn_csm_ec.js?v=3.1"></script>
    <script>
    function chatFeatureContext(){ 
    	return { 
    			feature: "CHAT",
    			openOnLoad: false,
    			params: { 
    				"topic_id": "8708db281bd5b81080df6247b04bcb79",
    				"language": "fr"		
    				} 
    		  } 
    }

    SN_CSM_EC.init({
    	moduleID: "https://example.service-now.com/#d27c94d6db403810a2a6a0ced39619da",
    	loadFeature: chatFeatureContext()
    });
    </script>

関数
:   <var class="keyword varname">chatFeatureContext()</var>：チャットコンテキストのラッパー関数。

機能
:   <var class="keyword varname">CHAT</var>：仮想エージェントまたはライブエージェントチャットを開始するためのチャット機能。

openOnLoad
:   <var class="keyword varname">false</var>：エンゲージメントメッセンジャー の自動起動を無効にします。

topic_id
:   <var class="keyword varname">8708db281bd5b81080df6247b04bcb79</var>：モジュールシステム識別子 (sys_id)。

言語
:   <var class="keyword varname">fr</var>：デフォルトのチャット言語をフランス語に設定します。