Customer Service 用オムニチャネルには、Dynamics 365 Customer Service Enterprise の機能を拡張する一連の機能が用意されていて、組織はデジタル メッセージング チャネルを通して顧客と即座につながり、やり取りできるようになります。 Customer Service 用オムニチャネルにアクセスする際は、追加のライセンスが必要です。 詳細については、Dynamics 365 Customer Service 価格の概要 と Dynamics 365 Customer Service 価格プラン ページを参照してください。
このメソッドは、Webリソースに実装する必要があります。 これは、新しい会話の招待が受け入れられるか、エージェント ダッシュボードから既存の会話が開かれるとすぐに、一度呼び出されます。
- 特定の条件を使用して、特定の会話の翻訳をオフまたはオンにすることを選択できます。たとえば、エージェントと顧客の言語が異なる場合に翻訳をオンにしたいとします。
- 会話の翻訳に使用するエージェントの言語を上書きすることもできます。
- 特定の決定を行うための会話に関する情報 (会話に使用する必要がある翻訳 API エンジンなど) が提供されます。
構文
function (conversationConfig): Object
パラメーター
| 名前 | 必須 | タイプ | Description |
|---|---|---|---|
conversationConfig |
イエス | JavaScript オブジェクト | 会話に関する詳細を提供します。 会話ID、デフォルトのエージェント入力言語(リアルタイム翻訳管理者構成から)など。 詳細については、次の段落を参照してください。 |
パラメータの構造 conversationConfig は次のとおりです。
interface InviteParams {// Parameters received on a conversation invite
inviteLocale: string; //Language locale of the channel from where conversation is received. This contains locale ID, example- "1033" for english.
channelType: string; //The type of the channel, example- "lcw" for chat widget, "facebook" for facebook.
}
interface conversationConfig {
conversationId: string, // Unique Id for conversation in Omnichannel for Customer Service
c1Language: string; // Default agent input language (From Real time translation administrator configuration)
inviteParams: InviteParams; // Implements InviteParams interface, Represents the parameters received on a conversation invite
}
インターフェイスの inviteLocale パラメータ InviteParams ロケール ID を表します。 詳細: ロケール ID。
インターフェイスの channelType パラメーターは InviteParams Customer Service 用オムニチャネルでサポートされているチャネルを表します。 チャンネルは以下の通りです。
| 名前 | Description |
|---|---|
"lcw" |
ライブチャットウィジェットチャンネルの場合 |
"sms" |
SMSチャネルの場合 |
"facebook" |
Facebookチャンネルの場合 |
"twitter" |
Twitterチャンネルの場合 |
"custom" |
カスタムメイドチャンネルの場合 |
"wechat" |
WeChatチャンネルの場合 |
"whatsapp" |
WhatsAppチャンネルの場合 |
"msteams" |
Microsoft Teams チャネルの場合 |
"line" |
ラインチャネルの場合 |
"phonecall" |
通話チャネルの場合 |
conversationConfig パラメータの例は次のとおりです。
conversationConfig = {
"conversationId": "2f67af9e-c05a-4784-aaea-916d6938fcea",
"c1Language": "1033",
"inviteParams": {
"inviteLocale": "3082",
"channelType": "lcw"
}
}
戻り値
次の JavaScript オブジェクトに解決される Promise を返します。
{
keepTranslationOn: boolean;// mandatory field, if true the translation would be turned on for the conversation and vice-versa
c1Language?: string;// optional field, return the agent's language if input param conversationConfig.c1Language needs to be overriden for the conversation
}
解決された JavaScript オブジェクトの c1Language パラメーターは、次のリストのロケール ID のみを表します。
| ロケール ID | Language |
|---|---|
"1033" |
英語 |
"1025" |
アラビア語 |
"1069" |
バスク語 |
"1027" |
カタルニア語 |
"1026" |
ブルガリア語 |
"1050" |
クロアチア語 |
"1029" |
チェコ語 |
"1030" |
デンマーク語 |
"1043" |
オランダ語 |
"1061" |
エストニア語 |
"1035" |
フィンランド語 |
"1036" |
フランス語 |
"1110" |
ガリシア語 |
"1031" |
ドイツ語 |
"1032" |
ギリシャ語 |
"1037" |
ヘブライ語 |
"1081" |
ヒンディー語 |
"1038" |
ハンガリー語 |
"1040" |
イタリア語 |
"1057" |
インドネシア語 |
"1041" |
日本語 |
"1087" |
カザフ語 |
"1042" |
韓国語 |
"1062" |
ラトビア語 |
"1063" |
リトアニア語 |
"1086" |
マレー語 |
"1044" |
ノルウェー語ブークモール |
"1045" |
ポーランド語 |
"1046" |
ポルトガル語 - ブラジル |
"2070" |
ポルトガル語 - ポルトガル |
"1048" |
ルーマニア語 |
"1049" |
ロシア語 |
"3098" |
セルビア語 (キリル) |
"2074" |
セルビア語 (ラテン) |
"1051" |
スロバキア語 |
"1060" |
スロベニア語 |
"3082" |
スペイン語 |
"1053" |
スウェーデン語 |
"1054" |
タイ語 |
"1055" |
トルコ語 |
"1058" |
ウクライナ語 |
"1066" |
ベトナム語 |
"2052" |
中国語 - 中国 |
"3076" |
中国語 - 香港特別行政区 |
予想される応答の例
{
"keepTranslationOn": true,
"c1Language": "1033"
}
追加情報
このメソッドの例外または無効な戻り値の場合、Customer Service 用オムニチャネルは会話の翻訳をオフにします。 たとえば、返された Promise から解決された JavaScript オブジェクトに
keepTranslationOnフィールドが含まれていない場合、またはフィールドc1Languageロケール ID のリストからない値が含まれている場合、会話は翻訳をオフにした状態で開始されます。この関数には、レンダリング前に UI を待機させるため、最小限の処理を含めることを検討してください。 この関数の実行時間が 30 秒を超えると、返される Promise の値に関係なく、会話は翻訳がオフになった状態で開始されます。
この方法が実装されていない場合、エージェントに次のエラーが表示されます。
