Sarvam - AI アウトバウンド音声通話

​

Outbound Voice Call × MoEngage

• キャンペーンイベントが発生した瞬間に、アウトバウンドの AI 音声通話をトリガーします。
• 会話を開始する言語を選択し、顧客の応答に応じてエージェントが通話中に言語を切り替えられるようにします。
• MoEngage のパーソナライゼーション属性を使用して、キャンペーンで設定したコンテキスト（顧客名、カートの金額、注文 ID、支払額、割引コード、またはエージェントに必要なその他のフィールド）を各通話とともに渡します。
• Initial Bot Message を使用して、エージェントの最初の一言をユーザーごとにパーソナライズします。
• クローズドループのジャーニーオーケストレーションのために、各通話の結果を、通話時間や会話中に取得したデータとともに Webhook で受信します。

​

ユースケース

• カート放棄のフォローアップ: カートの内容と金額に言及し、商品に関する質問に答え、割引コードを適用して、買い物客の購入完了を支援する通話をトリガーします。
• EMI と支払いのリマインダー: EMI の支払期日前や支払い失敗後に通話をトリガーし、顧客に支払額を知らせて支払い完了まで案内します。
• 更新とリテンション: サブスクリプションや保険契約の更新前に通話をトリガーし、顧客に特典をリマインドして、必要に応じてリテンション特典を提示します。
• 配達確認と注文の問題解決: 配達時間帯の確認、遅延の通知、注文に関する問題の対話的な解決を行う通話をトリガーします。
• ウィンバックのアウトリーチ: 離脱した顧客に対し、希望する言語でパーソナライズされたオファーを伝える会話型の通話をトリガーします。

​

前提条件

​

ステップ 1: Sarvam ワークスペースと音声エージェントを設定する

1. 認証情報を生成する: Sarvam ワークスペースの設定で、Organization ID と Workspace ID を控え、API キーを生成します。これら 3 つの値は、MoEngage がトリガーするすべての通話の認証に使用されます。
2. 電話通信を設定する: Sarvam のオンボーディングで、電話通信プロバイダーを接続し、顧客に表示されるアウトバウンド発信者番号を登録します。これにより、次のステップで使用する Connection ID と Agent Phone Number が生成されます。
3. エージェントを構築して公開する: 会話設計、サポートする言語、反論への対応などを含め、ユースケースに合わせた音声エージェントを作成します。会話のパーソナライズに使用するエージェント変数（例: customer_name、cart_value、discount_code、preferred_language）を定義します。公開すると App ID と App Version が生成されます。

​

各値の確認場所

​

ステップ 2: MoEngage でアプリを接続する

1. MoEngage UI の左側のナビゲーションメニューで、App Marketplace をクリックします。
2. App Marketplace ページで Sarvam を検索します。
3. Sarvam タイルをクリックします。
4. Sarvam ページで Integrate タブをクリックします。
5. + Add integration をクリックします。
6. Connection details で、次の詳細を入力します。フォームでは、これらのフィールドが Authentication と Agent & Connection Configuration にグループ化されています。

   フィールド	必須	説明
   Connection name	はい	この接続を識別するための名前（例: Sarvam Outbound call）。
   API Key	はい	Sarvam ワークスペースで生成した API キー。MoEngage はすべてのリクエストで、これを X-API-Key ヘッダーとして送信します。
   Organization ID	はい	Sarvam の組織識別子（例: 019f3b1a-9e97-…）。
   Workspace ID	はい	Sarvam のワークスペース識別子（例: 019f3b1a-9e9d-…）。
   App ID	はい	この接続がトリガーする、公開済みの Sarvam エージェントの識別子（例: CartRecover-fb7d1564-bef6）。
   App Version	はい	使用するエージェントの公開バージョン（例: 3）。
   Connection ID	はい	通話の発信に使用する Sarvam の電話通信の接続（例: Moengage-ex-156baeff-e262）。
   Agent Phone Number	はい	顧客に表示される、E.164 形式のアウトバウンド発信者番号（例: +918045695073）。

7. Test をクリックして接続を検証します。

​

ステップ 3: キャンペーンを設定する

