​

はじめに

​

主な機能

• D365 Customer Service から MoEngage に連絡先とアカウントを同期する。
• ケースの作成、解決、SLA の更新などのサービスアクティビティを行動イベントとしてインポートする。
• CSAT、NPS、その他のフィードバックデータをセグメンテーション用のイベントとして取得する。
• サポートのインタラクションやケースのライフサイクルイベントに基づいて、コンテキストに沿ったキャンペーンをトリガーする。

​

同期モジュール

​

ユースケース

• ケースベースのエンゲージメント: D365 で新しいケースが作成されると、データを即座に MoEngage に送信し、ケース番号と解決予定時間を記載した確認メールをトリガーします。
• 解決とフィードバック: D365 でケースが「Resolved」とマークされたら、MoEngage キャンペーンを介して CSAT または NPS アンケートをトリガーし、即時のフィードバックを取得します。
• SLA とエスカレーション: SLA ステータスの更新を監視します。SLA が「Nearing Breach」になった場合は、顧客への事前の最新情報キャンペーンと、サポートマネージャーへの社内アラートをトリガーします。
• フィードバック主導のジャーニー: アンケートで低い CSAT スコアを受け取った場合、ユーザーを MoEngage の特定の再エンゲージメントジャーニーに自動的に追加し、D365 でフォローアップタスクを作成します。

​

ステップバイステップの統合ガイド

​

ステップ 1: MoEngage のエンドポイントを取得する

1. MoEngage サポートチームに連絡し、専用の統合エンドポイントをリクエストします。
2. リクエストには、プロフィールのリンクに使用する共通識別子(メールアドレス、external_id、または D365 GUID)を明記します。
3. MoEngage から次の情報が提供されます。
   1. 専用の Webhook URL(形式: https://api-0X.moengage.com/v1/partner/d365-service/{events/users}/?configName={config_name})
   2. 統合の設定名

​

ステップ 2: Power Automate フローを作成する

1. Power Automate を開きます。
2. Create > Automated Cloud Flow をクリックします。
3. フローに名前を付けます: D365 - Sync [Entity] to MoEngage(例: D365 - Sync Case Created to MoEngage)。
4. トリガーを選択します: When a row is added, modified or deleted (Dataverse)。
5. トリガーの詳細を設定します。
   1. Change type: ペイロードに応じて、Added、Modified、または Added or Modified を選択します。
   2. Table name: エンティティ(例: Cases、Contacts、SLA KPI Instances)を選択します。
   3. Scope: Organization。

​

どのトリガーをいつ使用するか(シナリオ別)

​

1. ケースの作成/更新(およびユーザープロフィールの同期)

• Change type: Added
• Table name: Cases(または incident)

​

2. SLA 違反/警告

• Change type: Added or Modified
• Table name: SLA KPI Instances

​

3. CSAT アンケートの送信

• Change type: Added
• Table name: Survey Responses

​

ステップ 3: HTTP Webhook アクションを設定する

1. New Step をクリックし、HTTP を選択します。
2. 次の項目を入力します。

   フィールド	値
   Method	POST
   URI	MoEngage から提供された専用の Webhook URL を入力します。
   Headers	Authorization: Basic [Base64(Workspace_ID:API_Key)] Content-Type: application/json
   Body	以下のサンプルペイロードを使用します。

​

Basic 認証トークンを生成する

1. オンラインの Basic Auth Header Generator tool を使用して Basic トークンを取得します。
2. Username: MoEngage の Workspace ID(MoEngage Dashboard >> Settings >> APIs で確認できます)。
3. Password: MoEngage の Data API Key(MoEngage Dashboard >> Settings >> APIs で確認できます)。
4. ツールによって Basic {base64_encoded_credentials} の値が生成されるので、これを Authorization ヘッダーに貼り付けます。

​

ステップ 4: リクエストボディのペイロードを追加する

​

サンプルペイロード

​

ケースの作成/更新(ユーザーのアップサートあり)

• Change type: Added or Modified
• Table name: Cases

{
  "customer_id": "@{triggerOutputs()?['body/_customerid_value']}",
  "updated_at": "@{triggerOutputs()?['body/createdon']}",
  "user_attributes": {
    "email": "@{outputs('Get_Customer_Details')?['body/emailaddress1']}",
    "mobile": "@{outputs('Get_Customer_Details')?['body/mobilephone']}",
    "first_name": "@{outputs('Get_Customer_Details')?['body/firstname']}",
    "last_name": "@{outputs('Get_Customer_Details')?['body/lastname']}",
    "type": "@{triggerOutputs()?['body/[email protected]']}"
  },
  "event_name": "Case Created",
  "event_attributes": {
    "case_id": "@{triggerOutputs()?['body/incidentid']}",
    "case_number": "@{triggerOutputs()?['body/ticketnumber']}",
    "title": "@{triggerOutputs()?['body/title']}",
    "description": "@{triggerOutputs()?['body/description']}",
    "case_type": "@{triggerOutputs()?['body/[email protected]']}",
    "priority": "@{triggerOutputs()?['body/[email protected]']}",
    "status": "@{triggerOutputs()?['body/[email protected]']}"
  }
}

​

ケースの作成/更新(ユーザーのアップサートなし)

• Change type: Added or Modified
• Table name: Cases

{
  "customer_id": "@{triggerOutputs()?['body/_customerid_value']}",
  "updated_at": "@{triggerOutputs()?['body/modifiedon']}",
  "event_name": "Case Created/Updated",
  "event_attributes": {
    "case_id": "@{triggerOutputs()?['body/incidentid']}",
    "case_number": "@{triggerOutputs()?['body/ticketnumber']}",
    "title": "@{triggerOutputs()?['body/title']}",
    "description": "@{triggerOutputs()?['body/description']}",
    "case_type": "@{triggerOutputs()?['body/[email protected]']}",
    "priority": "@{triggerOutputs()?['body/[email protected]']}",
    "status": "@{triggerOutputs()?['body/[email protected]']}"
  }
}

​

SLA ステータスの更新(イベント)

• Change type: Added or Modified
• Table name: SLA KPI Instances

{
  "customer_id": "@{triggerOutputs()?['body/_customerid_value']}",
  "updated_at": "@{triggerOutputs()?['body/modifiedon']}",
  "event_name": "SLA Updated",
  "event_attributes": {
    "case_id": "@{outputs('Get_Case_Details')?['body/incidentid']}",
    "first_response": "@{outputs('Get_Case_Details')?['body/_firstresponsebykpiid_value']}",
    "sla": "@{outputs('Get_Case_Details')?['body/_slaid_value']}",
    "sla_id": "@{triggerOutputs()?['body/slakpiinstanceid']}",
    "resolve_sla": "@{outputs('Get_Case_Details')?['body/resolvebyslastatus']}"
  }
}

​

アンケート回答の受信(イベント)

• Change type: Added
• Table name: Survey Responses(または msdyn_surveyresponse / Customer Voice エンティティ)

{
  "customer_id": "@{triggerOutputs()?['body/_regardingobjectid_value']}",
  "updated_at": "@{triggerOutputs()?['body/modifiedon']}",
  "event_name": "Survey Response Received",
  "event_attributes": {
    "response_id": "@{triggerOutputs()?['body/activityid']}",
    "survey_name": "@{triggerOutputs()?['body/[email protected]']}",
    "case_id": "@{triggerOutputs()?['body/_msdyn_caseid_value']}",
    "csat_score": "@{triggerOutputs()?['body/msdyn_csatscore']}",
    "feedback_comment": "@{triggerOutputs()?['body/msdyn_feedbackcomment']}"
  }
}

​

カスタムオンボーディングステータスの更新(イベント)

• Change type: Modified
• Table name: Onboardings(またはカスタムエンティティのスキーマ名)
• Select columns: cr123_statuscode(ステータスフィールドが変更されたときのみフローが実行されるため、フローの実行回数を節約できます)。

{
  "customer_id": "@{triggerOutputs()?['body/_cr123_contactid_value']}",
  "updated_at": "@{triggerOutputs()?['body/modifiedon']}",
  "event_name": "Onboarding Status Updated",
  "event_attributes": {
    "onboarding_id": "@{triggerOutputs()?['body/cr123_onboardingid']}",
    "status": "@{triggerOutputs()?['body/[email protected]']}",
    "stage_name": "@{triggerOutputs()?['body/cr123_stagename']}",
    "owner_id": "@{triggerOutputs()?['body/_ownerid_value']}"
  }
}

​

必須フィールド

​

データマッピングのガイドライン

• 一意の識別子(customer_id): D365 と MoEngage の間でユーザープロフィールをリンクするには、一貫性のある不変の識別子を使用します。これは、データのマージと重複したユーザープロフィールの防止に不可欠です。一般的なオプション:
  • メールアドレス(一意の場合)
  • D365 レコードの GUID(contactid、leadid など)
  • 外部 ID(D365 で設定されている場合)
• イベント名: 分析とセグメンテーションのために MoEngage でアクションを識別および分類できるよう、常にわかりやすい event_name を含めてください。

​

ステップ 5: 統合をテストする

1. Power Automate で Test > Manually をクリックします。
2. D365 でテストレコードを作成または変更して、トリガーを起動します(例: 新しい Case の作成、SLA の更新)。
3. フローの実行を監視します。
   • HTTP 200/201 の成功レスポンスが返されることを確認します。
   • フローの実行詳細にエラーがないか確認します。
4. MoEngage で確認します。
   • MoEngage Dashboard > Users または Events に移動します。
   • テストユーザー/イベントを検索します。
   • 1~5 分以内にデータが正しく表示されることを確認します。

​

レート制限