1. MoEngage UI の左側のナビゲーションメニューで Engage をクリックし、次に Campaigns をクリックします。
2. All campaigns ページで + Create campaign をクリックします。
3. Create campaign ダイアログボックスの Connected Apps で Sarvam をクリックし、最も適した配信タイプをクリックします。
4. ステップ 1（Target users）で、オーディエンスを選択し、トリガーイベントを定義します（例: 30 分の遅延を設定した cart_abandoned、有効な携帯電話番号を持つユーザーに限定）。
5. ステップ 2（Content）で、コネクター（Make Outbound Call）と作成した接続を選択します。
6. Content で、次のフィールドを設定します。

   セクション	フィールド	必須	説明
   Call Targeting & Overrides	User Phone Number	はい	E.164 形式の顧客の携帯電話番号。@ を入力すると、ユーザー属性からパーソナライズできます（例: {{UserAttribute['Mobile Number']}}）。
   Call Targeting & Overrides	Initial Language	いいえ	エージェントが会話を開始する言語（例: English や Hindi）。顧客が別のサポート対象言語で応答した場合、エージェントは通話中に言語を切り替えることができます。
   Call Targeting & Overrides	Initial Bot Message	いいえ	エージェントの最初の一言。パーソナライゼーションをサポートします（例: Hello {{UserAttribute['First Name']}}, welcome to Digital Fortress）。このフィールドを空のままにすると、エージェントは公開済みのデフォルトの挨拶を使用します。
   Context Payload	Agent Variables	いいえ	会話のコンテキストとしてエージェントに渡されるキーと値のペア。キーは公開済みエージェントで定義された変数と一致している必要があり、値は静的な値でもパーソナライズされた値でも構いません（例: cart_value を {{UserAttribute['cart_value']}} にマッピング、または discount_code を COUP10 に設定）。行を追加するには New KV Pair をクリックします。
   Callback Configuration	Callback URL	いいえ	通話完了後に通話結果を受信する HTTPS エンドポイント。このフィールドを空のままにすると、通話は発信されますが、結果は返されません。
   Callback Configuration	Callback Details	いいえ	コールバックとともに送信され、結果のペイロードでそのまま返されるキーと値のペア。結果を MoEngage のユーザーやキャンペーンと関連付けるために使用します（例: customer_id をユーザー識別子にマッピング）。行を追加するには New KV Pair をクリックします。

   
7. ステップ 3（Schedule and Goals）で、エンゲージメントポリシーに従って、DND 時間や頻度上限などの配信制御を設定します。
8. キャンペーンを公開します。

​

ステップ 4: テストと検証

1. Sarvam アプリの Integrate タブで、作成した接続の Test をクリックします。テストが成功すると、API Key、Organization ID、Workspace ID が Sarvam ワークスペースに正しく解決されることが確認できます。
2. キャンペーンの Content ステップの Test Campaign セクションで、Email ID などの識別子タイプを選択し、自分が管理する携帯電話番号を持つテストユーザーの識別子を入力して、Test をクリックします。
3. リクエストが attempt_id とともに HTTP 200 を返すことを確認します。これは、MoEngage のリクエストが受け付けられ、電話が発信されていることを意味します。
4. 電話に出て、会話を確認します。エージェントは、設定した Initial Language で、パーソナライズされた Initial Bot Message から会話を開始し、名前、カートの金額、割引コードなどのマッピングされたエージェント変数に言及します。
5. 通話終了後、設定した Callback URL に結果が配信されたことを確認します。
6. 結果がカスタムイベントとして MoEngage に書き戻される場合は、そのイベントがテストユーザーのアクティビティタイムラインに表示され、ジャーニーの条件やコンバージョンゴールで使用できることを確認します。

​

通話結果とジャーニーオーケストレーション

​

リファレンス: Sarvam が送信する結果 Webhook

• MoEngage へ: MoEngage で結果を受信するには、MoEngage サポートに連絡して、Connected Sources を利用した専用エンドポイントを取得してください。そのエンドポイントをキャンペーンの Callback URL として入力します。
• 独自のエンドポイントへ: 自社のシステムで結果を処理するには、HTTPS エンドポイントをキャンペーンの Callback URL として入力します。

{
  "attempt_id": "att_8f3a2c…",
  "status": "connected",
  "channel_info": {
    "channel_type": "v2v",
    "channel_provider": "exotel",
    "agent_phone_number": "+918045695073"
  },
  "duration": 94,
  "interaction_id": "int_…",
  "failure_reason": null,
  "final_agent_variables": {},
  "webhook_config": {
    "url": "…",
    "metadata": {
      "customer_id": "<moengage user id>",
      "moe_campaign_id": "<campaign id>"
    }
  },
  "interaction_transcript": [
    { "role": "agent", "en_text": "…" },
    { "role": "user", "en_text": "…" }
  ]
}

​

トラブルシューティング

​

よくある質問